Foundations · Colour
Colour.
Disciplined raw material becomes meaning through semantic tokens. Dark-first, accessible, and precise enough that orange signals without becoming the field.
Source
--color-brand-400
#ff9163
Meaning
--text-accent
Signal
Use
Action · focus · label
Signal, not surface
Outcome
8.79:1
AAA on the dark field
The field
Depth before colour.
Five semantic values build the whole field: a ground, two layers, an ink and one accent.
Field construction
- --background
- Page background
- --foreground
- Primary text
- --surface
- Cards, raised panels
- --surface-alt
- Secondary surfaces / hover
- --text-accent
- Accent text — labels, links, focus
The rules
- Must
Design dark-first.
:rootis the canonical dark field;.lightis an opt-in inverse applied as a class on<html>.--background--foreground - Prefer
Separate layers with semantic surfaces and borders before reaching for another hue.
--surface--surface-alt--borderExtension
The raw material
Ramps.
Four complete 50–950 scales and three fixed status colours. The square markers identify the documented anchors.
--color-brand-*
Brand
Primary identity — orange. Actions, accents, focus.
--color-cyan-*
Cyan
Secondary / signal. Used sparingly.
--color-gray-*
Gray
Neutrals — text, surfaces, borders.
--color-green-*
Green
Positive / brand green, used sparingly. Success states use the fixed --color-success, not this ramp.
Error
--color-error · #dc2626Success
--color-success · #16a34aWarning
--color-warning · #d97706The rules
- Must
Reach for a semantic token first. Use a raw ramp step only when no semantic role fits.
- Must not
Hardcode hex values in components, or introduce colours outside the four ramps and the fixed status colours.
- Must
Use the fixed, theme-independent status colours for error, success and warning. The green ramp is brand-positive, not a status colour.
--color-error--color-success--color-warning - Prefer
Use cyan sparingly, as a secondary signal. Its documented anchor is the motion bloom of the pattern background.
--color-cyan-400--field-bloom
The meaning layer
Token refinery.
Follow a value from its source, through a semantic role, into a rendered interface.
Choose a role
01 Source
Direct value#0a0d1202 Meaning
--backgroundField03 Use
Page background
04 Dark output
#0a0d12#ffffffProduct engineering
Idea to production, fast.
--background selected. Source Direct value. Used for Page background. Dark value #0a0d12; light value #ffffff.
The rules
- Must
Bind every interface colour to a semantic role — field, ink, layer, divider, state or signal — so it follows the active theme.
--background--foreground--surface--border--muted--text-accent - Prefer
In Tailwind, use the aliased utilities —
bg-background,bg-surface,text-primary,text-secondary,text-tertiary,text-accent,border-border— rather than ramp utilities.--color-primary--color-secondary--color-tertiary--color-accent
One accent
Accent restraint.
One colour is allowed to signal. Flip the specimen to see what flooding the field costs.
Product engineering
Idea to production, fast.
One accountable team — consultancy, leadership and engineering.
Talk to a founderSignal lineage
--color-brand-400 → --text-accentlight: --color-brand-800Actions · focus · labels · selection
--color-cyan-400 → --field-bloomThe PatternBackground motion signature only.
- --field-dot
- Resting dot
- --field-glow
- Mid-intensity glow
- --field-bloom
- Peak bloom (cyan)
The rules
- Must
Reserve orange for actions, focus, labels (the eyebrow) and text selection.
--text-accent--color-brand-600--color-brand-500 - Must not
Use brand orange as a field, a large fill, or body copy.
--color-brand-600 - Must
Show one primary (orange) button per view; use secondary or link buttons for every other action.
--color-brand-700 - Prefer
Judge accent restraint by role — one action, labels, focus — not by a coverage percentage. The book sets no numeric budget for orange.
Extension
The numbers
Contrast (AA).
Every colour decision has a measurable consequence.
We assemble one accountable team — consultancy, leadership and engineering — so scaling companies ship.
--foreground on --background
Canonical pairings.
Ratios are computed from the shipped token values in colors.css. Text carries every verdict; colour only reinforces it.
- --foreground on --background
- Body & headings on the dark field18.13:1 · AAA
- --muted-foreground on --background
- Secondary text12.75:1 · AAA
- --muted on --background
- Muted UI8.34:1 · AAA
- --text-accent on --background
- Accent on the dark field8.79:1 · AAA
- --text-accent on --background (light)
- Accent on white6.42:1 · AA
The rules
- Must
Text must clear WCAG AA against its ground: 4.5:1 for body text, 3:1 for large text (24px and up, or 18.66px bold).
--foreground--muted-foreground--background - Must
Verify contrast in both themes. Each theme carries its own accent step, so a verdict in dark says nothing about light.
--text-accent
Guardrails
See the consequence.
Three failures, each resolved by returning to meaning, contrast and restraint.
01 / 03
Signal, not surface.
The accent becomes the environment and body contrast collapses.
Product engineering
Idea to production, fast.
Talk to a founderThe field stays neutral; orange marks one deliberate action.
02 / 03
Meaning, not a literal.
.panel {background: #1f2933;}A raw value cannot follow the active theme or communicate intent.
.panel {background: var(--surface);}The semantic alias keeps the component tied to its role.
03 / 03
Readable, not merely branded.
Brand orange as body copy on white reaches AA-large at best.
Product engineering
One accountable team, assembled to move from idea to production.
Foreground carries prose; accent remains a short label.
The rules
- Prefer
Keep accent text to short labels and links. Prose stays on the foreground and secondary inks.
--text-accent--foreground--muted-foregroundExtension
The operating model
Use semantic tokens first. Reach for ramps deliberately. Keep orange precise.