Тема проекта
собирается в билдере
Настроить, проверить и опубликовать тему — без правок в коде компонентов и без сборки пакетов.
Как это выглядит внутри
Тема вместо форка
- Значения токенов, шрифты и шкалы меняются в интерфейсе
- Компоненты остаются системными и обновляются с релизами
Проверка до публикации
- Превью темы на реальных компонентах
- Валидация показывает риски и затронутые объекты
Версия как результат
- Публикация фиксирует конфигурацию под номером версии
- Разработчик получает её через CLI, а не через npm-пакет от нас
Меняется значение,
а не код компонентов
Продукт правит значения, а не библиотеку: ступень палитры, набор типографики, шкалу отступов. Токены, которые ссылаются на изменённое значение, пересчитываются сами — инспектор показывает их списком, а превью сразу отражает результат.
Как устроены токены
Путь от правки
до версии в продукте
Работа идёт по уровням: проект — дизайн-система — тема. Изменения собираются в черновик, проверяются и публикуются одной версией. Ревью и согласования в этом пути нет: валидация сообщает о рисках, но не блокирует публикацию.
Документация системы- Проект и дизайн-система
Каталог проектов, внутри — дизайн-системы и их темы. Участники и роли живут на уровне проекта.
- Тема
Название, preset, светлый и тёмный режимы. Дальше — правка оснований и компонентов.
- Черновик изменений
Каждая правка попадает в Changes: старое и новое значение, автор, дата, затронутые объекты.
- Превью и валидация
Результат виден на компонентах; из проблемы можно перейти к её источнику и исправить значение.
- Публикация
Выбранные изменения становятся версией конфигурации со снимком состояния темы.
- CLI у разработчика
CLI забирает выбранную версию и генерирует файлы для платформы проекта.
Что настраивается
в теме
Основания темы правятся по одному сценарию: раздел → объект в рабочей области → то же в инспекторе → новое значение → результат в превью и в черновике. Выбор объекта сам по себе ничего не меняет.
Как устроены токены| Основание | Что меняется | Контексты и режимы |
|---|---|---|
| Палитра и цвет | Ступени палитры, перестройка рампы от бренд-цвета, значения токенов | Light / Dark; Default, OnDark, OnLight, Inverse |
| Типографика | Наборы типографических токенов | Large / Medium / Small |
| Отступы | Шкала spacing со своим представлением | — |
| Скругления | Шкала radius со своим представлением | — |
| Компоненты | Разрешённая конфигурация компонента | Демонстрационные свойства в превью черновик не меняют |
| Подтемы | Значения токена для инверсных поверхностей | OnDark, OnLight, Inverse — каждая со своими Light и Dark |
Точечная замена ступени и перестройка рампы входят в счётчик публикации, сбрасываются через Reset и попадают в снимок версии. База для сравнения — состояние палитры на момент последней публикации, поэтому уже опубликованные правки новыми не считаются.
Изменения, проверка
и версии
Отдельного статуса «черновик / опубликовано» в интерфейсе нет: факт публикации выводится из номера версии — 0.1.0 означает, что тема ещё не публиковалась. В списке тем показывается признак «есть изменения» — его из номера не вывести.
Changes
- Изменения черновика относительно его базы
- Строка открывает детали, переход — источник значения
- Revert отменяет конкретное изменение
Validation
- Причины и затронутые объекты для той же ревизии черновика
- Исключение оформляется как исключение, а не как исправление
- Публикацию не блокирует
Versions
- Версия хранит снимок состояния темы
- Ошибка CLI не отменяет уже опубликованную версию
- Номер меняется только в момент публикации
Роли
и доступ
Права назначаются в рамках участия в проекте: один человек может иметь разные роли в разных проектах. Дизайн-системы и темы наследуют доступы проекта — отдельного управления участниками на их уровне нет.
| Роль | Что может |
|---|---|
| Owner | Владелец проекта: максимальная ответственность и полный доступ |
| Editor | Редактирует темы, проверяет и публикует изменения |
| Viewer | Смотрит состояние, версии и результаты без редактирования |
Разработчик — потребитель опубликованной конфигурации через CLI, отдельная роль в билдере ему не нужна. При доступе к проекту достаточно Viewer.
Figma и билдер
один черновик темы
Figma и билдер — два инструмента авторства одной темы. Перенос ручной: плагин выгружает tokens.json, билдер принимает файл из верхней панели темы.
Что делает плагин
- Локальный импорт и экспорт без сети
- Проверка схемы и preflight до применения
- Учёт коллекций и алиасов, стабильные ключи Figma
Что делает билдер при импорте
- Сверяет версию формата и контрольную сумму
- Сопоставляет значения с опубликованной базой и черновиком
- Показывает Import Review и требует выбрать сторону в конфликтах
- Пишет результат одним действием в Changes
Границы
- Импорт не удаляет отсутствующие токены
- Версия не публикуется автоматически
- Публикация — только через билдер
Статус
и что дальше
Билдер в бете: пути описаны как целевое поведение, и не все ветки подтверждены реализацией. Если сценарий расходится с описанным — это повод написать команде, а не обходить.
Написать команде