Skip to content
flyingsalmon

Colours

An orange brand over a beige page, with white cards and fields, orange borders, and neutral grey text.

Colour comes in two layers. The palette layer is Tailwind’s OKLCH palette: greys from neutral (chroma 0), the brand from orange, destructive and error from red, success from green, warning from amber. The functional layer gives each job a token that points at one palette step, as --primary: var(--color-orange-600). Components use the functional tokens and never the palette steps behind them, so a change of step happens in one place.

Every colour is a palette step. There is no colour alpha anywhere, so no /50 modifiers and no color-mix. A hover or press shade steps along the ramp, as orange-200 to orange-300. Opacity on a whole element, for a disabled state or a fade, is fine because it fades the element and does not define a colour. The system is light only.

Tokens

Surfaces

Surfaces separate by background step and solid border, never by shadow.

SampleTokenValueJob
--backgroundorange-50The page. Everything else sits on it.
--cardwhiteCards, alerts, and field boxes: input, textarea, select, combobox, date picker, number field.
--popoverwhiteFloating surfaces: menus, select lists, the date picker panel, dialogs, drawers.
--mutedorange-100A quiet background step: a read-only field, the number field spin button, the empty state icon tile.
--secondaryorange-100The secondary button and badge, an unpressed toggle group chip, the avatar group overflow count.
--accentorange-200Hover and highlight: a ghost button under the pointer, the highlighted menu row, a calendar day under the pointer.

Text

Text is neutral grey on every surface.

SampleTokenValueJob
--foregroundneutral-950Body text, headings, values, and the tooltip fill. --card-foreground and --popover-foreground take the same step.
--muted-foregroundneutral-600Descriptions, placeholders, helper text, and field icons.
--secondary-foregroundneutral-900Text on --secondary.
--accent-foregroundneutral-900Text on --accent.
--primary-textorange-700Orange as text: the date picker focused segment, the notice subject on hover.

Orange

Orange has three jobs. --primary is a fill under text, --indicator is a mark on a surface (a fill, a bar, a ring, an underline), and --primary-text is orange as text. The first two share orange-600 but name different jobs, so a mark and a fill can move apart without touching each other’s consumers.

SampleTokenValueJob
--primaryorange-600An orange fill under text: the default button, the default badge, the pressed toggle group chip.
--primary-foregroundwhiteText on --primary.
--indicatororange-600Every orange mark on a surface: checked fills, active bars, field focus rings, the text link underline, the progress fill.
--indicator-foregroundwhiteA glyph on --indicator: the checkbox tick, the radio dot, the switch thumb, the selected calendar numeral.

Borders and rings

Borders are decorative. Rings are how focus shows, so a ring has to stand out against the page.

SampleTokenValueJob
--borderorange-200Every surface border and divider.
--inputorange-200Field box borders at rest. They step to orange-300 on hover.
--ringneutral-950The default focus ring, for anything that does not ring in its own hue.

Status

Each status ships as a fill and a text colour that reads on it. Error does not reuse --destructive, because a tint cannot come from a solid without alpha.

SampleTokenValueJob
--successgreen-100, text green-800A success fill, with --success-foreground on it.
--warningamber-400, text amber-900A solid warning fill, with --warning-foreground on it.
--errorred-100, text red-700An error fill, with --error-foreground on it. The destructive button fills with this.
--destructivered-600An invalid field: error text, the required asterisk, borders, focus rings, and a checked invalid checkbox or radio. Also the destructive menu item text.

Loading

Placeholders and tracks sit two steps above the page on the orange ramp.

SampleTokenValueJob
--skeletonorange-200Skeleton blocks.
--progress-trackorange-200The progress and stepper track.
--progress-fillorange-600The progress and stepper fill, an alias of --indicator.

Charts

The brand leads, then four pale hues. A chart that needs a status colour takes --success directly.

SampleTokenValueJob
--chart-1orange-500The first series. The brand leads.
--chart-2sky-300The second series.
--chart-3violet-300The third series.
--chart-4teal-300The fourth series.
--chart-5pink-300The fifth series.

Group colours

Six hues tell items in a set apart: the stays of a trip, avatar fallbacks, labels. Each hue has six tokens. --group-<hue> is the solid fill with -foreground text, -soft is a tint with -soft-foreground text, and -border steps to -border-hover.

skysoftborder
pinksoftborder
tealsoftborder
fuchsiasoftborder
cyansoftborder
bluesoftborder

Assign hues by index in this order: cyan sits close to sky and fuchsia close to pink, and this order keeps each lookalike pair three places apart.

Usage rules

  • Do
    Choose a colour by its job: orange for the main action, red for loss, grey for supporting text.A colour then means the same thing on every screen, so a reader learns it once.
  • Do
    Put white on every orange fill.Dark text on orange reads muddy. White is the one pairing that keeps the brand vivid.
  • Do
    Deepen a colour one step for hover and another for press.The control stays recognisably the same colour, and each state reads as a little more pressed.
  • Don’t
    Make a colour see-through to get a lighter tint.A see-through colour takes on whatever is behind it, so the same tint looks different on each surface.
  • Don’t
    Let a group colour work alone.The set leaves out every hue near the brand or a status, so a group never reads as an action or a result. Always pair the colour with a text label.
  • Don’t
    Design a dark version of a screen.The system is light only: orange on a warm beige page is its identity, and there is no dark theme for a screen to join.

  • Principles

    Why the system is flat, light, and palette only.
  • Accessibility

    The contrast method and the cases below AA.
  • Button

    The primary fill, white text, and the focus ring.