дизайн-системы · токены · figma variables · pet-проект

DESIGN SYSTEM

Дизайн-система этого сайта: токены в CSS,
страница документации и библиотека в Figma

Страница дизайн-системы на ноутбуке Страница дизайн-системы на телефоне

1 — Аудит и токены

Сайт вырос без системы: цвета, отступы и тени жили в стилях отдельных блоков. Собрал их в 66 CSS-переменных с ролевыми именами — цвет, типографика, отступы, границы, тени, движение — и добавил статусные цвета для обеих тем.

Работал в паре с Claude Code: задачу, объём и решения определял сам, агент делал аудит стилей, вёрстку и сборку библиотеки. Существующие значения не менялись, поэтому сайт выглядит как раньше.

2 — Живая документация

Страница не хранит значения, а читает их из CSS: при смене темы таблицы пересчитываются, рядом с каждым цветом показан его контраст к фону. Так нашёлся слабый контраст акцента на белом — 3,8:1, и страница показывает его честно.

Кроме существующих компонентов описал и сверстал недостающие: поля ввода, чекбокс, радио, свитч, бейджи, уведомления, табы и таблицу — с состояниями ошибки, фокуса и недоступности.

3 — Библиотека в Figma

Из тех же токенов собрал библиотеку: 102 переменные, 15 текстовых стилей и 17 компонентов с вариантами состояний. У каждой переменной указано её CSS-имя, так что макет и код называют одно и то же одинаково.

Бесплатный тариф Figma даёт один режим на коллекцию и три страницы на файл, поэтому тёмная тема вынесена в отдельную коллекцию, а компоненты лежат на одной странице.

4 — Проверка на макете

Чтобы проверить систему, собрал из компонентов главную страницу сайта: шапка, герой, карточки проектов, призыв и футер — без единого цвета, заданного вручную, кроме фирменных цветов проектов на обложках.

давайте познакомимся

написать мне в tg