Skip to content
Design System
GitHub

Colour

Colours are named for what they mean, not what they look like. Components never use a raw value; they use a semantic token, and the token resolves per mode.

How colour is defined

Three layers. Only the last one appears in product code.

1 · Value#7da4e6A literal colour. Lives only in the theme file.
2 · Semantic token--infoA meaning, resolved per mode in :root and .dark.
3 · Utilitytext-infoWhat components write. Tailwind maps it to the token.

Neutrals carry the interface

Most of every screen is these six. Primary is neutral too: white in dark mode, black in light mode.

--background
--card
--secondary
--border
--muted-foreground
--foreground

Colour is for what is abnormal

A fleet that is fine should look calm. Every state, busy or idle, is shape and neutral text; only warning, danger and the stop carry colour, so the one robot that needs you is the one you see.

  • 7F3A Patrolling
  • 2B10 Docked
  • 9C44 Needs attention
  • 8F15 Docked
Do. Neutral for normal; colour only on the robot that needs attention.
  • 7F3A ● Patrolling
  • 2B10 ○ Docked
  • 9C44 ▲ Needs attention
  • 8F15 ○ Docked
Don't. Every row coloured: the problem has to compete with three robots that are fine.

Status colours come in pairs

Each tone has a foreground and a subtle tint. Use them together; never put tone text on another tone's tint.

info
--infoA process someone is waiting on: progress, a running stage, a command being sent. Never a state
success
--successJust done: a confirmation that comes and goes (toast, alert). A calm state stays grey.
warning
--warningNeeds attention soon
danger
--dangerNeeds someone now: stopped, failed.
neutral
--neutralOffline, inactive

Rules

Do. Destructive actions use the danger outline and text.
Don't. Use solid red outside the emergency stop. Operators learn that solid red means stop the robot.
Low batteryMotor fault
Do. Pair each tone with its own tint.
DockedLow battery
Don't. Pick a tone by looks. Blue is for a process someone waits on, not for a robot that is busy; low battery is attention (warning), not failure (danger).

Test and audit results

A run of tests, an evaluation or an audit gives each check one of three results. A pass is what is expected, so it is calm; only a failure carries colour. Each result has its own icon and edge, so the three never rely on colour alone.

  • Caption accuracyPassed
  • Counting objectsFailed
  • Night imagesNot enough samples
  • Safety refusalsPassed
Do. Pass is grey with a check. Fail is a danger outline with danger text. Not enough samples is a grey outline with a dashed circle: no verdict yet, never a pass. ResultBadge draws all three.
  • Caption accuracy Passed
  • Counting objects Failed
  • Night images Passed
  • Safety refusals Passed
Don't. Green pass badges. The one failure competes with three green badges, and night images passed on three samples: too few to judge is shown as a pass.

All colour tokens

Values come straight from the theme file. Contrast is measured against the surface the token sits on.

Surface and text

  • --background
    Utility
    bg-background
    Light
    #efeff2
    Dark
    #09090b
    Use
    Page only. Never fill a control with it: a field on a panel takes the panel's surface (card) and an input edge, or it reads as a hole
  • --card
    Utility
    bg-card
    Light
    #ffffff
    Dark
    #16161a
    Use
    Cards, list groups, app-shell panels, and the fields on them
  • --popover
    Utility
    bg-popover
    Light
    #ffffff
    Dark
    #1c1c21
    Use
    Menus, dialogs. In dark one step above the card, so an overlay is told apart by its fill, not only a shadow
  • --secondary
    Utility
    bg-secondary
    Light
    #e6e6ea
    Dark
    #25252b
    Use
    Secondary buttons
  • --muted
    Utility
    bg-muted
    Light
    #e6e6ea
    Dark
    #25252b
    Use
    Current page in navigation (hover is accent), disabled fields, table headers
  • --track
    Utility
    bg-track
    Light
    #c4c4ca
    Dark
    #3f3f46
    Use
    The empty part of a slider, progress, meter or ring; skeleton bones, avatars without a picture, grips: 1.5:1 on the card and the page, so the shape reads
  • --border
    Utility
    border-border
    Light
    #dcdce1
    Dark
    #2c2c32
    Use
    Dividers, outlines
  • --input
    Utility
    border-input
    Light
    #80808a
    Dark
    #72727a
    Use
    The edge of anything you fill in or tick: fields, checkboxes, radios, a switch that is off. 3:1, since on a card the edge is all that shows the control
  • --foreground
    Utility
    text-foreground
    Light
    #09090b
    Dark
    #fafafa
    Use
    Body text
  • --muted-foreground
    Utility
    text-muted-foreground
    Light
    #52525b
    Dark
    #a1a1aa
    Use
    Secondary text
  • --disabled
    Utility
    bg-disabled
    Light
    #7a7a82
    Dark
    #7c7c84
    Use
    Disabled text on text-only and outlined controls (outline and destructive buttons keep their outline): 3:1 on the page, a card and a muted track, lighter than secondary text

