Skip to main content
jax
home install tokens components htmx guide case study grounding changelog roadmap
Getting Started
Home Installation Design Tokens HTMX Guide case study grounding changelog roadmap
Components
Button Card Media Card Badge Form Alert Dialog Table Navbar Tabs Accordion Toast Dropdown Spinner Skeleton Toggle Tooltip File Input Tag Segmented Drawer Stat Card Gauge Sparkline Radio Group Data Table Feed & Hero Prose
Layout
Container Grid Stack

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.