Naming
How tokens and keys are named.
The five answers
| Question | Answer | Why |
|---|---|---|
| What gets a name? | Tokens and component keys | Components get their own keys. |
| How many token tiers? | Three | Primitives, semantics and component keys. |
| How are decisions named? | By role | Role names survive a redesign. |
| How are names written? | Lowercase words in paths | Lowercase paths read the same everywhere. |
| What do components read? | Component keys | A component API keeps changes local. |
When to use what
| Situation | Use | Not | Why |
|---|---|---|---|
| A value with no token | The closest semantic token, then ask for a new one | A raw value in the component | A raw value skips the contrast checks every token passed. |