Evantis

Design System

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

Teal · primary · 29 steps

Bronze · accent · 19 steps

Error · 12 steps

Warning · 12 steps

Success · 12 steps

Info · 12 steps

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.

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

surface-0
neutral-0 (#ffffff) · dark neutral-950 (#191d1f)

Resting surfaces: flat cards, sections, table bodies (elevation 0).

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.

surface-2
neutral-0 (#ffffff) · dark neutral-850 (#313536)

Overlay: dropdowns, popovers, tooltips (elevation 2).

surface-3
neutral-0 (#ffffff) · dark neutral-800 (#3d4142)

Modal: dialogs and sheets (elevation 3).

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

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.

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.

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.

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.

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

text-secondary
neutral-650 (#626466) · dark neutral-350 (#aaacac)

Metadata, hints, column headers. 4.5:1 or better on every surface token, both themes.

text-disabled
neutral-450 (#929495) · dark neutral-600 (#6e7071)

Disabled labels only (exempt from contrast minimums; never for information).

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.

border-subtle
neutral-70 (#eeeeee) · dark neutral-800 (#3d4142)

Hairlines and dividers. Decorative only: never the sole boundary of a control.

border-strong
neutral-500 (#868889) · dark neutral-400 (#9ea0a1)

Input, checkbox and chip borders: 3:1 or better on every surface token, both themes.

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.

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.

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.

sidebar-link-hover
teal-650 (#207862) · dark teal-300 (#98c1b7)

Sidebar links and icons on hover (Marcel, 2026-11-11): teal-650 #207862.

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.

primary-hover
teal-800 (#0c5846) · dark teal-200 (#bad6cf)

Primary fill on hover.

primary-pressed
teal-900 (#094335) · dark teal-150 (#cce0db)

Primary fill while pressed.

on-primary
neutral-0 (#ffffff) · dark neutral-1000 (#0d1113)

Label on primary, primary-hover and primary-pressed fills, both themes.

primary-subtle
teal-50 (#eef5f3) · dark teal-950 (#08382d)

Selected rows and selected chips.

primary-text-on-subtle
teal-800 (#0c5846) · dark teal-200 (#bad6cf)

Text on primary-subtle: 7.6:1 light, 8.4:1 dark.

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.

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.

accent-subtle
bronze-40 (#f5edde) · dark bronze-1000 (#2b1c01)

Caregiver onboarding grounds only. Never a banner or badge ground (reads as warning).

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

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.

Buttons · 17

Primary (teal), secondary (bronze) and disabled, for filled, outline and text buttons.

btn-primary-bg
teal-700 (#0f6e56) · dark teal-300 (#98c1b7)

Primary filled button: background.

btn-primary-bg-hover
teal-850 (#0a4e3e) · dark teal-200 (#bad6cf)

Primary filled button: hover background.

btn-primary-bg-active
teal-1000 (#062d25) · dark teal-400 (#76ac9e)

Primary filled button: pressed background.

btn-primary-fg
teal-10 (#fcfdfd) · dark teal-1000 (#062d25)

Primary filled button: label. 8.2:1 or better on every primary fill state, both themes.

btn-primary-ink
teal-900 (#094335) · dark teal-300 (#98c1b7)

Primary outline and text buttons: label and border. 9.1:1 light, 5.7:1 dark, or better, in every state.

btn-primary-tint-hover
teal-50 (#eef5f3) · dark teal-950 (#08382d)

Primary outline and text buttons: hover background.

btn-primary-tint-active
teal-100 (#ddeae7) · dark teal-900 (#094335)

Primary outline and text buttons: pressed background.

btn-secondary-bg
bronze-500 (#8b7040) · dark bronze-300 (#c4b08d)

Secondary (bronze) filled button: background.

btn-secondary-bg-hover
bronze-500 (#8b7040) · dark bronze-200 (#d8c9ad)

Secondary filled button: hover background.

btn-secondary-bg-active
bronze-700 (#624c24) · dark bronze-400 (#b0986e)

Secondary filled button: pressed background.

btn-secondary-fg
neutral-0 (#ffffff) · dark bronze-1000 (#2b1c01)

Secondary filled button: label. 5.6:1 or better on every secondary fill state, both themes.

btn-secondary-ink
bronze-500 (#8b7040) · dark bronze-300 (#c4b08d)

Secondary outline and text buttons: label and border. 4.8:1 light, 6.5:1 dark, or better, in every state.

btn-secondary-tint-hover
bronze-40 (#f5edde) · dark bronze-1000 (#2b1c01)

Secondary outline and text buttons: hover background.

btn-secondary-tint-active
bronze-80 (#efe4d2) · dark bronze-900 (#3c2a0a)

Secondary outline and text buttons: pressed background.

btn-disabled-bg
neutral-100 (#e7e7e7) · dark neutral-900 (#25292b)

Disabled filled button: background.

btn-disabled-fg
neutral-450 (#929495) · dark neutral-600 (#6e7071)

Disabled button label (exempt from contrast minimums).

btn-disabled-line
neutral-200 (#cfcfd0) · dark neutral-800 (#3d4142)

Disabled outline button: border.

Status · 20

Safety out-ranks brand. Status is never colour alone: every status carries its glyph and a word.

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.

error-fill
error-500 (#c0392b)

Solid error fill (critical banners, danger buttons), both themes.

error-subtle
error-100 (#ffe0d9) · dark error-900 (#560603)

Error banner and badge ground.

error-text
error-800 (#6c1008) · dark error-200 (#ffc2b5)

Error text on error-subtle and on any surface token, both themes.

on-error
neutral-0 (#ffffff)

Text on error-fill: 5.44:1.

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.

warning-fill
warning-500 (#d69d01)

Solid warning fill, both themes. Text on it is on-warning.

warning-subtle
warning-100 (#ffeac5) · dark warning-900 (#483001)

Warning banner and badge ground.

warning-text
warning-800 (#634400) · dark warning-300 (#f0c77a)

Warning text on warning-subtle and on any surface token, both themes.

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.

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.

success-fill
success-500 (#208922)

Solid success fill, both themes.

success-subtle
success-100 (#d4f4d2) · dark success-900 (#003502)

Success banner and badge ground.

success-text
success-800 (#004703) · dark success-200 (#b3e4b0)

Success text on success-subtle and on any surface token, both themes.

on-success
neutral-0 (#ffffff)

Text on success-fill: 4.5:1.

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.

info-fill
info-500 (#215398)

Solid info fill, both themes.

info-subtle
info-100 (#dae9fe) · dark info-900 (#011d46)

Info banner and badge ground.

info-text
info-700 (#0c356b) · dark info-200 (#b7d3fb)

Info text on info-subtle and on any surface token, both themes.

on-info
neutral-0 (#ffffff)

Text on info-fill: 7.62:1.

Badges · 5

A barely-there ground so a badge never looks pressable.

badge-neutral-bg
neutral-50 (#f3f3f3) · dark neutral-950 (#191d1f)

Neutral badge ground: barely there, no border.

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

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

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

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.

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.

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.

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.

alert-error-bg
error-10 (#fff9f7) · dark error-900 (#560603)

Error alert ground (default). No stroke.

alert-error-bg-strong
error-50 (#fff0ec) · dark error-800 (#6c1008)

Error alert ground, high emphasis (critical, blocking).

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.

alert-warning-bg
warning-10 (#fff9f0) · dark warning-900 (#483001)

Warning alert ground (default). No stroke.

alert-warning-bg-strong
warning-50 (#fff4e0) · dark warning-800 (#634400)

Warning alert ground, high emphasis (critical, blocking).

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.

alert-success-bg
success-10 (#f1fff0) · dark success-900 (#003502)

Success alert ground (default). No stroke.

alert-success-bg-strong
success-50 (#e5fbe3) · dark success-800 (#004703)

Success alert ground, high emphasis (critical, blocking).

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.

alert-info-bg
info-10 (#f7fafe) · dark info-900 (#011d46)

Info alert ground (default). No stroke.

alert-info-bg-strong
info-50 (#edf4fe) · dark info-800 (#042858)

Info alert ground, high emphasis (critical, blocking).

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.

bg-page · text-page
→ surface-page
bg-surface-0 · text-surface-0
→ surface-0
bg-surface-1 · text-surface-1
→ surface-1
bg-surface-2 · text-surface-2
→ surface-2
bg-surface-3 · text-surface-3
→ surface-3
bg-surface-subtle · text-surface-subtle
→ surface-subtle
bg-ink · text-ink
→ text-primary
bg-ink-secondary · text-ink-secondary
→ text-secondary
bg-ink-disabled · text-ink-disabled
→ text-disabled
bg-ink-inverse · text-ink-inverse
→ text-inverse
bg-line-subtle · text-line-subtle
→ border-subtle
bg-line-strong · text-line-strong
→ border-strong
bg-brand · text-brand
→ primary
bg-brand-hover · text-brand-hover
→ primary-hover
bg-brand-subtle · text-brand-subtle
→ primary-subtle
bg-on-brand · text-on-brand
→ on-primary
bg-accent-ink · text-accent-ink
→ accent-text
bg-accent-ground · text-accent-ground
→ accent-subtle
bg-status-error · text-status-error
→ error-text
bg-status-warning · text-status-warning
→ warning-text
bg-status-success · text-status-success
→ success-text
bg-status-info · text-status-info
→ info-text
bg-background · text-background
→ surface-page
bg-foreground · text-foreground
→ text-primary
bg-card · text-card
→ surface-0
bg-card-foreground · text-card-foreground
→ text-primary
bg-popover · text-popover
→ surface-0
bg-popover-foreground · text-popover-foreground
→ text-primary
bg-primary · text-primary
→ btn-primary-bg
bg-primary-foreground · text-primary-foreground
→ btn-primary-fg
bg-secondary · text-secondary
→ surface-subtle
bg-secondary-foreground · text-secondary-foreground
→ text-primary
bg-muted · text-muted
→ surface-subtle
bg-muted-foreground · text-muted-foreground
→ text-secondary
bg-accent · text-accent
→ surface-subtle
bg-accent-foreground · text-accent-foreground
→ text-primary
bg-destructive · text-destructive
→ error-fill
bg-destructive-foreground · text-destructive-foreground
→ on-error
bg-border · text-border
→ border-subtle
bg-input · text-input
→ border-strong
bg-ring · text-ring
→ focus-ring
bg-chart-1 · text-chart-1
→ teal-500
bg-chart-2 · text-chart-2
→ bronze-500
bg-chart-3 · text-chart-3
→ info-500
bg-chart-4 · text-chart-4
→ success-500
bg-chart-5 · text-chart-5
→ warning-500
bg-sidebar · text-sidebar
→ surface-0
bg-sidebar-foreground · text-sidebar-foreground
→ text-primary
bg-sidebar-primary · text-sidebar-primary
→ btn-primary-bg
bg-sidebar-primary-foreground · text-sidebar-primary-foreground
→ btn-primary-fg
bg-sidebar-accent · text-sidebar-accent
→ surface-subtle
bg-sidebar-accent-foreground · text-sidebar-accent-foreground
→ text-primary
bg-sidebar-border · text-sidebar-border
→ border-subtle
bg-sidebar-ring · text-sidebar-ring
→ focus-ring