Global/Primitive Tokens

Global tokens, also called primitive tokens, are the raw, uncontextual design values that form the foundation of a Design System — blue-500, space-16, font-family-sans. They exist before any semantic meaning is layered on top.

Think of them as the palette. A primitive token describes a value with no opinion about its use: it's a colour, a size, a duration. When you need to tell a design tool or code generator "what raw materials are available," you're defining primitives. The next tier up, semantic tokens, assigns each primitive a purpose (blue-500 becomes color-action-primary).

Most design teams organize primitives by category — color, spacing, typography, motion — and often by scale. A colour palette might go blue-50, blue-100 through blue-900; spacing might be space-4, space-8, space-16. Some tools (Tokens Studio, Style Dictionary) call these the "base" or "option set" before aliases take over.

The discipline of primitive tokens matters: if you hard-code #3A7FFF in a component, you've lost the single source of truth. If everything flows through a named primitive, a rebrand is a token file edit, not a code hunt.

Related: Design tokens · Semantic tokens · Alias tokens · Token tiers · Theming