Skip to content
Back to field notes

Design Systems

Why tokens are a language, not a stylesheet

How design tokens become the contract between designers, engineers, and product, and why that framing changes everything.

AJ Barnett·May 2026·6 min

A stylesheet describes appearance. A token describes intent. That single distinction is the difference between a design system that scales an organization and one that becomes a museum of past decisions.

The contract

When a token is named color.action.primary, three teams now share a promise: design uses it in Figma, engineering imports it in code, and product reasons about it in specs. Nobody is inventing new grammar in a hallway.

Tokens aren't about consistency. They're about communication.

A grammar for teams

The best token architectures read like a language: nouns (color, space, radius), adjectives (subtle, strong, muted), and roles (surface, action, feedback). Once the grammar exists, individual decisions get faster because the space of choices is smaller.

ts// snippet
// tokens as intent, not appearance export const semantic = { color: { surface: { base: 'color.neutral.0', raised: 'color.neutral.50' }, action: { primary: 'color.brand.600', danger: 'color.red.600' }, text: { primary: 'color.neutral.900', muted: 'color.neutral.600' }, }, } as const;

Why it scales

Every team that adopts the token layer inherits the review process behind it, accessibility contrast, dark-mode parity, brand alignment. A single semantic change ripples across every product surface without a coordination meeting.

Closing

Treat tokens as a language and the system stops being a burden on individual teams. It becomes shared infrastructure, quiet, durable, and multiplying every decision downstream.

Written by

AJ Barnett

Frontend architect, design systems engineer, AI practitioner. Twenty-five years of shipping.