Tokens
- 125primitives
- 88semantic
- 54@theme (Tailwind)
- 9role groups
Every color token in tokens/tokens.json, by layer. Components read semantic tokens only; ramp steps are for illustration and data viz. Semantic cards show light and dark at once, so you never have to flip the theme to compare.
Layer 1 · Primitives (125)
The raw palette in 7 ramps. Every status ramp has 12 steps anchored at 500 and keeps its hue in dark.
Neutral · 29 steps
01020304050607080901001502002503003504004505005506006507007508008509009501000
Teal · primary · 29 steps
01020304050607080901001502002503003504004505005506006507007508008509009501000
Bronze · accent · 19 steps
0481216204060801002003004005006007008009001000
Error · 12 steps
10501002003004005006007008009001000
Warning · 12 steps
10501002003004005006007008009001000
Success · 12 steps
10501002003004005006007008009001000
Info · 12 steps
10501002003004005006007008009001000
Layer 2 · Semantic (88)
Roles that point at primitives. This is what components read. Grouped by role; each card names the primitive it points at in light and, where different, in dark.
Surfaces · 10
Grounds, from the page up. Dark elevates by lightening the surface, not with shadow.
LightDark
surface-page
bronze-0 (#fefbf8) · dark neutral-1000 (#0d1113)
Page background behind everything. Light is the default theme. Elevation level 0 ground. Light is bronze-0 (Marcel, 2026-11-11; was teal-10).
LightDark
surface-0
neutral-0 (#ffffff) · dark neutral-950 (#191d1f)
Resting surfaces: flat cards, sections, table bodies (elevation 0).
LightDark
surface-1
neutral-0 (#ffffff) · dark neutral-900 (#25292b)
Raised: hovered or focused cards (elevation 1). In dark it lightens instead of casting a shadow.
LightDark
surface-2
neutral-0 (#ffffff) · dark neutral-850 (#313536)
Overlay: dropdowns, popovers, tooltips (elevation 2).
LightDark
surface-3
neutral-0 (#ffffff) · dark neutral-800 (#3d4142)
Modal: dialogs and sheets (elevation 3).
LightDark
surface-subtle
bronze-20 (#f9f2e4) · dark neutral-900 (#25292b)
Table headers, read-only fields, sunken wells, muted rows and icon tiles. Light bronze-20 (Marcel, 2026-11-11: neutral-40 read blue on the bronze-0 page).
LightDark
surface-field
#fbf9f6 · dark neutral-950 (#191d1f)
Text field ground (inputs, selects, textareas). Light: bronze-8 (#fdf9f1) desaturated twice by 40% in OKLCH, same lightness (Marcel, 2026-11-11): #fbf9f6, chroma 0.0114 -> 0.0045. Dark keeps neutral-950: the dark page is already the darkest step.
LightDark
surface-data
#fffdfb · dark neutral-950 (#191d1f)
Tables and lists (Marcel, 2026-11-11): one step lighter than the page. Light: OKLCH midpoint of white and bronze-0 (L 0.9948, C 0.0026, hue 67.8): #fffdfb, warmer than stark white. Dark keeps neutral-950, as surface-0.
LightDark
surface-sidebar
teal-20 (#f8fbfa) · dark neutral-900 (#25292b)
The Evantis app sidebar (Marcel, 2026-11-11): a faint teal panel on the bronze-0 page. Light teal-20 #f8fbfa; dark neutral-900, the same value as surface-subtle.
LightDark
scrim
teal-1000 (#062d25)
Backdrop behind modals and dialogs: dark teal (Marcel, 2026-11-11). Applied at 50% for alert dialogs; the DS Modal uses 48% (light) / 72% (dark).
Text · 4
text-primary everywhere; text-secondary for metadata; text-disabled only for disabled controls.
LightDark
text-primary
neutral-1000 (#0d1113) · dark neutral-30 (#f8f8f8)
Body and headings on every surface token and surface-subtle, both themes (12:1 or better).
LightDark
text-secondary
neutral-650 (#626466) · dark neutral-350 (#aaacac)
Metadata, hints, column headers. 4.5:1 or better on every surface token, both themes.
LightDark
text-disabled
neutral-450 (#929495) · dark neutral-600 (#6e7071)
Disabled labels only (exempt from contrast minimums; never for information).
LightDark
text-inverse
neutral-0 (#ffffff) · dark neutral-1000 (#0d1113)
Text on text-primary fills (tooltips).
Borders and focus · 4
border-strong for anything a person operates (3:1 or better); border-subtle for hairlines only.
LightDark
border-subtle
neutral-70 (#eeeeee) · dark neutral-800 (#3d4142)
Hairlines and dividers. Decorative only: never the sole boundary of a control.
LightDark
border-strong
neutral-500 (#868889) · dark neutral-400 (#9ea0a1)
Input, checkbox and chip borders: 3:1 or better on every surface token, both themes.
LightDark
border-field
#eceae7 · dark bronze-400 (#b0986e)
Text field outline, 2px (Marcel, 2026-11-11). Light: bronze-60's lightness with surface-field's chroma (OKLCH, hue 78): #eceae7, 1.14:1 on surface-field, far below the 3:1 WCAG asks for control outlines (Marcel's call, numbers shown). Dark bronze-400, 6.11:1. Error fields switch to error.
LightDark
focus-ring
teal-700 (#0f6e56) · dark teal-300 (#98c1b7)
Keyboard focus: 2px solid outline, 2px offset. 3:1 or better on every surface token, both themes.
Brand · 13
Teal is primary, bronze is accent and links; sidebar links are teal. Neither ever appears in or near a status message.
LightDark
sidebar-link
teal-850 (#0a4e3e) · dark teal-200 (#bad6cf)
Links and icons in the Evantis app sidebar (Marcel, 2026-11-11): teal-850 #0a4e3e on the teal-20 ground.
LightDark
sidebar-link-hover
teal-650 (#207862) · dark teal-300 (#98c1b7)
Sidebar links and icons on hover (Marcel, 2026-11-11): teal-650 #207862.
LightDark
primary
teal-700 (#0f6e56) · dark teal-300 (#98c1b7)
Primary actions, links, selected state indicators; as text, on every surface token. Never for status: it is not success.
LightDark
primary-hover
teal-800 (#0c5846) · dark teal-200 (#bad6cf)
Primary fill on hover.
LightDark
primary-pressed
teal-900 (#094335) · dark teal-150 (#cce0db)
Primary fill while pressed.
LightDark
on-primary
neutral-0 (#ffffff) · dark neutral-1000 (#0d1113)
Label on primary, primary-hover and primary-pressed fills, both themes.
LightDark
primary-subtle
teal-50 (#eef5f3) · dark teal-950 (#08382d)
Selected rows and selected chips.
LightDark
primary-text-on-subtle
teal-800 (#0c5846) · dark teal-200 (#bad6cf)
Text on primary-subtle: 7.6:1 light, 8.4:1 dark.
LightDark
accent
bronze-500 (#8b7040) · dark bronze-400 (#b0986e)
Bronze marks: rules, small shapes, illustration. Scarce: one brand moment per view. Never a fill behind status, never next to a warning, never on a control.
LightDark
accent-text
bronze-600 (#785f33) · dark bronze-300 (#c4b08d)
Bronze as text (eyebrows): 4.5:1 or better on every surface token. bronze-500 is 4.48:1 on surface-page, so text steps down to 600.
LightDark
accent-subtle
bronze-40 (#f5edde) · dark bronze-1000 (#2b1c01)
Caregiver onboarding grounds only. Never a banner or badge ground (reads as warning).
LightDark
link-text
bronze-600 (#785f33) · dark bronze-300 (#c4b08d)
Standalone clickable text: accordion questions, card titles that link. Bronze, never underlined (Marcel, 2026-11-11).
LightDark
link-text-hover
bronze-700 (#624c24) · dark bronze-200 (#d8c9ad)
Hover for link-text: one step darker (lighter in dark). The only hover cue, since links carry no underline.
Status · 20
Safety out-ranks brand. Status is never colour alone: every status carries its glyph and a word.
LightDark
error
error-500 (#c0392b) · dark error-300 (#fa9c8b)
Error icons and borders on any surface token, both themes. Always paired with an icon and a word.
LightDark
error-fill
error-500 (#c0392b)
Solid error fill (critical banners, danger buttons), both themes.
LightDark
error-subtle
error-100 (#ffe0d9) · dark error-900 (#560603)
Error banner and badge ground.
LightDark
error-text
error-800 (#6c1008) · dark error-200 (#ffc2b5)
Error text on error-subtle and on any surface token, both themes.
LightDark
on-error
neutral-0 (#ffffff)
Text on error-fill: 5.44:1.
LightDark
warning
warning-600 (#a57702) · dark warning-500 (#d69d01)
Warning icons and borders on any surface token, both themes. Always paired with an icon and a word.
LightDark
warning-fill
warning-500 (#d69d01)
Solid warning fill, both themes. Text on it is on-warning.
LightDark
warning-subtle
warning-100 (#ffeac5) · dark warning-900 (#483001)
Warning banner and badge ground.
LightDark
warning-text
warning-800 (#634400) · dark warning-300 (#f0c77a)
Warning text on warning-subtle and on any surface token, both themes.
LightDark
on-warning
neutral-1000 (#0d1113)
Text on warning-fill: dark on amber, 7.85:1. White on warning-500 is 2.42:1 and fails.
LightDark
success
success-500 (#208922) · dark success-300 (#8ece8a)
Success icons and borders on any surface token, both themes. Dark uses success-300, which keeps the green. Always paired with an icon and a word.
LightDark
success-fill
success-500 (#208922)
Solid success fill, both themes.
LightDark
success-subtle
success-100 (#d4f4d2) · dark success-900 (#003502)
Success banner and badge ground.
LightDark
success-text
success-800 (#004703) · dark success-200 (#b3e4b0)
Success text on success-subtle and on any surface token, both themes.
LightDark
on-success
neutral-0 (#ffffff)
Text on success-fill: 4.5:1.
LightDark
info
info-500 (#215398) · dark info-300 (#92b6ea)
Info icons and borders on any surface token, both themes. Always paired with an icon and a word.
LightDark
info-fill
info-500 (#215398)
Solid info fill, both themes.
LightDark
info-subtle
info-100 (#dae9fe) · dark info-900 (#011d46)
Info banner and badge ground.
LightDark
info-text
info-700 (#0c356b) · dark info-200 (#b7d3fb)
Info text on info-subtle and on any surface token, both themes.
LightDark
on-info
neutral-0 (#ffffff)
Text on info-fill: 7.62:1.
Badges · 5
A barely-there ground so a badge never looks pressable.
LightDark
badge-neutral-bg
neutral-50 (#f3f3f3) · dark neutral-950 (#191d1f)
Neutral badge ground: barely there, no border.
LightDark
badge-error-bg
error-50 (#fff0ec) · dark error-1000 (#400000)
Error badge ground: barely there, no border. Text is error-text (8:1 or better in light).
LightDark
badge-warning-bg
warning-50 (#fff4e0) · dark warning-1000 (#301e00)
Warning badge ground: barely there, no border. Text is warning-text (8:1 or better in light).
LightDark
badge-success-bg
success-50 (#e5fbe3) · dark success-1000 (#002401)
Success badge ground: barely there, no border. Text is success-text (8:1 or better in light).
LightDark
badge-info-bg
info-50 (#edf4fe) · dark info-1000 (#001334)
Info badge ground: barely there, no border. Text is info-text (8:1 or better in light).
AI · 3
The Evantis Ask field's soft glow while it works (focus, listening, thinking). Decorative, blurred, never a status and never text.
LightDark
ai-glow-1
teal-400 (#76ac9e)
The Evantis Ask field's soft glow while it works (focus, listening, thinking; Marcel, 2026-11-15: teal, gold, bronze, not blue and pink): teal, first of three. Decorative only, blurred behind the field; never a status, never text.
LightDark
ai-glow-2
warning-300 (#f0c77a)
Ask field glow, gold (the warning ramp's gold, used here as colour only, never as a status). Decorative only.
LightDark
ai-glow-3
bronze-400 (#b0986e)
Ask field glow, bronze, third of three. Decorative only.
Alerts · 12
Light ground, dark text, AAA (7:1) in both themes. bg-strong is for critical, blocking states.
LightDark
alert-error-bg
error-10 (#fff9f7) · dark error-900 (#560603)
Error alert ground (default). No stroke.
LightDark
alert-error-bg-strong
error-50 (#fff0ec) · dark error-800 (#6c1008)
Error alert ground, high emphasis (critical, blocking).
LightDark
alert-error-fg
error-800 (#6c1008) · dark error-50 (#fff0ec)
Error alert title, text and glyph. WCAG AAA: 7:1 or better on both alert grounds, both themes.
LightDark
alert-warning-bg
warning-10 (#fff9f0) · dark warning-900 (#483001)
Warning alert ground (default). No stroke.
LightDark
alert-warning-bg-strong
warning-50 (#fff4e0) · dark warning-800 (#634400)
Warning alert ground, high emphasis (critical, blocking).
LightDark
alert-warning-fg
warning-800 (#634400) · dark warning-50 (#fff4e0)
Warning alert title, text and glyph. WCAG AAA: 7:1 or better on both alert grounds, both themes.
LightDark
alert-success-bg
success-10 (#f1fff0) · dark success-900 (#003502)
Success alert ground (default). No stroke.
LightDark
alert-success-bg-strong
success-50 (#e5fbe3) · dark success-800 (#004703)
Success alert ground, high emphasis (critical, blocking).
LightDark
alert-success-fg
success-800 (#004703) · dark success-50 (#e5fbe3)
Success alert title, text and glyph. WCAG AAA: 7:1 or better on both alert grounds, both themes.
LightDark
alert-info-bg
info-10 (#f7fafe) · dark info-900 (#011d46)
Info alert ground (default). No stroke.
LightDark
alert-info-bg-strong
info-50 (#edf4fe) · dark info-800 (#042858)
Info alert ground, high emphasis (critical, blocking).
LightDark
alert-info-fg
info-800 (#042858) · dark info-50 (#edf4fe)
Info alert title, text and glyph. WCAG AAA: 7:1 or better on both alert grounds, both themes.
Layer 3 · @theme (Tailwind) (54)
Tailwind utility aliases from the @theme inline block in src/styles/theme.css. The default Tailwind palette is removed, so these are the only colour utilities: bg-page, text-ink, border-line-strong and so on.
LightDark
bg-page · text-page
→ surface-page
LightDark
bg-surface-0 · text-surface-0
→ surface-0
LightDark
bg-surface-1 · text-surface-1
→ surface-1
LightDark
bg-surface-2 · text-surface-2
→ surface-2
LightDark
bg-surface-3 · text-surface-3
→ surface-3
LightDark
bg-surface-subtle · text-surface-subtle
→ surface-subtle
LightDark
bg-ink · text-ink
→ text-primary
LightDark
bg-ink-secondary · text-ink-secondary
→ text-secondary
LightDark
bg-ink-disabled · text-ink-disabled
→ text-disabled
LightDark
bg-ink-inverse · text-ink-inverse
→ text-inverse
LightDark
bg-line-subtle · text-line-subtle
→ border-subtle
LightDark
bg-line-strong · text-line-strong
→ border-strong
LightDark
bg-brand · text-brand
→ primary
LightDark
bg-brand-hover · text-brand-hover
→ primary-hover
LightDark
bg-brand-subtle · text-brand-subtle
→ primary-subtle
LightDark
bg-on-brand · text-on-brand
→ on-primary
LightDark
bg-accent-ink · text-accent-ink
→ accent-text
LightDark
bg-accent-ground · text-accent-ground
→ accent-subtle
LightDark
bg-status-error · text-status-error
→ error-text
LightDark
bg-status-warning · text-status-warning
→ warning-text
LightDark
bg-status-success · text-status-success
→ success-text
LightDark
bg-status-info · text-status-info
→ info-text
LightDark
bg-background · text-background
→ surface-page
LightDark
bg-foreground · text-foreground
→ text-primary
LightDark
bg-card · text-card
→ surface-0
LightDark
bg-card-foreground · text-card-foreground
→ text-primary
LightDark
bg-popover · text-popover
→ surface-0
LightDark
bg-popover-foreground · text-popover-foreground
→ text-primary
LightDark
bg-primary · text-primary
→ btn-primary-bg
LightDark
bg-primary-foreground · text-primary-foreground
→ btn-primary-fg
LightDark
bg-secondary · text-secondary
→ surface-subtle
LightDark
bg-secondary-foreground · text-secondary-foreground
→ text-primary
LightDark
bg-muted · text-muted
→ surface-subtle
LightDark
bg-muted-foreground · text-muted-foreground
→ text-secondary
LightDark
bg-accent · text-accent
→ surface-subtle
LightDark
bg-accent-foreground · text-accent-foreground
→ text-primary
LightDark
bg-destructive · text-destructive
→ error-fill
LightDark
bg-destructive-foreground · text-destructive-foreground
→ on-error
LightDark
bg-border · text-border
→ border-subtle
LightDark
bg-input · text-input
→ border-strong
LightDark
bg-ring · text-ring
→ focus-ring
LightDark
bg-chart-1 · text-chart-1
→ teal-500
LightDark
bg-chart-2 · text-chart-2
→ bronze-500
LightDark
bg-chart-3 · text-chart-3
→ info-500
LightDark
bg-chart-4 · text-chart-4
→ success-500
LightDark
bg-chart-5 · text-chart-5
→ warning-500
LightDark
bg-sidebar · text-sidebar
→ surface-0
LightDark
bg-sidebar-foreground · text-sidebar-foreground
→ text-primary
LightDark
bg-sidebar-primary · text-sidebar-primary
→ btn-primary-bg
LightDark
bg-sidebar-primary-foreground · text-sidebar-primary-foreground
→ btn-primary-fg
LightDark
bg-sidebar-accent · text-sidebar-accent
→ surface-subtle
LightDark
bg-sidebar-accent-foreground · text-sidebar-accent-foreground
→ text-primary
LightDark
bg-sidebar-border · text-sidebar-border
→ border-subtle
LightDark
bg-sidebar-ring · text-sidebar-ring
→ focus-ring