Skip to content

Colour ​

Colour is quiet by default. Most of the interface is ink neutrals; primary (Tidewater) marks what you can act on; signal points at the one thing that matters; success and danger report state. Charts have their own scales in Data visualisation.

The ramps ​

Every ramp has eleven steps, from 50 (lightest) to 950 (darkest). Steps are defined in OKLCH, so equal steps look equally different, and the lightness curve is shared, which keeps contrast predictable: a -600 text on a -50 background behaves similarly in every ramp.

The tokens in src/lib/styles/brand-tokens.css are the source. The hex values below, the swatches and the chart colours in code are converted from them: npm run brand:palette (in ex-accell-ui) regenerates the docs palette, and a unit test fails if any copy drifts from the tokens.

Ink ​

Neutrals with a slight cool blue lean. Text, surfaces, borders and anything that is not a call to action.

ink
50#f8fafd
100#f1f4f8
200#e3e8ee
300#cfd5de
400#98a2ae
500#667384
600#485567
700#344253
800#1e2938
900#0f1926
950#020712
Step50100200300400500600700800900950
Hex#f8fafd#f1f4f8#e3e8ee#cfd5de#98a2ae#667384#485567#344253#1e2938#0f1926#020712

Primary: Tidewater ​

The brand colour. Links, buttons, selection, focus, active navigation, and the logo.

primary
50#edf9fd
100#d6f1f8
200#b2e5f2
300#85d2e5
400#46b5ce
500#0097b1
600#007b95
700#006278
800#004d5e
900#003846
950#00222b
Step50100200300400500600700800900950
Hex#edf9fd#d6f1f8#b2e5f2#85d2e5#46b5ce#0097b1#007b95#006278#004d5e#003846#00222b

Signal ​

Amber, for highlights and evidence marks (the needle tip, a keyword highlight, a "new" marker). It is a fill colour. Never set text in signal on white: it does not reach contrast.

signal
50#fff9ec
100#ffefd1
200#ffdea0
300#ffc96a
400#f4af2d
500#de9800
600#b87b00
700#936000
800#704a00
900#523700
950#312003
Step50100200300400500600700800900950
Hex#fff9ec#ffefd1#ffdea0#ffc96a#f4af2d#de9800#b87b00#936000#704a00#523700#312003

Success ​

Confirmations and healthy states. Not used for positive sentiment.

success
50#effaf4
100#dbf2e4
200#bce7ce
300#96d5b2
400#68b88f
500#3f9a6f
600#247e56
700#116543
800#0c4f33
900#073a25
950#012415
Step50100200300400500600700800900950
Hex#effaf4#dbf2e4#bce7ce#96d5b2#68b88f#3f9a6f#247e56#116543#0c4f33#073a25#012415

Danger ​

Errors and destructive actions only. Not used for negative sentiment.

danger
50#fff3f2
100#ffe4e0
200#ffccc6
300#feaba1
400#f9786c
500#e6443d
600#c51e21
700#a20711
800#80070d
900#5f0608
950#3c0405
Step50100200300400500600700800900950
Hex#fff3f2#ffe4e0#ffccc6#feaba1#f9786c#e6443d#c51e21#a20711#80070d#5f0608#3c0405

Roles ​

Components should reach for a role before a raw step. Roles flip between light and dark themes; the ramps stay put.

RoleLightDarkUse
--se-bgink 50ink 950Page background
--se-surfacewhiteink 900Cards, panels, menus
--se-surface-sunkenink 100ink 950Wells, table headers
--se-borderink 200ink 800Dividers, card edges
--se-border-strongink 300ink 700Inputs, emphasised edges
--se-textink 900ink 100Body text
--se-text-mutedink 500ink 400Secondary text, captions
--se-linkprimary 700primary 300Links
--se-actionprimary 600primary 500Primary buttons, selected states
--se-focusprimary 500primary 400Focus ring
--se-highlightsignal 200signal 700Evidence and keyword highlight

Accessible pairings ​

These pairings meet WCAG 2.2 AA for normal text (4.5:1) unless stated. Contrast was calculated from the hex values above.

ForegroundBackgroundRatioUse
ink 900 #0f1926white17.7:1Body text
ink 700 #344253white10.2:1Strong secondary text
ink 500 #667384white4.8:1Secondary text, captions (the lightest text allowed)
whiteprimary 600 #007b954.9:1Primary button label
primary 700 #006278white7.0:1Links
primary 300 #85d2e5ink 90010.4:1Links and marks on dark
ink 200 #e3e8eeink 90014.4:1Body text on dark
danger 600 #c51e21white5.9:1Error text
success 700 #116543white7.1:1Success text
ink 900signal 500 #de98007.2:1Text on a signal fill
primary 500 #0097b1white3.5:1Large text and UI components only (3:1)
signal 500 / 600white2.4 / 3.6Never as text. Fill only

Usage guidance ​

  • Proportion. Roughly: ink 85 percent, primary 12 percent, signal under 2 percent, state colours as needed.
  • One primary action per view gets the filled primary button.
  • Signal is scarce. If everything is highlighted, nothing is. Use it once per view.
  • State is never colour alone. Pair success, danger and status colours with an icon or a word.
  • Do not use danger for sentiment or success for positive sentiment. See the sentiment scale.
Do

Use primary-600 for the main button and primary-700 for links on white.

Do

Use ink 200 borders to separate cards; let space and borders do the work before shadows.

Don't

Put signal-coloured text on a white background, or use it for charts as the only distinguishing colour.

Don't

Introduce a new hue for a single feature. If a role is missing, propose it here first.

In code ​

svelte
<button class="bg-primary-600 hover:bg-primary-700 text-white rounded-md px-4 py-2">Save</button>
<p class="text-ink-500">Updated 3 minutes ago</p>
<span class="bg-signal-200 text-ink-900">tram</span>

Tailwind's default names are mapped for compatibility: gray, slate, zinc, neutral, stone to ink; blue, sky, cyan, teal, indigo, violet, purple, fuchsia, pink to primary; green, emerald, lime to success; red, rose to danger; orange, amber, yellow to signal. Several families now share a ramp, so never use them to tell categories apart: use the categorical colours or a label. New code should use the brand names.

Released under the Apache License 2.0.