MinhVo

Minh Vo

rss feed

Slaying code & making it lit fr fr 🔥 tagline

Hey there 👋 I'm an AI Engineer with 7 years of experience building scalable web and mobile applications. Currently at Neurond AI (May 2025 — present), architecting an Enterprise AI Assistant Platform with multi-tenant RAG on pgvector, multi-provider LLM orchestration, and Azure-native infrastructure. Previously spent 5+ years at SNAPTEC (Sep 2019 — Apr 2025), leading SaaS themes, admin dashboards, and e-commerce platforms — earned the Hero of the Year award in 2021. I specialize in TypeScript, React, Next.js, and AI-Native engineering with Claude Code and Cursor.bio

Back to blogs

Design Tokens and Design Systems at Scale

Design tokens for scalable design systems. Token architecture, Style Dictionary, Figma integration, multi-brand theming.

design tokensdesign systemsStyle DictionaryFigmafrontendtheming

By MinhVo

Introduction

Design tokens are atomic values of a design system stored as platform-agnostic data. Unlike CSS variables, they are authored once and transformed for every platform. A token changes from a hex value to a semantic name like color.primary.action. The W3C Design Tokens specification standardizes the JSON structure. Companies like Salesforce, Shopify, and Adobe demonstrate tokens enable consistent design at scale.

What Design Tokens Are

design illustration

Design tokens are atomic values of a design system stored as platform-agnostic data. Unlike CSS variables, they are authored once and transformed for every platform. A token changes from a hex value to a semantic name like color.primary.action. The W3C Design Tokens specification standardizes the JSON structure. Companies like Salesforce, Shopify, and Adobe demonstrate tokens enable consistent design at scale.

Three-Tier Token Architecture

Global tokens are raw values: color.blue.500, font.size.200, spacing.400. Semantic tokens reference global tokens with meaning: color.background.primary maps to different globals per theme. Component tokens reference semantic tokens for component needs. This layering means theme changes only update semantic mappings. Naming uses dot notation: category.property.variant.state.

Style Dictionary Build Pipeline

Amazon Style Dictionary transforms tokens from source to platform-specific outputs. Transforms include name conversion, value conversion (px to rem, hex to UIColor), and attribute generation. A typical pipeline produces CSS custom properties, SCSS variables, JavaScript constants, iOS Swift enums, and Android Kotlin resources. CI/CD integration runs on every token change.

Figma Integration

design illustration

Figma variables map directly to design tokens. The Token Studio plugin enables bidirectional sync between Figma and GitHub. Designers update tokens in Figma, plugin pushes to GitHub, CI/CD runs Style Dictionary, and updated values deploy to all platforms. Version control enables tracking design system evolution and rolling back changes.

Multi-Brand Theming

Global tokens are shared across brands. Brand tokens override specific globals. Theme tokens map semantic tokens to different globals per theme. CSS custom properties enable runtime theme switching. Multi-brand deployments use CSS custom property scoping with classes or data attributes. The build pipeline produces separate outputs per brand and theme.

Governance and Accessibility

Automated validation checks naming conventions, reference integrity, and contrast ratios. Breaking changes require migration guides. Design tokens encode accessibility: contrast ratio tokens ensure WCAG compliance, motion tokens define reduced-motion alternatives, touch target tokens ensure minimum sizes. Token validation in CI/CD automatically checks contrast for all combinations.

Conclusion

The topics covered in this article represent important developments in modern software engineering. By understanding these concepts deeply and applying them in your projects, you can build more robust, scalable, and maintainable systems. Continue exploring, experimenting, and building — the technology landscape rewards those who stay curious and keep learning.