Design Tokens
Everything that is not a colour is defined in
tokens.css; the colours come from whichever
schemes/<name>.css is loaded. Never use raw hex —
always var(--token).
Colors
Live values for the current scheme and theme. Switch either in the
navbar to see how the tokens adapt — a scheme carries both modes in
one light-dark() declaration, so the two are
independent. These token names are the colour contract: any file in
schemes/ must define all of them, and
jax-contrast-check gates every one of them against the
same AA targets in both modes.
| Token | Preview | Value | Usage |
|---|---|---|---|
--bg-primary |
Page background | ||
--bg-secondary |
Cards, panels | ||
--bg-tertiary |
Hovers, nested | ||
--text-primary |
Body text | ||
--text-secondary |
Labels | ||
--text-muted |
Metadata | ||
--border-color |
Borders | ||
--accent |
Links, active states | ||
--text-accent |
Accessible accent text | ||
--color-ok |
Success | ||
--text-ok |
Accessible success text | ||
--color-warn |
Warning | ||
--text-warn |
Accessible warning text | ||
--color-error |
Error | ||
--text-error |
Accessible error text | ||
--color-info |
Info | ||
--text-info |
Accessible info text |
Typography
| Token | Value | Usage |
|---|---|---|
--font-mono |
JetBrains Mono, Fira Code, SF Mono, Consolas, ... | Everything |
--font-size-xl |
24px | h1, page titles |
--font-size-lg |
18px | h2, section headers |
--font-size-base |
14px | Body, forms, nav |
--font-size-sm |
12px | Labels, badges, meta |
--font-size-xs |
11px | Smallest text |
Spacing (4px base)
--space-1
4px
--space-2
8px
--space-3
12px
--space-4
16px
--space-5
20px
--space-6
24px
--space-8
32px
--space-10
40px
--space-12
48px
--space-16
64px
Border Radius (Strict)
| Token | Value | Usage |
|---|---|---|
--radius-none |
0 | Default: cards, buttons, inputs |
--radius-sm |
2px | Subtle softening |
--radius-pill |
12px | Pill-shaped tags ONLY |
--radius-full |
50% | Circles ONLY |
Rule
No other radius values. Never use 4px, 6px, 8px.