Design Tokens

The init command adds design tokens to your CSS file. After initialization, you own them — customize freely. Values shown are Porcelain (default). See Themes for other presets.

Neutral

TokenValueUsage
--graphiteDeepest tone
--inkPrimary text
--branchBrand surfaces
--ironDark borders
--slateDark secondary
--zincDark muted
--steelSecondary text
--mutedMuted text
--aluminumDecorative, shadows
--chromePrimary border
--silverLight border
--platinumLight background
--frostHover, inputs
--paperPrimary background

Use as Tailwind utilities: bg-paper, text-ink, border-chrome, etc.

Signal Colors

TokenValueUsage
--signal-blueLinks, info
--signal-redError, destructive
--signal-greenSuccess
--signal-amberWarning
--signal-purpleAccent
--signal-cyanInfo alternate

Each has hover and active variants (e.g., --signal-red-hover). Use as bg-signal-red, text-signal-blue, etc.

Surface Layers

TokenValueUsage
--surface-0Page background
--surface-1Cards, panels
--surface-2Nested, elevated

Shadows

TokenValueUsage
--shadow-offset1px 1px 0px 0px #c0c4caDefault interactive
--shadow-offset-hover2px 2px 0px 0px #c0c4caHover
--shadow-offset-active0px 0px 0px 0px #c0c4caActive/pressed
--shadow-offset-dark1px 1px 0px 0px #a0a3a7Overlays

Use as shadow-offset, hover:shadow-offset-hover, active:shadow-offset-active. Size and color vary by theme.

Customization

After init, these tokens are yours. The library will not update them automatically. Check the Changelog when updating.