Design tokens are only useful when the people building the product can find the right one in a few seconds. I keep every set small and named by role, not by colour.

Name by role

A token called ink or surface survives a rebrand. A token called dark-grey-2 does not. Roles also make dark mode a matter of swapping values instead of renaming everything.

My starter set

  • Six colour roles plus one accent
  • A type scale with six steps
  • Spacing in steps of four
  • Two radii and one shadow