Introduction
Build with two colors.
Choose ink and paper. 1bitcn derives the ramp, surfaces, focus, and interaction states from that pair.
Get started
Installation
Give your coding agent the setup prompt. It adds the registry, the base theme, and the 1bitcn rules. Then add components from their pages.
Paste this prompt into your coding agent. It installs through the registry and adds the 1bitcn rules to AGENTS.md.
Set up 1bitcn (@1bitcn/base) in this project.
1bitcn is a shadcn registry of 1-bit React components. Every theme has exactly two paints: ink and paper.
1. If the project has no components.json, run `npx shadcn@latest init` first.
2. Add the registry: `npx shadcn@latest registry add @1bitcn=https://1bitcn.com/r/{name}.json`
3. Install: `npx shadcn@latest add @1bitcn/base`. If the project uses another package runner (pnpm dlx, yarn dlx, bunx), you may use it instead. Do not copy files by hand.
4. Add this note to AGENTS.md (create the file if needed; skip if it is already there):
## 1bitcn
- UI comes from the 1bitcn shadcn registry (@1bitcn). Catalog: https://1bitcn.com/llms.txt. Full rules: .agents/skills/1bitcn/SKILL.md
- Each theme has two paints, ink and paper. Middle tones come from the monochrome ramp tokens (--bit-ink-soft, --bit-mid, --bit-paper-deep, --bit-scrim). Add no other colors.
- Show state with shape, border, pattern or label, not hue. Add items with `shadcn add @1bitcn/<name>`, not by hand.
5. Check: the project typechecks and builds, and globals.css imports the 1bitcn CSS files.
Docs: https://1bitcn.com/docs/components/base.mdOptional: let your agent browse the registry with npx shadcn@latest mcp init.
Color model
Author two. Derive the rest.
Ink and paper are the only authored paints. Every middle tone is a mix along that same axis.
Build
Choose your layer.
Reference
Motion stays with the component.
CSS is the default. Pick another adapter here and component examples replay with that engine. Reduced motion always wins.
Motion engine
Loading motion options…
- 90ms
- Feedback
- 160ms
- State
- 240ms
- Continuity
Reference
Registry compatibility
1bitcn follows the shadcn registry workflow: install only what you need, keep the source in your app, and edit it there. The two-color contract lives in the shared base item.