STRUCTUREцифровые системыОбсудить проект
НОВОСТЬ · Engineering

Tailwind CSS из дизайн-токенов: генерация темы без ручного переноса значений

Разработчик представил tailwind-dictionary — инструмент, который преобразует дизайн-токены в файлы тем для Tailwind CSS. Идея проекта в том, чтобы цвета, размеры и типографика сохраняли единый источник значений, а повторяющаяся настройка оформления выполнялась воспроизводимой сборкой.

Главное

В командах, где интерфейсы проектируют в Figma, между макетом и работающим сайтом часто возникает лишний этап: разработчик вручную переносит палитру, радиусы и размеры в конфигурацию CSS. После очередного изменения дизайна значения приходится сверять снова. Автор tailwind-dictionary предлагает хранить исходные токены отдельно от конкретной библиотеки стилей и генерировать из них настройки темы по заранее описанным правилам.

Инструмент читает JSON с токенами и собирает результат для Tailwind CSS. Поддерживаются как формат Design Tokens Community Group, так и прежняя структура Style Dictionary, но смешивать два формата в одной сборке нельзя. Для проекта достаточно задать входные файлы, наборы тем и каталог результата в config.json; после этого генерацию запускают командой npx tailwind-dictionary. Режим наблюдения позволяет повторять сборку после изменения исходных файлов.

Подробности

Отдельный сценарий связан с Figma Variables. Из редактора можно выгрузить значения по режимам, например для светлого и тёмного оформления, а затем разложить общие токены и специфичные для темы значения по соответствующим файлам. Генератор разрешает ссылки между токенами, преобразует объекты цвета и позволяет назначать единицы числовым параметрам. Это уменьшает вероятность расхождения между именованным цветом в макете и переменной в приложении.

На стороне Tailwind результат подключается как CSS-файл темы. Семантические переменные, например для основного цвета и фона, используются в привычных классах оформления; атрибут data-theme позволяет переключать набор значений даже внутри отдельного раздела страницы. По описанию автора, предусмотрены разные версии Tailwind и несколько независимых тем, поэтому подход пригоден не только для светлого и тёмного режимов, но и для оформления разных брендов.

Что это меняет

У решения есть важные границы. Оно не отслеживает изменения макета в Figma самостоятельно и не превращает компоненты дизайна в готовую разметку. Выгрузку переменных нужно организовать отдельно, а текстовые стили и тени, которые не представлены переменными Figma, при необходимости описывать дополнительными токенами. Это генератор конфигурации оформления, а не полноценная система синхронизации дизайна и исходного кода.

Практическая ценность такого подхода особенно заметна при частых изменениях палитры и размеров. В команде можно включить сборку темы в обычный процесс разработки, хранить входные JSON рядом с кодом и проверять изменения так же, как любые другие правки. При этом воспроизводимость зависит от качества самих токенов: ошибки в именовании и структуре не исчезнут автоматически, но становятся видимыми на этапе генерации.

Первоисточник

Материал подготовлен STRUCTURE по открытой публикации Habr. Текст и иллюстрации первоисточника не воспроизводятся целиком.

Читать исходную новость целиком ↗