Augment

Design Tokens Explained: Color, Type, and Spacing at Scale

Tokens are the smallest unit of a design system: named values that design and code both use. They make change safe.

Printed color swatches and palette samples laid out on a desk
Photo by Balázs Kétyi on Unsplash, with an Augment halftone treatment
Executive Summary

Key Takeaways

  • A token is a named design decision, such as color.text.primary, instead of a raw value like #111111.
  • Use layers: raw values, semantic roles, and component-level tokens.
  • A standard format now exists: the W3C Design Tokens Community Group published its first stable version in October 2025.
  • Tokens make theming, dark mode, and rebrands a configuration change instead of a rewrite.

From values to names

Instead of using #FACB2E in forty places, you define a token like color.brand.accent and use that name everywhere. When the accent changes, you update one value. Designers see the name in their tools and developers see it in code.

Three layers

LayerExamplePurpose
Primitivegold-500 = #FACB2EThe raw palette and scales
Semanticcolor.action.primary = gold-500The role a value plays in the interface
Componentbutton.primary.background = color.action.primaryA specific part of the UI

Most teams get the biggest benefit from the semantic layer. It is what lets you swap a theme by pointing roles at different primitives.

What to turn into tokens

  • Color: brand, text, background, border, status.
  • Typography: families, sizes, weights, line heights.
  • Spacing: a scale such as 4, 8, 12, 16, 24, 32.
  • Radius, border width, and shadow.
  • Motion: durations and easing curves.

A standard format

The Design Tokens Community Group, a W3C community group, released the first stable version of its Design Tokens Format Module (2025.10) in October 2025. It defines a JSON format so that tools can exchange tokens. Tools such as Style Dictionary, Tokens Studio, and Terrazzo support it. Note that this is a Community Group report, not a W3C Recommendation, but it gives teams a shared target.

Put tokens to work

1

Define

Name tokens in one source of truth, in design tools or in JSON.

2

Transform

Use a build tool like Style Dictionary to output CSS variables, iOS, and Android values.

3

Consume

Components reference tokens, never raw values.

4

Govern

Review new tokens and remove unused ones.

Frequently Asked Questions

A named value for a design decision, such as a color, size, or spacing, shared by design tools and code.

Sources and further reading

  1. Design Tokens Format Module (2025.10)Design Tokens Community Group · Published · Accessed
  2. Style DictionaryAmazon / open source · Undated page · Accessed
  3. Atomic DesignBrad Frost · Undated page · Accessed

Credits

  • Written by Augment Editorial Team, Product design and engineering, Augment Lab.
  • Cover photo Photo by Balázs Kétyi on Unsplash, with an Augment halftone treatment, used under the Unsplash License.
  • Research Statistics and standards are cited from the sources above. Always check the original page for the latest version.

Augment Product Design

Ready to make your product clearer?

From first concept to go-live, we turn complex product ideas into clear, useful experiences.

Design Tokens Explained: Color, Type, and Spacing at Scale | Augment. Lab