Primitive Token vs Semantic Token
A primitive token names a raw value, like one exact blue. A semantic token names a job, like the main brand color, and points to a primitive. Parts should use the semantic one.
Primitive Token
A token for one raw value, like one exact blue. It has no job yet.
A primitive token is a design token that names a raw value, like blue-600 for one exact blue or space-4 for 16 pixels. It says what the value is, not where to use it. Primitives form the full palette of choices. Parts of the interface should not use them directly; they use semantic tokens, which point to primitives.
Semantic Token
A token named for its job, like color-danger. It points to a raw value.
A semantic token is a design token named for its job. One might be the color for text, or the color for danger. It points to a primitive token rather than holding a raw value. Parts on the screen use these tokens. For a dark theme, the team points the same tokens at other raw values. Nothing else has to change.
In one line
- Primitive Token
- A token for one raw value, like one exact blue. It has no job yet.
- Semantic Token
- A token named for its job, like color-danger. It points to a raw value.