Если в макетах «почти одинаковые» синие, разные отступы и непредсказуемые тени — вам нужны дизайн‑токены. Дизайн‑токены — это переменные, которые описывают визуальные параметры интерфейса (цвета, типографику, отступы, радиусы, тени) и помогают держать систему консистентной в дизайне и в коде.
Дизайн-токены простыми словами
Дизайн‑токены — это «имя + значение»: например, color-primary = #1A73E8, где имя несёт смысл, а значение можно менять централизованно. Суть в том, что вы перестаёте копировать конкретные HEX/px по слоям и вместо этого переиспользуете одни и те же сущности во всём продукте.
Что обычно становится токенами:
- Цвета: брендовые, фоновые, текстовые, границы, статусы (success/error).
- Типографика: размер, межстрочный, начертания, текстовые роли (body/caption/heading). Как подобрать сам шрифт — в статье как выбрать шрифт для интерфейса.
- Spacing: отступы, gaps, сетка.
- Radius/Shadow/Elevation: скругления, тени и «глубина».
Три уровня токенов
В практике часто выделяют 3 уровня: базовые, семантические и контекстуальные — это помогает масштабировать систему и изолировать изменения.
- Базовые (base): «чистые» значения без смысла применения (например, конкретные оттенки/шаги размеров).
- Семантические (semantic): значения со смыслом роли, например color-primary, которые можно перекинуть на другой оттенок без массовой ручной замены.
- Контекстуальные (contextual): параметры для конкретных компонентов/состояний, которые обычно ссылаются на базовые/семантические, чтобы не плодить хаос.
Мини‑пример иерархии (логика, а не стандарт):
- base.blue.500 → semantic.color.action.primary → component.button.primary.bg.default / hover.
Нейминг: как назвать токены
Универсального стандарта нейминга нет, поэтому важнее выбрать понятную структуру и быть последовательным. Практичная схема — category–property–modifier (категория–свойство–модификатор), например: $color-background-hover или $font-size-heading-large.
Правила, которые реально экономят время:
- Пишите описательно, но коротко: имя должно читаться без «легенды» и поиском находиться быстро.
- Держите одну структуру на весь проект, иначе токены превращаются в второй хаос.
- Не привязывайтесь к значению в названии (например, font-size-24px), чтобы изменения не ломали смысл имён.
- Добавляйте контекст, если есть риск неоднозначности (например, color-button-primary-hover, а не просто color-hover).
Как внедрить в проект (Figma → код)
Токены особенно полезны, когда нужно поддерживать несколько тем (например, light/dark) и синхронизировать дизайн с разработкой как «единый источник правды». В Figma их можно вести через Variables, а в разработке — через переменные/файлы токенов (часто JSON/CSS‑переменные), чтобы обновления проходили централизованно.
Короткий план внедрения (подойдёт даже для небольшого продукта):
- Соберите базу: палитра, типографика, spacing‑шкала, радиусы.
- Разведите уровни: base → semantic → component/context, чтобы изменения были управляемыми.
- Опишите словарь терминов (glossary): что такое primary/secondary/surface/feedback и т. п., чтобы команда называла одинаково.
- Зафиксируйте правила в документации: как создавать новый токен, когда заводить компонентный, а когда хватит семантического.

