Design, before Any SoftwareLesson 66 of 74

Module 7 · Making the decision once

A token is a decision with a name

In this lesson

  • 8 min read
  • 7 reading sections
  • Knowledge check
  • Lesson 1 of 9 in this chapter

This chapter’s goalConvert a set of one-off screens into named tokens and a small component set, decide for any new element whether it is a variant of something existing or a new thing, specify every state a component can be in, and say at what point a project is large enough for the system to be worth its maintenance cost.

This chapter’s media

The film explains chapter ideas. The audiobook narrates the complete teaching text.

FormatEnglishहिंदी
Chapter filmWatch1:50Not available
Full audiobookNot availableNot available
Two layers, and why the second one mattersPrimitive tokensblue-500, grey-900. Values, andnothing else.Semantic tokenscolour-action, colour-text.Jobs, pointing at primitives.ComponentsRefer only to the semanticlayer, never to a value.A dark theme, a rebrand or a white-label version is then a dozen lines remapping the middle layer.Without it you edit every component, and you will miss some.
A dark theme, a rebrand or a white-label version is then a dozen lines remapping the middle layer. Without it you edit every component, and you will miss some.

Figure 7.1

A little at a time

Explore an idea, try it, then check what stays.

Step 1 of 9Free · no account needed
Lesson steps

The problem a name solves

A value used in forty places is forty opportunities to disagree. Somebody types 23 instead of 24. Somebody uses a slightly different blue because they picked it off a screenshot. Six months later the design contains four greys that were meant to be one, and nobody can change the brand colour without a search that will miss three instances.

A token is a design decision given a name, so that the decision exists in one place and every use refers to it.

CSS
:root {
  --space-4: 1.5rem;
  --colour-action: oklch(0.55 0.18 255);
  --radius-md: 8px;
  --text-lg: 1.25rem;
}

That is the entire mechanism. Everything else in this lesson is about which decisions deserve names and how to structure them.

Your place and first choices stay on this browser. Classroom credit is recorded separately.

Stuck on something?Ask Meher, your AI tutor

How to cite: Addaly (2026) ‘A token is a decision with a name’, in Design, before Any Software. Edited by M. Mun. Addaly. Available at: https://addaly.com/learn/design-foundations/tokens-are-decisions-with-names (Accessed: 21 November 2026).