Everything on this page is generated from machine-readable files. Agents and tooling build from these — humans, this is where your automation plugs in:
| File | Purpose | Preview |
|---|---|---|
tokens/tokens.json | The canonical source: primitives, semantic roles, both modes, with {token.ref} lineage. Everything else is generated from it. | |
web/theme.css | Generated adapter exposing every token as --ds-* custom properties. Never hand-edit; re-export from tokens.json. | |
web/tailwind-theme.css | Same tokens, mapped into Tailwind v4 @theme namespaces for utility-class consumption. | |
brand/brand.json | Brand asset slots: stable file paths for mark, wordmark, lockup, and favicon, with color behavior and usage rules. Rebrand by replacing file contents at the slot paths. | |
components/component-contracts.json | The component API: anatomy, axes with their class modifiers, per-state token bindings, DOM state drivers, and usage rules. The validator diffs it against components.css. | |
AGENTS.md | Rules of engagement: consume semantic roles, never primitives; extend, don't regenerate; validate before committing. | — |
DESIGN.md | The brand brief. Template content means the monochrome default; fill it in and re-derive to rebrand. | — |