Design systems

Tokens that survive handoff

A name, a value, and a check. Thirty minutes.

Christoph Hellmuth ยท Design Engineering Studio

The point

A hex nobody opens is not a system.

The value can be right and the contract can still be missing.

Color charts from the 1915 Munsell atlas, steps of hue laid out and named.

A chip without a name is only paint.

Three layers

Paint, decision, part.

  1. 01
    Primitive

    The scale. Indigo, space, type sizes. Rarely used raw in a screen.

  2. 02
    Semantic

    The decision. Action, danger, surface, focus. This is what product design reaches for.

  3. 03
    Component

    The part. Button background, field border. It points at a decision, not at a hex.

Primitive

The scale is not the interface.

Keep the ramp. Do not let screens shop from it.

Semantic

Name the decision, not the hue.

Action, danger, surface, focus. The hex is a detail under the name.

Component

The part points at the decision.

Button background is color action. It is not a new blue.

A page from an 1884 printer's sample book, with a style number beside the mix.

Style number, then the mix.

A distinction

The brand color is not the action color.

BrandWho you are

The indigo, the paper, the mark. It can be rare on a product screen.

ActionWhat moves the task

One role, checked for contrast, used when the person should act.

Theme

Dark mode is a second map.

Same names. New values. Checked, not inverted.

A 1962 short-form periodic table, each element in a labeled cell.

Every element has an address.

Part two

Two sources, one contract

The file and the repo. Checked, not mythologized.

The myth

One source of truth is usually a drawer.

A JSON nobody opens is not governance. A diff is.

The contract

What has to match.

  1. 01
    The names

    Color action in the file is color action in the repo. No translation layer in someone's head.

  2. 02
    The maps

    Light and dark, or whatever themes you ship. Both sides, both maps.

  3. 03
    The parts

    Shared components point at the same decisions. States included.

  4. 04
    The check

    A failing diff when they disagree. Not a reminder in a calendar.

A woman punching cards at a pantograph, a stack of the same cards in her hand, around 1940.

One card. One record.

One change

Follow a token through the door.

  1. 1
    A reason

    Contrast, a theme, a real screen. Not a mood.

  2. 2
    The name

    Change the decision, or add one, with a sentence beside it.

  3. 3
    Both maps

    If you ship dark, update dark in the same change.

  4. 4
    The part and the check

    The component that uses it, and a diff that would have caught a miss.

A row of punched cards used by a Jacquard loom, the pattern stored as holes.

Holes in a row. A pattern you can file.

Tools

The model does not name the system.

It can draft. You accept the name, the map, and the diff.

Part three

A week you can run

No new platform. One theme, one component, one check.

Monday to Friday

Name, alias, check.

  1. Mon
    List the decisions

    From one real flow. Action, danger, surface, text, focus. Ignore the rest of the product.

  2. Wed
    Point the parts

    One button, one field. Component tokens alias the decisions. Both themes if you ship them.

  3. Fri
    Fail the diff

    Same names in the file and the repo. A check that goes red when a value drifts.

A person opening a labeled card catalog drawer to read a card.

Open the drawer. Read the card.

Failure modes

How token projects go quiet.

  1. 01
    Names nobody says

    Color interactive primary default on brand. The review cannot speak it.

  2. 02
    A ramp with no roles

    Screens shop the scale. The theme cannot be remapped.

  3. 03
    Sync as a person

    One designer exports on Fridays. Then they take a holiday.

  4. 04
    Component hex in disguise

    The token exists, and the screen overrides it.

Honest next steps

Pick one flow. Name its decisions.

Leave with a list of roles, not a new library ticket.

Design Engineering Studio

Name the role. Then point the hex.

The check is the rest of the craft.

christophhellmuth.com

Questions

Which name do you not have yet?

Action, danger, surface, focus. Or the check that would catch a drift.