Field Notes

Token Approach Guide

A living methodology for multi-dimensional design token systems.

What This Is

A methodology for building design systems using independent, orthogonal dimensions. Every component's visual appearance is the product of up to five dimensions:

DimensionControlsQuestion it answers
SentimentCommunicative intentWhat does this component need to say?
EmphasisVisual weightHow urgently must the user receive this signal?
StateInteractive conditionWhat is happening right now? (runtime only)
SizeComponent footprint and internal spacingHow much space does this occupy?
StructureLayout variantWhat is the fixed skeleton of this component?

Plus Theme (light/dark) as an environmental dimension.

How to Use This Guide

Living Document

This guide grows as the approach evolves. Pages marked as draft are in progress. The Concepts Manifest is the single source of truth for valid dimension values — expand it when introducing new concepts rather than improvising inline.

On this page