How We Rebuilt Our Design Tokens

Abstract design gradient artwork

We removed three options and support tickets dropped by a third. Good defaults are the design most users will ever see. Whitespace is not empty; it is doing the grouping for you.

Getting started

Users scan, so headings carry more weight than paragraphs. Consistency is kind, but clarity wins when the two disagree. The prototype answered in a day what the meeting could not in a month.

An error message should blame the system, not the person. Contrast is not a style choice; it is whether people can read the page.

Details

Type scale decisions ripple into every component downstream. Users scan, so headings carry more weight than paragraphs. Contrast is not a style choice; it is whether people can read the page. Labels above fields beat clever placeholders every time.

  • Check contrast early
  • Write the microcopy before the mockup
  • Design the empty and error states
  • Prefer one clear action per screen

Labels above fields beat clever placeholders every time. We tested with five people and found the same problem four times.

A small example

Whitespace is not empty; it is doing the grouping for you. We removed three options and support tickets dropped by a third. The prototype answered in a day what the meeting could not in a month.

Good defaults are the design most users will ever see.

Dark mode is a second palette, not an inverted first one. Users scan, so headings carry more weight than paragraphs.

An error message should blame the system, not the person. Labels above fields beat clever placeholders every time.

Comments

4 responses to “How We Rebuilt Our Design Tokens”

  1. Great write-up. The part about the trade-offs was spot on.

  2. Zoe T. Avatar
    Zoe T.

    I tried this last week and can confirm it works.

  3. I’ve been doing it wrong for years, apparently. Thanks!

  4. I’ve been doing it wrong for years, apparently. Thanks!

Leave a Reply

Your email address will not be published. Required fields are marked *