Skip to main content

Command Palette

Search for a command to run...

Design Tokens: The Bridge Between Design and Code

Updated
2 min read
Design Tokens: The Bridge Between Design and Code
M

Design Engineer | WTM Ambassador

I don't just see design tokens as the bridge between design and code, tokens are the foundation of that bridge, it's the system that makes building the bridge even possible.

The impact of design tokens in the product development today are huge and fundamentally changes how design systems scale and how designers and developers work together. At the core, design tokens are the atomic design decisions of any system, it is made up of the color values, spacing units, typography scales, etc stored as data rather than scattered across stylesheets, code and design files.

This is one of those terms that sound really abstract, but that in itself is exactly where it’s power lies, its abstraction. I like to think of it like this: Instead of hardcoding #3B82F6 throughout my codebase, I define a token like color.primary.500.

This really simple action creates a single source of truth that can be referenced by both designers and developers. If your primary color value needs updating, you simply change one value, and the entire system updates automatically across every platform and implementation.

These are some important things to know about design tokens:

  1. Design tokens follow a clear naming standard, which is based on the 3 types - the Primitive, Semantic and Component tokens.

  2. Based on type of design property, tokens are usually organized into several categories, some major categories are: color tokens, spacing tokens, typography tokens, border tokens, shadow tokens, motion tokens, etc.

  3. Major design systems like Material Design, Shopify’s Polaris , Atlassian Design System rely heavily on tokens

  4. Design tokens are not dependent on languages or plaforms they are used in. Tokens are defined once in a neutral format (usually JSON), then used in any target platform e.g CSS variables, React.js, iOS Swift code, React Native, etc. This means your iOS app, web application, and Android app can all reference the exact same design token, and therefore have the same result, ensuring true cross-platform consistency.

  5. Design tokens were originally created by the Salesforce design system team.

  6. I really do see tokens as a fundamental part of AI-driven design-development workflow.

  7. The W3C is working on standardizing token formats. Check out the community group here

Commits to UX

Part 1 of 3

A bite-sized series on the thinking behind digital products, where design meets engineering. From UX patterns to dev workflows, each post offers a focused take on building thoughtful, user-centered software, one small usability insight at a time.

Up next

Why your animations are making users wait

We all love animations that make a UI feel interactive. But poorly implemented animations can make any UI really slow. The secret to smooth and fast implementations is knowing how to avoid some common mistakes. Some of which are: Transitioning heav...