Colour-system

Preview#

The explorer groups every public colour token by its system role. The shared anchor index moves between groups, and the shared filter row narrows the visible collection without reloading the page. Each swatch opens a native dialog with generated implementation and contrast evidence. Wrap the shortcode in theme-preview when readers need to compare the scoped light and dark collections.

Interface roles

8

Token details

Primary text

Primary text colour for high-contrast interface and brand copy.

Layer
Semantic
Token
color.ink
CSS variable
--color-ink
Source declaration
{color.palette.near-black}
Light value
#101010
Dark value
#f8f8f5
Approved foreground
color.paper

WCAG 2.2 contrast evidence

Light 17.88:1 WCAG AA normal text
Dark 17.88:1 WCAG AA normal text

Token details

Reading surface

Default page background colour.

Layer
Semantic
Token
color.paper
CSS variable
--color-paper
Source declaration
{color.palette.warm-paper}
Light value
#f8f8f5
Dark value
#101010
Approved foreground
color.ink

WCAG 2.2 contrast evidence

Light 17.88:1 WCAG AA normal text
Dark 17.88:1 WCAG AA normal text

Token details

Quiet divider

Quiet divider and border colour.

Layer
Semantic
Token
color.line
CSS variable
--color-line
Source declaration
{color.palette.quiet-line}
Light value
#d7d7d2
Dark value
oklch(37.1% 0 none)
Approved foreground
color.ink

WCAG 2.2 contrast evidence

Light 13.17:1 WCAG AA normal text
Dark 9.76:1 WCAG AA normal text

Token details

Accent

Primary accent colour for emphasis, active states, and brand signals.

Layer
Semantic
Token
color.accent
CSS variable
--color-accent
Source declaration
{color.palette.signal-orange}
Light value
#e6461a
Dark value
#e6461a
Approved foreground
color.palette.near-black

WCAG 2.2 contrast evidence

Light 4.76:1 WCAG AA normal text
Dark 4.76:1 WCAG AA normal text

Token details

Accent text

Theme-aware accent colour for normal-sized text on the page surface.

Layer
Semantic
Token
color.accent-text
CSS variable
--color-accent-text
Source declaration
{color.palette.deep-signal-orange}
Light value
#c43810
Dark value
#e6461a
Approved foreground
color.paper

WCAG 2.2 contrast evidence

Light 5.03:1 WCAG AA normal text
Dark 4.76:1 WCAG AA normal text

Token details

On accent

Accessible foreground colour for text and icons on the accent background.

Layer
Semantic
Token
color.on-accent
CSS variable
--color-on-accent
Source declaration
{color.palette.near-black}
Light value
#101010
Dark value
#101010
Approved foreground
color.accent

WCAG 2.2 contrast evidence

Light 4.76:1 WCAG AA normal text
Dark 4.76:1 WCAG AA normal text

Token details

White

White used for inverse text and elevated surfaces.

Layer
Semantic
Token
color.white
CSS variable
--color-white
Source declaration
{color.palette.white}
Light value
#ffffff
Dark value
#ffffff
Approved foreground
color.palette.near-black

WCAG 2.2 contrast evidence

Light 19.03:1 WCAG AA normal text
Dark 19.03:1 WCAG AA normal text

Token details

Black

Black used for overlays and high-contrast code controls.

Layer
Semantic
Token
color.black
CSS variable
--color-black
Source declaration
{color.palette.black}
Light value
#000000
Dark value
#000000
Approved foreground
color.palette.warm-paper

WCAG 2.2 contrast evidence

Light 19.74:1 WCAG AA normal text
Dark 19.74:1 WCAG AA normal text

Neutral scale

8

Token details

color.neutral.50

Lightest neutral surface.

Layer
Semantic
Token
color.neutral.50
CSS variable
--color-neutral-50
Source declaration
{color.palette.neutral.50}
Light value
oklch(98.5% 0 none)
Dark value
oklch(26.9% 0 none)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.neutral.100

Light neutral surface.

Layer
Semantic
Token
color.neutral.100
CSS variable
--color-neutral-100
Source declaration
{color.palette.neutral.100}
Light value
oklch(97% 0 none)
Dark value
oklch(37.1% 0 none)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.neutral.300

Quiet neutral marker and divider tone.

Layer
Semantic
Token
color.neutral.300
CSS variable
--color-neutral-300
Source declaration
{color.palette.neutral.300}
Light value
oklch(87% 0 none)
Dark value
oklch(43.9% 0 none)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.neutral.400

Secondary neutral text tone.

Layer
Semantic
Token
color.neutral.400
CSS variable
--color-neutral-400
Source declaration
{color.palette.neutral.400}
Light value
oklch(70.8% 0 none)
Dark value
oklch(55.6% 0 none)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.neutral.500

Muted neutral text tone.

