Skip to main content

Colour

Use tokens by name, never hex. Every token's note in tokens.json says where it goes and what text reads on it.

  • primary fills the one main action per area, selected slots and chips, active tab lines. primary-ink is the text on it. primary-soft with primary-strong text marks active nav items and info tags.
  • ink for body text on surface, canvas and surface-muted; ink-2 for secondary text; muted for help text and meta.
  • surface for cards, modals and inputs; canvas for the page; surface-muted for table headers and read-only fields; surface-alt for the lock banner.
  • border for card and input lines; border-strong for switch tracks and signature pads.
  • Status: success, danger, warning (stripes and bars, never text), with -strong text on -soft fills for tags and banners. warning-box with warning-line for warning banners.
  • AI purple ai, ai-soft, ai-line only for AI actions and AI-made content.
  • Appointment types appt-blue to appt-gray only as the 4px chip stripe and legend dots, always beside the type name.
  • accent only for style highlights: the account avatar, the active patient tab line, New badges.

Brand and surfaces​

TokenClassicClinical SidebarFocus RailCommand BarDarkUsage
--co-primary#2E5880#0F766E#3B4FD8#166534#2DD4BFPrimary 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#5EEAD4Hover fill of primary buttons (source: primary mixed 82% with black).
--co-primary-strong#1D4F7C#0C5C56#2E3EA8#114F29#5EEAD4Text 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#123B37Active nav item, info tag and selected secondary button background. Holds primary-strong text.
--co-primary-tint#F5F8FD#F3F8F8#F5F6FD#F3F7F5#13201FHover wash on free calendar cells and selected pick cards.
--co-primary-line#5281DD#6FADA8#8995E8#73A385#2A9D8FBorder of a pressed secondary button; the Blue appointment colour.
--co-line-soft#C9D6E6#CAE1DF#D4D8F6#CCDDD2#24423FBorder of the read-only lock banner and dashed drop zones.
--co-link#2F6FA8#0F766E#3B4FD8#166534#5EEAD4Inline links and link buttons on surface and canvas.
--co-primary-ink#FFFFFF#FFFFFF#FFFFFF#FFFFFF#042F2BText and icons on primary fills.
--co-ink#1F2937#0B1F1E#111827#111827#E8EFEEBody text and headings on surface, canvas, surface-muted.
--co-ink-2#374151#2E3F3D#334155#374151#C5D1CFSecondary text: table cells, notes, unselected nav items, on surface and surface-muted.
--co-muted#586779#526A63#596879#586779#ADBDB8Helper 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#405351Card, 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#718884Unchecked switch track, dashed add button, signature pad border.
--co-surface#FFFFFF#FFFFFF#FFFFFF#FFFFFF#172120Cards, modals, drawers, menus, inputs, table body.
--co-surface-muted#F3F4F6#EFECE5#EEF0F5#F3F4F6#22302ETable header, read-only input, hover row, note box, neutral tag.
--co-surface-alt#EEF2F7#EEF3F1#ECEFF7#F3F6F4#1C2B29Lock banner, Scheduled appointment chip, Viewing as pill.
--co-canvas#F4F7FA#F3F7F6#F4F7FB#F4F7F8#111C1BPage background behind cards.
--co-canvas-soft#FAFBFC#FAF9F6#F9FAFC#F9FAFB#121A19Search box fill, calendar time column, drop zone fill.
--co-accent#926723#AE5009#CA381A#956603#F59E0BStyle 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#172120Navigation surface: navy top bar in Classic, white for Sidebar and Command Bar, slate rail for Focus Rail.
--co-nav-ink#FFFFFF#0B1F1E#FFFFFF#111827#E8EFEEActive text and icons on nav-bg.
--co-nav-ink-muted#FFFFFF#5B6B69#C0C3CB#6B7280#93A3A0Inactive rail icons on nav-bg (source: white at 72% on the slate rail).
--co-focus-ring#2E5880#0F766E#3B4FD8#166534#5EEAD42px 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#E8EFEEToast background (source: ink). Text toast-ink on it.
--co-toast-ink#FFFFFF#FFFFFF#FFFFFF#FFFFFF#0E1514Toast text on toast-bg.
--co-overlayrgba(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​

TokenClassicClinical SidebarFocus RailCommand BarDarkUsage
--co-success#1E9E5A#1E9E5A#1E9E5A#1E9E5A#34D399Success circle, checked switch, completed step and appointment stripe. Icons on it use on-status.
--co-success-strong#13703F#13703F#13703F#13703F#6EE7B7Success text on success-soft (Approved, Paid, Eligible tags).
--co-success-soft#D9F8E6#D9F8E6#D9F8E6#D9F8E6#0F3324Success tag and Completed appointment background.
--co-danger#D9342B#D9342B#D9342B#D9342B#F87171Required asterisk, field error text and border, delete button text, notification count badge, No Show stripe.
--co-danger-strong#B42318#B42318#B42318#B42318#FCA5A5Danger tag text on danger-soft (Denied, Rejected, Allergy).
--co-danger-soft#FDE4E2#FDE4E2#FDE4E2#FDE4E2#3B1717Danger tag, error banner and allergy strip background.
--co-danger-line#F1B9B5#F1B9B5#F1B9B5#F1B9B5#7F2A2ABorder of the danger button and error banner.
--co-danger-ink#7A1D16#7A1D16#7A1D16#7A1D16#FECACABody text inside the error banner and restricted-chart box on danger-soft.
--co-warning#C8961E#C8961E#C8961E#C8961E#FBBF24Arrived and Checked In appointment stripe, low-value bar. Never text.
--co-warning-strong#7A5A12#7A5A12#7A5A12#7A5A12#FDE68AWarning tag text on warning-soft (Pending, Pended, Expiring).
--co-warning-soft#FCF3CC#FCF3CC#FCF3CC#FCF3CC#3A2E0AWarning tag and Arrived appointment background.
--co-warning-box#FFF4E5#FFF4E5#FFF4E5#FFF4E5#2E2410Warning banner background (holds ink).
--co-warning-line#F5C98A#F5C98A#F5C98A#F5C98A#8A6A1FWarning banner border.
--co-ai#6B2A8C#6B2A8C#6B2A8C#6B2A8C#C084FCAI 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#2A0E3AText on the ai fill.
--co-ai-soft#F5F2FA#F5F2FA#F5F2FA#F5F2FA#2E263AAI suggestion box and AI tag background.
--co-ai-line#ECC8E3#ECC8E3#ECC8E3#ECC8E3#5B2D73AI suggestion box border.
--co-on-status#FFFFFF#FFFFFF#FFFFFF#FFFFFF#0E1514Icon or count text on success and danger fills.
--co-on-accent#FFFFFF#FFFFFF#FFFFFF#FFFFFF#0E1514Initials 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​

TokenClassicClinical SidebarFocus RailCommand BarDarkUsage
--co-appt-blue#5281DD#569792#7482E4#659978#7AA2F7Default 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#1E9E5AFollow-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#14A3A3Procedures 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#B57BD6Behavioral 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#D9342BUrgent 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#E47F1CPhysical 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#E7B416Annual 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#D6489BOB/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#93A3A0Admin 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.