Foundations · 01
Colour roles
Neutrals carry the interface. Iris is the only colour, and it only marks something you can click, focus or select (R14). Greys lean toward the background — never pure black (R15).
--bglight: #FAFAFAdark: #0D0D0FPage canvas
--surfacelight: #FFFFFFdark: #151518Cards, panels, inputs
--surface-2light: #F2F2F3dark: #1D1D21Sunken wells, hovers, table heads
--inklight: #111113dark: #EDEDEFHeadings, primary text
--ink-2light: #38383Edark: #C6C6CCBody copy on surfaces
--mutedlight: #66666Edark: #90909AHelper text, metadata
--linelight: #E4E4E7dark: #27272CDividers, card edges
--line-stronglight: #8A8A92dark: #6A6A73Input borders (3:1 non-text)
--primarylight: #111113dark: #EDEDEFThe one filled button per screen
--primary-inklight: #FAFAFAdark: #0D0D0FLabel on primary
--accentlight: #5862CFdark: #8C95F2Links, selection, focus — touchable only
--accent-inklight: #FFFFFFdark: #0D0D0FLabel on accent fills
--dangerlight: #C42B2Bdark: #FF7B7BErrors, destructive actions
--danger-inklight: #FFFFFFdark: #0D0D0FLabel on danger fills
--danger-softlight: #FCEDEDdark: #2B1616Error wash
--oklight: #17734Bdark: #5BD08FSaved, active, done
--ok-softlight: #E8F5EEdark: #10261ASuccess wash
--warnlight: #8A5000dark: #F0B455Pending, heads-up
--warn-softlight: #FCF1E1dark: #2A1F0EWarning wash
--infolight: #434DA6dark: #A3ABF6Neutral news, “new”
--info-softlight: #EEF0FBdark: #1C1E36Info wash
--focuslight: #5862CFdark: #8C95F2Keyboard focus outline
--scrimlight: rgba(17,17,19,.36)dark: rgba(4,4,8,.62)Behind modals and sheets
Contrast, both themes
Measured live from the tokens.
| Pair | Light | Dark |
|---|---|---|
Headings on page--ink / --bg | 18.07:1AAA | 16.61:1AAA |
Body on card--ink-2 / --surface | 11.64:1AAA | 10.72:1AAA |
Helper text on page--muted / --bg | 5.45:1AA | 6.14:1AA |
Metadata on raised--muted / --surface-2 | 5.09:1AA | 5.31:1AA |
Primary button label--primary-ink / --primary | 18.07:1AAA | 16.61:1AAA |
Link on card--accent / --surface | 5.17:1AA | 6.68:1AA |
Label on accent fill--accent-ink / --accent | 5.17:1AA | 7.12:1AAA |
Error message--danger / --surface | 5.63:1AA | 7.26:1AAA |
Success pill--ok / --ok-soft | 5.22:1AA | 8.27:1AAA |
Warning pill--warn / --warn-soft | 5.83:1AA | 8.74:1AAA |
Input border--line-strong / --surface | 3.43:13:1 UI | 3.40:13:1 UI |
Focus ring--focus / --bg | 4.95:13:1 UI | 7.12:13:1 UI |
Text needs 4.5:1, large text and UI edges 3:1 (WCAG 2.2). The current theme’s column is shaded.
Contrast lab
Pick any two roles; switch theme to see the dark pairing.
—
Quiet design speaks loudest.