Layer
Semantic
Token
color.neutral.500
CSS variable
--color-neutral-500
Source declaration
{color.palette.neutral.500}
Light value
oklch(55.6% 0 none)
Dark value
oklch(70.8% 0 none)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.neutral.600

Supporting neutral text tone.

Layer
Semantic
Token
color.neutral.600
CSS variable
--color-neutral-600
Source declaration
{color.palette.neutral.600}
Light value
oklch(43.9% 0 none)
Dark value
oklch(87% 0 none)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.neutral.700

Strong neutral text and border tone.

Layer
Semantic
Token
color.neutral.700
CSS variable
--color-neutral-700
Source declaration
{color.palette.neutral.700}
Light value
oklch(37.1% 0 none)
Dark value
oklch(97% 0 none)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.neutral.800

Dark neutral surface.

Layer
Semantic
Token
color.neutral.800
CSS variable
--color-neutral-800
Source declaration
{color.palette.neutral.800}
Light value
oklch(26.9% 0 none)
Dark value
oklch(98.5% 0 none)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Status colours

6

Token details

status.note

Informational status accent for notes and neutral change notices.

Layer
Semantic
Token
status.note
CSS variable
--status-note
Source declaration
oklch(62.3% 0.214 259.815)
Light value
oklch(62.3% 0.214 259.815)
Dark value
oklch(62.3% 0.214 259.815)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

status.success

Positive status accent for confirmed or newly available items.

Layer
Semantic
Token
status.success
CSS variable
--status-success
Source declaration
oklch(72.3% 0.219 149.579)
Light value
oklch(72.3% 0.219 149.579)
Dark value
oklch(72.3% 0.219 149.579)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

status.important

Important status accent for decisions requiring attention.

Layer
Semantic
Token
status.important
CSS variable
--status-important
Source declaration
oklch(62.7% 0.265 303.9)
Light value
oklch(62.7% 0.265 303.9)
Dark value
oklch(62.7% 0.265 303.9)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

status.warning

Warning status accent for cautionary changes or constraints.

Layer
Semantic
Token
status.warning
CSS variable
--status-warning
Source declaration
oklch(76.9% 0.188 70.08)
Light value
oklch(76.9% 0.188 70.08)
Dark value
oklch(76.9% 0.188 70.08)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

status.danger

Critical status accent for cautions, errors, and deprecations.

Layer
Semantic
Token
status.danger
CSS variable
--status-danger
Source declaration
oklch(63.7% 0.237 25.331)
Light value
oklch(63.7% 0.237 25.331)
Dark value
oklch(63.7% 0.237 25.331)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

status.archived

Muted status accent for archived material.

Layer
Semantic
Token
status.archived
CSS variable
--status-archived
Source declaration
{color.neutral.500}
Light value
oklch(55.6% 0 none)
Dark value
oklch(55.6% 0 none)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Code colours

6

Token details

color.code.background

Background colour for technical code surfaces.

Layer
Semantic
Token
color.code.background
CSS variable
--color-code-background
Source declaration
#272822
Light value
#272822
Dark value
#272822
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.code.foreground

Foreground colour for technical code surfaces.

Layer
Semantic
Token
color.code.foreground
CSS variable
--color-code-foreground
Source declaration
#f8f8f2
Light value
#f8f8f2
Dark value
#f8f8f2
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.code.copy.success.foreground

Copy-control confirmation text colour.

Layer
Semantic
Token
color.code.copy.success.foreground
CSS variable
--color-code-copy-success-foreground
Source declaration
oklch(87.1% 0.15 154.449)
Light value
oklch(87.1% 0.15 154.449)
Dark value
oklch(87.1% 0.15 154.449)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.code.copy.success.border

Copy-control confirmation border colour.

Layer
Semantic
Token
color.code.copy.success.border
CSS variable
--color-code-copy-success-border
Source declaration
oklch(79.2% 0.209 151.711)
Light value
oklch(79.2% 0.209 151.711)
Dark value
oklch(79.2% 0.209 151.711)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.code.copy.error.foreground

Copy-control error text colour.

Layer
Semantic
Token
color.code.copy.error.foreground
CSS variable
--color-code-copy-error-foreground
Source declaration
oklch(80.8% 0.114 19.571)
Light value
oklch(80.8% 0.114 19.571)
Dark value
oklch(80.8% 0.114 19.571)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

color.code.copy.error.border

Copy-control error border colour.

Layer
Semantic
Token
color.code.copy.error.border
CSS variable
--color-code-copy-error-border
Source declaration
oklch(70.4% 0.191 22.216)
Light value
oklch(70.4% 0.191 22.216)
Dark value
oklch(70.4% 0.191 22.216)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Component aliases

11

Token details

component.announcement.background

Background surface for the site-wide announcement banner.

