Если в макетах «почти одинаковые» синие, разные отступы и непредсказуемые тени — вам нужны дизайн‑токены. Дизайн‑токены — это переменные, которые описывают визуальные параметры интерфейса (цвета, типографику, отступы, радиусы, тени) и помогают держать систему консистентной в дизайне и в коде.
Дизайн-токены простыми словами
Дизайн‑токены — это «имя + значение»: например, color-primary = #1A73E8, где имя несёт смысл, а значение можно менять централизованно. Суть в том, что вы перестаёте копировать конкретные HEX/px по слоям и вместо этого переиспользуете одни и те же сущности во всём продукте.
Сам термин появился в Salesforce в середине 2010-х: команде Lightning Design System нужно было, чтобы одни и те же цвета и отступы одинаково работали на вебе, iOS и Android. Токены стали общим языком между дизайнерами и разработчиками.
Сам термин появился в Salesforce в середине 2010-х: команде Lightning Design System нужно было, чтобы одни и те же цвета и отступы одинаково работали на вебе, iOS и Android. Токены стали общим языком между дизайнерами и разработчиками.
Что обычно становится токенами:
- Цвета: брендовые, фоновые, текстовые, границы, статусы (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. Переменная хранит одно значение, может ссылаться на другую переменную и иметь несколько режимов (modes) — например, светлую и тёмную тему. Стили (Styles) хранят готовый набор свойств, поэтому для токенов удобнее переменные.
В коде токены живут в JSON-файлах и CSS-переменных. Для JSON есть общий формат: в октябре 2025 года Design Tokens Community Group при W3C выпустила первую стабильную версию спецификации — Design Tokens Format Module 2025.10. Вот как выглядит пара «базовый → семантический» токен:
В Figma токены ведут через Variables. Переменная хранит одно значение, может ссылаться на другую переменную и иметь несколько режимов (modes) — например, светлую и тёмную тему. Стили (Styles) хранят готовый набор свойств, поэтому для токенов удобнее переменные.
В коде токены живут в JSON-файлах и CSS-переменных. Для JSON есть общий формат: в октябре 2025 года Design Tokens Community Group при W3C выпустила первую стабильную версию спецификации — Design Tokens Format Module 2025.10. Вот как выглядит пара «базовый → семантический» токен:
Кнопка ссылается только на семантический токен. Чтобы сменить фирменный цвет или добавить тёмную тему, меняют значение токена, а не каждую кнопку.
План на один день (для небольшого продукта):
План на один день (для небольшого продукта):
- Аудит: соберите из макетов все цвета, размеры шрифтов, отступы и радиусы. «Почти одинаковые» значения объедините.
- Базовые токены: палитра, шкала отступов (например, 4, 8, 12, 16, 24, 32), размеры шрифтов, радиусы — в отдельную коллекцию Variables.
- Семантические токены: вторая коллекция с режимами Light и Dark, значения — ссылки на базовые.
- Привязка: замените «сырые» HEX и px в кнопках, карточках и полях ввода на переменные.
- Словарь и правила: что такое primary, surface, feedback; когда заводить компонентный токен, а когда хватит семантического. Передайте разработчикам JSON или CSS-переменные.
Типичные ошибки при внедрении токенов
- Компоненты ссылаются на базовые токены напрямую. Кнопка берёт blue.500 вместо action.primary — и при смене бренда или теме придётся снова искать все синие.
- Компонентный токен на каждое свойство. Если у каждой кнопки и карточки свои токены, система разрастается до сотен имён. Начните с семантики и заводите компонентные только там, где они правда отличаются.
- Значение в имени. font-size-24px перестаёт быть правдой после первой правки.
- Нет владельца и документации. Без словаря и правил каждый заводит токены по-своему, и через месяц хаос возвращается.
Источники
Design Tokens Community Group (W3C): Design Tokens Format Module 2025.10, Final Community Group Report, 28.10.2025.
Figma Help Center: Guide to variables in Figma (проверено 22.11.2026).
Design Tokens Community Group (W3C): Design Tokens Format Module 2025.10, Final Community Group Report, 28.10.2025.
Figma Help Center: Guide to variables in Figma (проверено 22.11.2026).

