Skip to content
Tetrifox

Foundations · Colour

Colour.

Disciplined raw material becomes meaning through semantic tokens. Dark-first, accessible, and precise enough that orange signals without becoming the field.

01

Source

--color-brand-400

#ff9163

02

Meaning

--text-accent

Signal

03

Use

Action · focus · label

Signal, not surface

04

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. :root is the canonical dark field; .light is 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.

50
#fff7f3
100
#ffe8de
200
#ffd1bd
300
#ffb396
400
#ff9163
500
#f97316Identity
600
#ea580cAccent
700
#c94a0a
800
#a63c09
900
#823008
950
#4b1b04

--color-cyan-*

Cyan

Secondary / signal. Used sparingly.

50
#f0fcff
100
#ccf0fe
200
#99e3fc
300
#5fd6f9
400
#2bc4f0Motion bloom
500
#10add9
600
#0891b2
700
#076e8a
800
#05556a
900
#043d4d
950
#021f28

--color-gray-*

Gray

Neutrals — text, surfaces, borders.

50
#f5f7fa
100
#e4e7eb
200
#cbd2d9
300
#9aa5b1
400
#7b8794
500
#616e7c
600
#52606d
700
#3e4c59
800
#323f4b
900
#1f2933
950
#12181f

--color-green-*

Green

Positive / brand green, used sparingly. Success states use the fixed --color-success, not this ramp.

50
#ecfdf5
100
#d1fae5
200
#a7f3d0
300
#6ee7b7
400
#34d399
500
#20b070Positive
600
#10a25e
700
#0e8b50
800
#0b7045
900
#085c3b
950
#022c22

Error

--color-error · #dc2626

Success

--color-success · #16a34a

Warning

--color-warning · #d97706

The 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.

ExtensionInteractive teaching instrument

Choose a role

01 Source

Direct value#0a0d12

02 Meaning

--backgroundField

03 Use

Page background

04 Dark output

#0a0d12
Light proof#ffffff

Product engineering

Idea to production, fast.

Consultancy, leadership and engineering.

--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.

ExtensionInteractive proof of the rule

Product engineering

Idea to production, fast.

One accountable team — consultancy, leadership and engineering.

Talk to a founder
orange as an accent — eyebrow, one button, nothing else

Signal lineage

--color-brand-400 → --text-accentlight: --color-brand-800

Actions · focus · labels · selection

--color-cyan-400 → --field-bloom

The 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.

ExtensionLive checker using the running theme tokens

We assemble one accountable team — consultancy, leadership and engineering — so scaling companies ship.

18.13: 1AA passAAA pass
ink
ground

--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.

Incorrect

The accent becomes the environment and body contrast collapses.

Correct

Product engineering

Idea to production, fast.

Talk to a founder

The field stays neutral; orange marks one deliberate action.

02 / 03

Meaning, not a literal.

Incorrect
.panel {background: #1f2933;}

A raw value cannot follow the active theme or communicate intent.

Correct
.panel {background: var(--surface);}

The semantic alias keeps the component tied to its role.

03 / 03

Readable, not merely branded.

Incorrect

Brand orange as body copy on white reaches AA-large at best.

Correct

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.