Что такое дизайн-токен — и как одна строка перекрашивает всё приложение

Разберём штуку, которая выглядит скучно ровно до того момента, как ты первый раз меняешь фирменный цвет в проекте на сорок экранов.
Спецификация Design Tokens определяет токен предельно сухо: «токен — это информация, связанная с человекочитаемым именем, как минимум пара имя-значение». Звучит как ни о чём. Но вот где спрятана вся сила: токен — это не цвет. Токен — это имя. Сам цвет вторичен и в любой момент может стать другим.
Токен — это имя для значения
Обычный код выглядит так: у кнопки стоит #D4A373, у иконки #D4A373, у ссылки #D4A373. Три места, одно значение — и никакой связи между ними. Через месяц ты не отличишь «этот золотой, потому что он акцентный» от «этот золотой, потому что так вышло».
С токенами появляется слой имён:
{
"color": {
"accent": { "$value": "#D4A373", "$type": "color" }
}
}
Теперь кнопка ссылается на color.accent. Меняешь одну строку — меняется везде, где это смысловой акцент, и не меняется там, где просто похожий оттенок.
По спецификации обязательно только значение — $value. Тип ($type) технически необязателен, но если его нигде не задать, инструменты обязаны считать токен невалидным: без типа непонятно, что #D4A373 — цвет, а не строка.
Алиасы: два слоя, из-за которых работает тёмная тема
Вот главный приём, который отличает «я назвал переменные» от настоящих токенов. Спецификация разрешает значению быть ссылкой на другой токен: «значением дизайн-токена может быть ссылка на другой токен. У одного значения может быть несколько имён, или алиасов».
Из этого рождается двухслойная схема:
- Примитивы — сырая палитра:
gold-300,graphite-900. Они просто есть и ничего не значат. - Семантические токены — роли:
text.primary,surface.card,border.subtle. Их значения — ссылки на примитивы.
Компоненты используют только второй слой. И тогда тёмная тема перестаёт быть перекраской: ты не трогаешь ни один компонент, ты подменяешь, на какие примитивы смотрят роли. surface.card вчера указывал на кремовый, сегодня — на графитовый. Всё.
Зачем формат, а не просто переменные
Отдельный вопрос: почему для этого понадобилась целая спецификация, если есть CSS-переменные. Ответ прямо в её задаче — «улучшить совместимость между инструментами, определив стандартный формат файла».
Смысл в том, что дизайн живёт не в одном месте. Один и тот же акцентный цвет нужен в вебе, в iOS, в Android, в редакторе макетов. Токены в нейтральном JSON — это единственный источник правды, из которого генерируются все остальные форматы.
У нас в KODiQ ровно так и сделано: один design-tokens.json, из него скрипт раскладывает цвета в Swift, Kotlin и CSS. Изменить оттенок — это правка одной строки и прогон генератора, а не поиск по трём кодовым базам.
Кстати, Tailwind работает по той же идее: его тема — это и есть набор токенов в CSS-переменных, которые можно переопределить или снести целиком.
Как называть токены, чтобы потом не переделывать
Имя — это единственное, что переживёт все смены палитры, поэтому его стоит выбирать по правилу: называй роль, а не внешность.
color.danger— хорошо: роль сохранится, даже если завтра ошибка станет оранжевой.color.red— плохо: через год у тебя будетcolor.red, который на самом деле оранжевый.spacing.gap.card— хорошо.spacing.16— терпимо для примитивов, но не для компонентов.
Формально спецификация ограничивает немногое: имя не должно начинаться с $ и не может содержать {, } или точку — эти символы зарезервированы под синтаксис ссылок. Всё остальное — договорённость, но её стоит принять один раз и не менять: переименование токена через полгода — это правка во всех местах сразу.
Практичный формат имени — от общего к частному, через точку или дефис: сначала категория (color, spacing, font), потом роль (text, surface, border), потом уточнение (primary, muted, inverse).
Зачем это, если интерфейс тебе рисует ИИ
Затем, что токены — это самый компактный способ объяснить модели твой стиль.
Модель не умеет угадывать твою палитру. Скажешь «сделай в нашем фирменном стиле» — получишь чужой. Но список из пятнадцати строк с именами и значениями влезает в любой промпт, и с ним модель перестаёт выдумывать: она берёт готовые имена. Это же — рабочее лекарство от того, что ИИ рисует все интерфейсы одинаковыми.
Практический минимум, с которого стоит начать: цвета, шаг отступов, размеры шрифта, радиусы скругления. Четыре группы — уже 90% пользы.
Чем токен отличается от переменной в CSS?
Переменная — это способ хранения в одной технологии. Токен — это описание намерения, не привязанное к языку: из него генерируются и CSS-переменная, и константа в Swift, и стиль в макете. Плюс у токена есть тип и возможность ссылаться на другой токен.
Это не тот токен, за который платят ИИ?
Совсем не тот, просто слово одинаковое. Токен в языковых моделях — это кусочек текста, за который считают стоимость запроса. Дизайн-токен к оплате отношения не имеет, живёт в дизайн-системе и с моделями никак не связан.
С чего начать, если проект уже написан?
Не переписывай всё. Собери список того, что уже используется — обычно там находится десяток почти одинаковых цветов. Схлопни их до пяти-шести ролей, заведи имена и переводи компоненты по одному. Начни с цветов: они дают заметный результат быстрее всего. Дальше это естественно вырастает в дизайн-систему.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





