Линтер shadcn для Tailwind: 6 правил против хаоса стилей

Что в ролике
Вы сталкиваетесь с тем, что AI-агент при работе с Tailwind добавляет случайные отступы, цвета и произвольные значения, а TypeScript это не отлавливает. Shadcn выпустил agent-first линтер с шестью правилами, который подключается к Oxlint или ESLint и работает в любом Tailwind v4-проекте, даже без shadcn/ui. Первое правило no-restyle разрешает страницам только размещать компонент с помощью margin, width и flex, но запрещает менять padding, цвета, типографику, скругления и motion, а сообщения об ошибке строятся из CVA-настройки самого компонента и подсказывают допустимые варианты. Правила no-raw-colors и no-arbitrary-values запрещают случайные цвета вроде background-pink-500 и значения вне шкалы, например padding 13px, предлагая ближайший токен или конкретный класс из вашей дизайн-системы. Остальные правила запрещают inline-стили, неизвестные классы и динамические классы в шаблонных строках, потому что линтер не может их проверить. В тесте Shadcn на 8 задачах все модели допускали множество нарушений дизайн-системы, а после включения линтера нарушения упали до нуля. Для адаптации под свой проект используются контракты по каждому компоненту с regex-совпадением имени и собственные сообщения с плейсхолдерами из кода. Линтер не видит plain CSS, не отслеживает parent-селекторы, пропускает новые токены, добавленные агентом, и пока работает только в Oxlint и ESLint, без Biome.
Практика
- Что получишь
- Способ подключить линтер и заставить AI-агентов использовать только токены и варианты вашей дизайн-системы, а не выдуманные цвета и отступы.
- Первый шаг
- Установите плагин для ESLint или Oxlint в свой Tailwind v4-проект и включите первое правило no-restyle.
- Цифры
- —8 задач — столько промптов Shadcn дал AI-моделям для проверки, каждая провоцировала уйти от дизайн-системы
- —0 — столько нарушений дизайн-системы осталось у моделей после включения линтера
- —6 правил — столько их в плагине: no-restyle, no-raw-colors, no-arbitrary-values и ещё три
- —13 px — такой отступ из примера линтер считает нарушением и предлагает заменить на соседний токен шкалы
- Честно
- Канал принадлежит Better Stack, но в самом ролике их сервис не продвигается. Полные конфиги контрактов и тексты ошибок показаны на экране, но не зачитаны, поэтому для повторения некоторые настройки нужно смотреть видео или документацию. Линтер не отменяет код-ревью: новые токены и варианты, которые агент добавит в дизайн-систему, он пропустит.
Если слова незнакомы — 8 терминов
- линтеринструмент, который анализирует код и показывает ошибки до запуска
- дизайн-системасвод готовых цветов, отступов, скруглений и вариантов компонентов
- TailwindCSS-фреймворк, в котором стили задаются классами в разметке
- токенименованное значение из дизайн-системы, например цвет или шаг отступа
- CVAбиблиотека описания вариантов компонента, из которой линтер берёт допустимые значения
- ESLint и Oxlintлинтеры для JavaScript/TypeScript, к которым подключают плагин
- plain CSSобычный CSS в файлах стилей, который линтер не разбирает
- inline-стилистили, заданные прямо в style-атрибуте тега
Связки из этого ролика
2 шт.- Tailwind + Shadcn UI
- Oxlint + ESLint
Компоненты
6 шт.Формат: обзор · для практикующих · уверенность разметки 0.85 · источник