Colour
A neutral base with purposeful signals
The colour system is based on roles: surface, text, action, accent, signal, and status. Roles adapt to light and dark modes. Choose a role, never a hex value. The build tests every declared text and surface pair against WCAG AA and fails when a required pair does not pass. One brand variant is currently active.
60/30/10
Use roughly 60% neutral surfaces, 30% structure and text, and no more than 10% accent and signal colour. If a page looks more colourful, colour is probably being used as decoration.
Surface: page
--id-color-surface-page
Surface: raised card
--id-color-surface-raised
Surface: sunken area and table header
--id-color-surface-sunken
Text: default
--id-color-text-default
Text: muted
--id-color-text-muted
Action: primary
--id-color-action-primary
Accent: brand role
--id-color-accent-default
Signal: high visibility
--id-color-signal-emphasis
Focus ring
--id-color-focus-ring
color.surface.*color.text.*color.accent.*color.signal.*
One active brand variant
The current system has one active brand variant and one shared accent. Product-line names do not create separate colour palettes. The token structure can support future variants, but a variant must be approved and tested before use.
Accent: brand red
--id-color-red-600
Signal: safety orange
--id-color-hivis-orange-600
color.brand-accent.*tokens/brands/id-identity.json
Signal colour has one job
Use high-visibility orange only when attention has a consequence, such as safety information or a time-sensitive state supplied by approved data. It always carries dark text, never white. Fluorescent yellow-green belongs to graphics, not interface text on light surfaces.
Heading coloured for effect
color.signal.*contrast-pairs: signal-ui-page
Combinations to avoid
Do not use white text on signal colours, accent colour for the primary button, fluorescent yellow-green on a light surface, or status colours as decoration. Text must meet its required contrast. Do not place brand red and danger red side by side in one component.
Dark mode is an equal mode
Dark mode is a complete semantic palette, not a filter. The same declared contrast pairs are tested in both modes. Product cutouts keep their white background so products remain comparable. Use the switch above to review the page.
tokens/semantic.dark.json
Data colours
Use the four series colours in their fixed order: navy, safety orange, teal, and amber. Fold further series into Other using the neutral role. Every chart needs direct value labels and a table view. Status colours are reserved for status and never represent data series.
color.chart.1: navy-600color.chart.2: hivis-orange-600color.chart.3: teal-500color.chart.4: amber-600color.chart.other