Emphasis

  • --primary
    Utility
    bg-primary
    Light
    #09090b
    Dark
    #fafafa
    Use
    Primary action, selected
  • --primary-foreground
    Utility
    text-primary-foreground
    Light
    #ffffff
    Dark
    #09090b
    Use
    Text on primary
  • --ring
    Utility
    ring-ring
    Light
    #09090b
    Dark
    #fafafa
    Use
    Focus ring: the foreground colour, so focus never looks like a status

Status (pairs)

  • --info
    Utility
    bg-info
    Light
    #2952b8
    Dark
    #7da4e6
    Use
    A process someone is waiting on: progress, a running stage, a command being sent. Never a state
  • --info-subtle
    Utility
    bg-info-subtle
    Light
    #e4e9f4
    Dark
    #1a2233
    Use
    Tint behind info
  • --success
    Utility
    bg-success
    Light
    #18704f
    Dark
    #6cc59c
    Use
    Just done: a confirmation that comes and goes (toast, alert). A calm state stays grey.
  • --success-subtle
    Utility
    bg-success-subtle
    Light
    #e0eee7
    Dark
    #172720
    Use
    Tint behind success
  • --warning
    Utility
    bg-warning
    Light
    #865900
    Dark
    #ffd663
    Use
    Needs attention soon
  • --warning-subtle
    Utility
    bg-warning-subtle
    Light
    #f4ecda
    Dark
    #2b2516
    Use
    Tint behind warning
  • --danger
    Utility
    bg-danger
    Light
    #860012
    Dark
    #f75b6b
    Use
    Needs someone now: stopped, failed.
  • --danger-subtle
    Utility
    bg-danger-subtle
    Light
    #f6e2e1
    Dark
    #321c1c
    Use
    Tint behind danger
  • --neutral
    Utility
    bg-neutral
    Light
    #52525b
    Dark
    #a1a1aa
    Use
    Offline, inactive
  • --neutral-subtle
    Utility
    bg-neutral-subtle
    Light
    #f4f4f5
    Dark
    #1c1c21
    Use
    Tint behind neutral

Emergency stop

  • --stop
    Utility
    bg-stop
    Light
    #dc2626
    Dark
    #dc2626
    Use
    Emergency stop only
  • --stop-deep
    Utility
    bg-stop-deep
    Light
    #991b1b
    Dark
    #7f1d1d
    Use
    Stopped state, sent over Bluetooth

Map and overlays

  • --map
    Utility
    bg-map
    Light
    #f1f2f5
    Dark
    #0d0d10
    Use
    Map surface
  • --map-point
    Utility
    bg-map-point
    Light
    #7b8190
    Dark
    #6f7682
    Use
    Point cloud
  • --float
    Utility
    bg-float
    Light
    rgb(255 255 255 / 0.9)
    Dark
    rgb(32 32 38 / 0.86)
    Use
    Trays over the map
  • --edge
    Utility
    ring-edge
    Light
    rgb(9 9 11 / 0.14)
    Dark
    rgb(255 255 255 / 0.12)
    Use
    Tray outline
  • --scrim
    Utility
    bg-(--scrim)
    Light
    rgb(9 9 11 / 0.45)
    Dark
    rgb(0 0 0 / 0.66)
    Use
    Behind dialogs and sheets

Text on --background: foreground 19.1:1 dark, 17.3:1 light. Full table on the Accessibility page.