Layer
Component
Token
component.announcement.background
CSS variable
--component-announcement-background
Source declaration
{color.paper}
Light value
#f8f8f5
Dark value
#f8f8f5
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

component.announcement.foreground

Text colour for the site-wide announcement banner.

Layer
Component
Token
component.announcement.foreground
CSS variable
--component-announcement-foreground
Source declaration
{color.ink}
Light value
#101010
Dark value
#101010
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

component.announcement.border

Signal border colour for the site-wide announcement banner.

Layer
Component
Token
component.announcement.border
CSS variable
--component-announcement-border
Source declaration
{color.accent}
Light value
#e6461a
Dark value
#e6461a
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

Layer
Component
Token
component.announcement.link
CSS variable
--component-announcement-link
Source declaration
{color.accent-text}
Light value
#c43810
Dark value
#c43810
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

component.avatar.background

Fallback avatar surface for a recommendation attribution.

Layer
Component
Token
component.avatar.background
CSS variable
--component-avatar-background
Source declaration
{color.neutral.100}
Light value
oklch(97% 0 none)
Dark value
oklch(97% 0 none)
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

component.avatar.foreground

Fallback avatar initials colour for a recommendation attribution.

Layer
Component
Token
component.avatar.foreground
CSS variable
--component-avatar-foreground
Source declaration
{color.ink}
Light value
#101010
Dark value
#101010
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

component.avatar.border

Avatar boundary colour for a recommendation attribution.

Layer
Component
Token
component.avatar.border
CSS variable
--component-avatar-border
Source declaration
{color.line}
Light value
#d7d7d2
Dark value
#d7d7d2
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

component.back-to-top.background

Surface behind the back-to-top link.

Layer
Component
Token
component.back-to-top.background
CSS variable
--component-back-to-top-background
Source declaration
{color.paper}
Light value
#f8f8f5
Dark value
#f8f8f5
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

component.back-to-top.foreground

Text and arrow colour for the back-to-top link.

Layer
Component
Token
component.back-to-top.foreground
CSS variable
--component-back-to-top-foreground
Source declaration
{color.ink}
Light value
#101010
Dark value
#101010
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

component.back-to-top.border

Resting border of the back-to-top link.

Layer
Component
Token
component.back-to-top.border
CSS variable
--component-back-to-top-border
Source declaration
{color.line}
Light value
#d7d7d2
Dark value
#d7d7d2
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

component.back-to-top.hover-border

Hover and focus border of the back-to-top link.

Layer
Component
Token
component.back-to-top.hover-border
CSS variable
--component-back-to-top-hover-border
Source declaration
{color.accent}
Light value
#e6461a
Dark value
#e6461a
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Diagram outputs

5

Token details

diagram.canvas

Canvas background for diagrams across supported authoring tools.

Layer
Component
Token
diagram.canvas
CSS variable
--diagram-canvas
Source declaration
{color.paper}
Light value
#f8f8f5
Dark value
#f8f8f5
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

diagram.node

Default diagram node surface.

Layer
Component
Token
diagram.node
CSS variable
--diagram-node
Source declaration
{color.paper}
Light value
#f8f8f5
Dark value
#f8f8f5
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

diagram.node-ink

Default diagram node label colour.

Layer
Component
Token
diagram.node-ink
CSS variable
--diagram-node-ink
Source declaration
{color.ink}
Light value
#101010
Dark value
#101010
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

diagram.node-line

Default diagram node border and connector colour.

Layer
Component
Token
diagram.node-line
CSS variable
--diagram-node-line
Source declaration
{color.line}
Light value
#d7d7d2
Dark value
#d7d7d2
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Token details

diagram.accent

Diagram emphasis and active-flow colour.

Layer
Component
Token
diagram.accent
CSS variable
--diagram-accent
Source declaration
{color.accent}
Light value
#e6461a
Dark value
#e6461a
Approved foreground
Not declared

This token has no declared foreground pairing, so the explorer does not claim a text-contrast result.

Boundary#

The shortcode reads generated token data and does not accept arbitrary colour values. Add or change a governed token in tokens/core.tokens.json or a theme collection, regenerate the outputs, and let the explorer follow the source.

Example

{{< colour-system >}}

When to use

A filterable explorer for public colour tokens, theme values, aliases, and declared WCAG evidence.

Implementation

layouts/shortcodes/colour-system.html

Options

OptionRead by the shortcode template
colourSystemInstanceRead by the shortcode template

Interface manifest

Kind
Shortcode
Category
Data
Status
Implemented
Implementation
Partial:layouts/partials/data-page/anchor-index.htmllayouts/partials/data-page/filter-row.htmlShortcode:layouts/shortcodes/colour-system.htmlData:data/brand/tokens.ymlCSS:assets/css/generated/themes.cssassets/css/site.cssJavaScript:assets/js/site.js