Design system

Configuration and White Label

A tenant is a set of values, not a fork. Every surface draws from the same tokens: the admin portal, the client portal, statements and documents. Rebranding means publishing a different set of values, which is why it takes an afternoon rather than a release.

131 components43 colour tokens265 flags

Try it on this page.

Four real packs. Choosing one applies its five values to the screen below and lists them beside it as they change. Every control in that screen is the same component you would get: the primary action, the selected nav item, the status badges, the meter and the selected row all resolve to the pack rather than to anything written for this page.

LiveBone packAdmin portal
NorthwindMoneyClientsReporting
Safeguarded against the requirementMet, with a buffer
CounterpartyAccountAmountStatus
Hanseatic Werke GmbHDE893000-48,250.00EURSettled
Northwind Trading LtdGB296819126,400.00GBPSettled
Van Dijk Logistiek BVNL914300-9,120.55EURSubmitted

The pack, in full

--accent
#efe7d7
--accent-hover
#f9f3e6
--accent-ink
#131210
--accent-wash
#efe7d714
--accent-edge
#efe7d74d

Five values. Everything else on the screen is the grey ladder, which does not change per tenant because contrast ratios are not a branding decision.

What a pack actually is.

Five values. Everything else in the system is derived from the grey ladder, which does not change per tenant because contrast ratios are not a branding decision.

TokenWhat it controls
--accentThe one colour a tenant owns. Primary actions, the live mark, a selected row.
--accent-hoverIts hover state, lightened rather than recoloured.
--accent-inkWhat goes on top of the accent.Supplied rather than computed, because a readable foreground is the thing most theming systems get wrong on a mid-tone brand colour.
--accent-washThe accent at low alpha, for a selected or flagged row.
--accent-edgeThe accent at mid alpha, for a border that needs to belong to it.

Restraint is part of the system.

At most two accent-carrying elements in a view. An interface that accents everything has accented nothing, and in a product where one of those elements might be a shortfall alert, that matters more than it does on a marketing site.

Status is carried by words with tones separated by lightness as well as hue, so the pair that actually fails under deuteranopia is the pair furthest apart in value. There are no coloured dots.

  • Contrast is checked against the real rendered surfaces, including the alpha compositing, rather than against the token values on paper.
  • Amounts never carry a currency symbol. The code, always, because the pound sign is several currencies and a symbol in a multi-currency book is a guess.
  • Statuses use the database’s own vocabulary. Only the casing belongs to the design system.
  • Masked digits are drawn as a bar rather than spelled with a run of dots.

What a tenant cannot break.

A theming system that lets a brand colour make text unreadable is a theming system that will. These hold whatever values a pack supplies.

  • Contrast is checked against the rendered surfaces, including alpha compositing, rather than against the token values on paper.
  • Status is carried by words, with tones separated by lightness as well as hue, so the pair that fails under deuteranopia is the pair furthest apart in value.
  • At most two accent-carrying elements in a view. An interface that accents everything has accented nothing, and here one of them might be a shortfall alert.
  • Amounts never carry a currency symbol. The code, always, because the pound sign is several currencies and a symbol in a multi-currency book is a guess.

Send us your brand guidelines.

We will build the pack before the call and show you your own product rather than ours.