Colour
Use tokens by name, never hex. Every token's note in tokens.json says where it goes and what text reads on it.
primaryfills the one main action per area, selected slots and chips, active tab lines.primary-inkis the text on it.primary-softwithprimary-strongtext marks active nav items and info tags.inkfor body text onsurface,canvasandsurface-muted;ink-2for secondary text;mutedfor help text and meta.surfacefor cards, modals and inputs;canvasfor the page;surface-mutedfor table headers and read-only fields;surface-altfor the lock banner.borderfor card and input lines;border-strongfor switch tracks and signature pads.- Status:
success,danger,warning(stripes and bars, never text), with-strongtext on-softfills for tags and banners.warning-boxwithwarning-linefor warning banners. - AI purple
ai,ai-soft,ai-lineonly for AI actions and AI-made content. - Appointment types
appt-bluetoappt-grayonly as the 4px chip stripe and legend dots, always beside the type name. accentonly for style highlights: the account avatar, the active patient tab line, New badges.
Brand and surfaces
| Token | Classic | Clinical Sidebar | Focus Rail | Command Bar | Dark | Usage |
|---|---|---|---|---|---|---|
--co-primary | #2E5880 | #0F766E | #3B4FD8 | #166534 | #2DD4BF | Primary buttons, active tab underline, selected slot and chip fills, focus of the brand. Text primary-ink on it. As text (link) on surface. |
--co-primary-hover | #244A6D | #0C615A | #3041B1 | #12532B | #5EEAD4 | Hover fill of primary buttons (source: primary mixed 82% with black). |
--co-primary-strong | #1D4F7C | #0C5C56 | #2E3EA8 | #114F29 | #5EEAD4 | Text on primary-soft (active nav item, info tag, selected segmented button); pressed fills; mobile and kiosk header bar with white text. |
--co-primary-soft | #DEE9FB | #DDECEB | #E4E6FA | #DEE9E3 | #123B37 | Active nav item, info tag and selected secondary button background. Holds primary-strong text. |
--co-primary-tint | #F5F8FD | #F3F8F8 | #F5F6FD | #F3F7F5 | #13201F | Hover wash on free calendar cells and selected pick cards. |
--co-primary-line | #5281DD | #6FADA8 | #8995E8 | #73A385 | #2A9D8F | Border of a pressed secondary button; the Blue appointment colour. |
--co-line-soft | #C9D6E6 | #CAE1DF | #D4D8F6 | #CCDDD2 | #24423F | Border of the read-only lock banner and dashed drop zones. |
--co-link | #2F6FA8 | #0F766E | #3B4FD8 | #166534 | #5EEAD4 | Inline links and link buttons on surface and canvas. |
--co-primary-ink | #FFFFFF | #FFFFFF | #FFFFFF | #FFFFFF | #042F2B | Text and icons on primary fills. |
--co-ink | #1F2937 | #0B1F1E | #111827 | #111827 | #E8EFEE | Body text and headings on surface, canvas, surface-muted. |
--co-ink-2 | #374151 | #2E3F3D | #334155 | #374151 | #C5D1CF | Secondary text: table cells, notes, unselected nav items, on surface and surface-muted. |
--co-muted | #586779 | #526A63 | #596879 | #586779 | #ADBDB8 | Helper text, column meta, inactive tabs, placeholder, on surface and canvas. Contrast fix applied 10/09/2026 (lightness only, hue and saturation kept, WCAG 2 formula): Classic was #6B7280 (canvas 4.32:1, surface-muted 4.39:1, under 4.5:1 for help and caption text); Focus Rail was #64748B (canvas 4.41:1, surface-muted 4.17:1, under 4.5:1 for help and caption text); Command Bar was #6B7280 (surface-muted 4.39:1, under 4.5:1 for help and caption text). |
--co-border | #CBD5E1 | #CBD5D3 | #CDD5E0 | #CBD5D8 | #405351 | Card, input, table and divider lines. Decorative only; inputs rely on the label plus this line. Contrast fix applied 10/09/2026 (lightness only, hue and saturation kept, WCAG 2 formula): Classic was #E3E6EA (surface 1.25:1, under 3:1 for input boundary (WCAG 1.4.11 non-text, 3:1)); Clinical Sidebar was #E4E0D8 (surface 1.32:1, under 3:1 for input boundary (WCAG 1.4.11 non-text, 3:1)); Focus Rail was #E2E5EE (surface 1.26:1, under 3:1 for input boundary (WCAG 1.4.11 non-text, 3:1)); Command Bar was #E5E7EB (surface 1.24:1, under 3:1 for input boundary (WCAG 1.4.11 non-text, 3:1)). Contrast fix applied 10/09/2026 (lightness only, hue and saturation kept, WCAG 2 formula): Dark was #2E3D3B (surface 1.45:1, under 3:1 for input boundary (WCAG 1.4.11 non-text, 3:1)). |
--co-border-strong | #8291A5 | #8291A5 | #8291A5 | #8291A5 | #718884 | Unchecked switch track, dashed add button, signature pad border. |
--co-surface | #FFFFFF | #FFFFFF | #FFFFFF | #FFFFFF | #172120 | Cards, modals, drawers, menus, inputs, table body. |
--co-surface-muted | #F3F4F6 | #EFECE5 | #EEF0F5 | #F3F4F6 | #22302E | Table header, read-only input, hover row, note box, neutral tag. |
--co-surface-alt | #EEF2F7 | #EEF3F1 | #ECEFF7 | #F3F6F4 | #1C2B29 | Lock banner, Scheduled appointment chip, Viewing as pill. |
--co-canvas | #F4F7FA | #F3F7F6 | #F4F7FB | #F4F7F8 | #111C1B | Page background behind cards. |
--co-canvas-soft | #FAFBFC | #FAF9F6 | #F9FAFC | #F9FAFB | #121A19 | Search box fill, calendar time column, drop zone fill. |
--co-accent | #926723 | #AE5009 | #CA381A | #956603 | #F59E0B | Style highlight (Classic: the gold account avatar #d7a657): active patient tab top line (Focus Rail coral), New badge text, account avatar fill. Contrast fix applied 10/09/2026 (lightness only, hue and saturation kept, WCAG 2 formula): Classic was #D7A657 (surface-muted 2.01:1, surface 2.21:1, on-accent 2.21:1, under 4.5:1 for accent as text, and white initials on the accent avatar); Clinical Sidebar was #B45309 (surface-muted 4.26:1, under 4.5:1 for accent as text); Focus Rail was #E8654A (surface-muted 2.88:1, surface 3.29:1, on-accent 3.29:1, under 4.5:1 for accent as text, and white initials on the accent avatar); Command Bar was #CA8A04 (surface-muted 2.67:1, surface 2.94:1, on-accent 2.94:1, under 4.5:1 for accent as text, and white initials on the accent avatar). |
--co-nav-bg | #285278 | #FFFFFF | #1E2A44 | #FFFFFF | #172120 | Navigation surface: navy top bar in Classic, white for Sidebar and Command Bar, slate rail for Focus Rail. |
--co-nav-ink | #FFFFFF | #0B1F1E | #FFFFFF | #111827 | #E8EFEE | Active text and icons on nav-bg. |
--co-nav-ink-muted | #FFFFFF | #5B6B69 | #C0C3CB | #6B7280 | #93A3A0 | Inactive rail icons on nav-bg (source: white at 72% on the slate rail). |
--co-focus-ring | #2E5880 | #0F766E | #3B4FD8 | #166534 | #5EEAD4 | 2px solid keyboard focus outline with 2px offset, on every control. An added rule: the screens set no focus style of their own. |
--co-toast-bg | #1F2937 | #0B1F1E | #111827 | #111827 | #E8EFEE | Toast background (source: ink). Text toast-ink on it. |
--co-toast-ink | #FFFFFF | #FFFFFF | #FFFFFF | #FFFFFF | #0E1514 | Toast text on toast-bg. |
--co-overlay | rgba(17,24,39,0.45) | rgba(17,24,39,0.45) | rgba(17,24,39,0.45) | rgba(17,24,39,0.45) | rgba(0,0,0,0.6) | Scrim behind modals, drawers and the command palette. |
Status and AI
| Token | Classic | Clinical Sidebar | Focus Rail | Command Bar | Dark | Usage |
|---|---|---|---|---|---|---|
--co-success | #1E9E5A | #1E9E5A | #1E9E5A | #1E9E5A | #34D399 | Success circle, checked switch, completed step and appointment stripe. Icons on it use on-status. |
--co-success-strong | #13703F | #13703F | #13703F | #13703F | #6EE7B7 | Success text on success-soft (Approved, Paid, Eligible tags). |
--co-success-soft | #D9F8E6 | #D9F8E6 | #D9F8E6 | #D9F8E6 | #0F3324 | Success tag and Completed appointment background. |
--co-danger | #D9342B | #D9342B | #D9342B | #D9342B | #F87171 | Required asterisk, field error text and border, delete button text, notification count badge, No Show stripe. |
--co-danger-strong | #B42318 | #B42318 | #B42318 | #B42318 | #FCA5A5 | Danger tag text on danger-soft (Denied, Rejected, Allergy). |
--co-danger-soft | #FDE4E2 | #FDE4E2 | #FDE4E2 | #FDE4E2 | #3B1717 | Danger tag, error banner and allergy strip background. |
--co-danger-line | #F1B9B5 | #F1B9B5 | #F1B9B5 | #F1B9B5 | #7F2A2A | Border of the danger button and error banner. |
--co-danger-ink | #7A1D16 | #7A1D16 | #7A1D16 | #7A1D16 | #FECACA | Body text inside the error banner and restricted-chart box on danger-soft. |
--co-warning | #C8961E | #C8961E | #C8961E | #C8961E | #FBBF24 | Arrived and Checked In appointment stripe, low-value bar. Never text. |
--co-warning-strong | #7A5A12 | #7A5A12 | #7A5A12 | #7A5A12 | #FDE68A | Warning tag text on warning-soft (Pending, Pended, Expiring). |
--co-warning-soft | #FCF3CC | #FCF3CC | #FCF3CC | #FCF3CC | #3A2E0A | Warning tag and Arrived appointment background. |
--co-warning-box | #FFF4E5 | #FFF4E5 | #FFF4E5 | #FFF4E5 | #2E2410 | Warning banner background (holds ink). |
--co-warning-line | #F5C98A | #F5C98A | #F5C98A | #F5C98A | #8A6A1F | Warning banner border. |
--co-ai | #6B2A8C | #6B2A8C | #6B2A8C | #6B2A8C | #C084FC | AI actions and AI-made content: AI button fill, In Room stripe, AI spinner. Text ai-ink on it; as text on ai-soft. |
--co-ai-ink | #FFFFFF | #FFFFFF | #FFFFFF | #FFFFFF | #2A0E3A | Text on the ai fill. |
--co-ai-soft | #F5F2FA | #F5F2FA | #F5F2FA | #F5F2FA | #2E263A | AI suggestion box and AI tag background. |
--co-ai-line | #ECC8E3 | #ECC8E3 | #ECC8E3 | #ECC8E3 | #5B2D73 | AI suggestion box border. |
--co-on-status | #FFFFFF | #FFFFFF | #FFFFFF | #FFFFFF | #0E1514 | Icon or count text on success and danger fills. |
--co-on-accent | #FFFFFF | #FFFFFF | #FFFFFF | #FFFFFF | #0E1514 | Initials on the account avatar (accent fill).21:1; rail: on-accent on accent is 3.29:1; command: on-accent on accent is 2.94:1. Passes 4.5:1 in every theme since the 10/09/2026 accent fix (was 2.21:1 Classic, 3.29:1 Focus Rail, 2.94:1 Command Bar). |
Appointment types
| Token | Classic | Clinical Sidebar | Focus Rail | Command Bar | Dark | Usage |
|---|---|---|---|---|---|---|
--co-appt-blue | #5281DD | #569792 | #7482E4 | #659978 | #7AA2F7 | Default appointment type colour (New Patient). Follows the style: primary-line. Used as the 4px left stripe and legend dot only, always next to the type name; the chip text stays ink on surface-alt. As a mark it is below 3:1 on surface-alt for Blue, Teal, Orange and Yellow in the light styles (source colours kept), so colour never carries the type alone. Contrast fix applied 10/09/2026 (lightness only, hue and saturation kept, WCAG 2 formula): Clinical Sidebar was #6FADA8 (surface-alt 2.28:1, under 3:1 for appointment stripe (non-text, 3:1)); Focus Rail was #8995E8 (surface-alt 2.43:1, under 3:1 for appointment stripe (non-text, 3:1)); Command Bar was #73A385 (surface-alt 2.64:1, under 3:1 for appointment stripe (non-text, 3:1)). |
--co-appt-green | #1E9E5A | #1E9E5A | #1E9D59 | #1E9E5A | #1E9E5A | Follow-Up and other routine types. Used as the 4px left stripe and legend dot only, always next to the type name; the chip text stays ink on surface-alt. After the 10/09/2026 fixes every appointment colour reaches 3:1 on surface and surface-alt in all five themes (build/contrast_check.py); colour still never carries the type alone. Contrast fix applied 10/09/2026 (lightness only, hue and saturation kept, WCAG 2 formula): Focus Rail was #1E9E5A (surface 3.45:1, surface-alt 3.00:1, under 3:1 for appointment stripe and legend dot (3:1 non-text)). |
--co-appt-teal | #139B9B | #139B9B | #139999 | #139E9E | #14A3A3 | Procedures and screenings. Used as the 4px left stripe and legend dot only, always next to the type name; the chip text stays ink on surface-alt. As a mark it is below 3:1 on surface-alt for Blue, Teal, Orange and Yellow in the light styles (source colours kept), so colour never carries the type alone. Contrast fix applied 10/09/2026 (lightness only, hue and saturation kept, WCAG 2 formula): Classic was #14A3A3 (surface-alt 2.75:1, under 3:1 for appointment stripe (non-text, 3:1)); Clinical Sidebar was #14A3A3 (surface-alt 2.75:1, under 3:1 for appointment stripe (non-text, 3:1)); Focus Rail was #14A3A3 (surface-alt 2.69:1, under 3:1 for appointment stripe (non-text, 3:1)); Command Bar was #14A3A3 (surface-alt 2.84:1, under 3:1 for appointment stripe (non-text, 3:1)). |
--co-appt-purple | #6B2A8C | #6B2A8C | #6B2A8C | #6B2A8C | #B57BD6 | Behavioral health types; also the AI purple. Used as the 4px left stripe and legend dot only, always next to the type name; the chip text stays ink on surface-alt. As a mark it is below 3:1 on surface-alt for Blue, Teal, Orange and Yellow in the light styles (source colours kept), so colour never carries the type alone. |
--co-appt-red | #D9342B | #D9342B | #D9342B | #D9342B | #D9342B | Urgent and same-day types. Used as the 4px left stripe and legend dot only, always next to the type name; the chip text stays ink on surface-alt. As a mark it is below 3:1 on surface-alt for Blue, Teal, Orange and Yellow in the light styles (source colours kept), so colour never carries the type alone. |
--co-appt-orange | #D17419 | #D17419 | #CE7219 | #D47619 | #E47F1C | Physical therapy and rehab types. Used as the 4px left stripe and legend dot only, always next to the type name; the chip text stays ink on surface-alt. As a mark it is below 3:1 on surface-alt for Blue, Teal, Orange and Yellow in the light styles (source colours kept), so colour never carries the type alone. Contrast fix applied 10/09/2026 (lightness only, hue and saturation kept, WCAG 2 formula): Classic was #E47F1C (surface-alt 2.54:1, under 3:1 for appointment stripe (non-text, 3:1)); Clinical Sidebar was #E47F1C (surface-alt 2.55:1, under 3:1 for appointment stripe (non-text, 3:1)); Focus Rail was #E47F1C (surface-alt 2.48:1, under 3:1 for appointment stripe (non-text, 3:1)); Command Bar was #E47F1C (surface-alt 2.63:1, under 3:1 for appointment stripe (non-text, 3:1)). |
--co-appt-yellow | #AC8610 | #AC8610 | #AA8510 | #B08911 | #E7B416 | Annual wellness and preventive types. Used as the 4px left stripe and legend dot only, always next to the type name; the chip text stays ink on surface-alt. As a mark it is below 3:1 on surface-alt for Blue, Teal, Orange and Yellow in the light styles (source colours kept), so colour never carries the type alone. Contrast fix applied 10/09/2026 (lightness only, hue and saturation kept, WCAG 2 formula): Classic was #E7B416 (surface-alt 1.71:1, under 3:1 for appointment stripe (non-text, 3:1)); Clinical Sidebar was #E7B416 (surface-alt 1.71:1, under 3:1 for appointment stripe (non-text, 3:1)); Focus Rail was #E7B416 (surface-alt 1.67:1, under 3:1 for appointment stripe (non-text, 3:1)); Command Bar was #E7B416 (surface-alt 1.76:1, under 3:1 for appointment stripe (non-text, 3:1)). |
--co-appt-pink | #D6489B | #D6489B | #D6489B | #D6489B | #D6489B | OB/GYN and prenatal types. Used as the 4px left stripe and legend dot only, always next to the type name; the chip text stays ink on surface-alt. As a mark it is below 3:1 on surface-alt for Blue, Teal, Orange and Yellow in the light styles (source colours kept), so colour never carries the type alone. |
--co-appt-gray | #6B7280 | #5B6B69 | #64748B | #6B7280 | #93A3A0 | Admin and blocked-time types. Used as the 4px left stripe and legend dot only, always next to the type name; the chip text stays ink on surface-alt. As a mark it is below 3:1 on surface-alt for Blue, Teal, Orange and Yellow in the light styles (source colours kept), so colour never carries the type alone. |