Skip to content

b-open-io/theme-token

Repository files navigation

Theme Token

On-chain themes for ShadCN UI.

Inscribe UI themes on Bitcoin. Install them with one command.

bunx shadcn@latest add https://themetoken.dev/r/themes/[origin]

How It Works

  1. Create a theme using tweakcn or any CSS editor
  2. Inscribe it on Bitcoin via themetoken.dev
  3. Install in any ShadCN project using the standard CLI

The registry API transforms on-chain data into the format ShadCN CLI expects.


For Designers

Benefit Description
Ownership Themes are inscribed as Bitcoin NFTs with cryptographic authorship
Monetization List and sell on any ordinals marketplace
Permanence On-chain forever, no hosting required

For Developers

Benefit Description
Familiar workflow Standard ShadCN CLI, nothing new to learn
Full compatibility Works with existing ShadCN UI setup
Runtime theming Apply themes dynamically with @theme-token/sdk

Studio Deep Links

Import themes programmatically into the studio:

https://themetoken.dev/studio?import=<base64-css>&name=<name>&source=<source>
Parameter Description
import Base64-encoded CSS (required)
name Theme name (optional)
source Attribution, e.g. "tweakcn" (optional)

CLI

Install any published theme into your shadcn project with the standard CLI — no extra tooling:

bunx shadcn@latest add https://themetoken.dev/r/themes/<origin>

Blocks and components publish the same way:

bunx shadcn@latest add https://themetoken.dev/r/blocks/<origin>
bunx shadcn@latest add https://themetoken.dev/r/components/<origin>

Local CLI (this repo)

A helper CLI lives in cli/index.ts (run via Bun — it is not published to npm):

bun run cli add <origin>    # resolve + verify a theme by origin
bun run cli url <origin>    # print the registry URL for an origin

SDK

For building apps that integrate Theme Token:

bun add @theme-token/sdk

Documentation: @theme-token/sdk


Development

bun install
bun run dev

Runs at http://localhost:3033


Links


License

MIT

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages