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.

Example data: 3 in stock
Do: use dark text and reserve the signal for a real consequence
Summer offer

Heading coloured for effect

Don't: use signal colour as campaign decoration or body text

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.

Do: use the primary action role for the main action
Don't: use the accent as the default action colour

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