shadcn lint: линтер, который не даёт агенту ломать стили

Что в ролике
Агент, который свободно правит классы, легко разносит всю дизайн-систему, и автор показывает инструмент против этого — shadcn lint для Tailwind четвёртой версии, открытый и бесплатный. Логика простая: вы описываете, что разрешено, а когда агент нарушает правило, линтер выдаёт сообщение с объяснением и готовым исправлением из ваших компонентов, вариантов и темы. Ставится он в существующий проект: добавить зависимости и правило в конфиг, а быстрее — отдать своему агенту промпт «прочитай setup и настрой shadcn lint в проекте», после чего агент сам изучает проект и предлагает набор правил. Сейчас поддерживаются ESLint и Oxlint, Biome пока нет, а использовать shadcn/ui не обязательно. Правил шесть: запрет на перестилизацию компонента через className, на сырые цвета вида background pink 500, на произвольные значения вроде padding 13 пикселей, на инлайн-стили, на неизвестные классы и требование статических классов. В демо-проекте с тремя правилами линтер ругается на padding у кнопки и объясняет, что кнопка сама управляет отступами и нужно взять размер из вариантов, а на карточке подсказывает шаг из шкалы темы вместо жёстко заданного числа. Большая часть ролика — про спор Tailwind и StyleX: главным аргументом миграции были контроль над стилями и типобезопасные токены, которые ловятся до отрисовки. Автор считает, что теперь то же самое доступно и в Tailwind, поэтому спор закончен, хотя это его личная оценка, а не замер.
Практика
- Что получишь
- Поймёте, как закрыть агенту свободу в вёрстке: какие правила дизайн-системы имеет смысл включить и как выглядит сообщение, которое агент получает вместо молчаливой поломки стилей.
- Первый шаг
- Открыть репозиторий shadcn lint, прочитать setup-файл и отдать своему агенту промпт с просьбой настроить линтер в текущем проекте.
- Цифры
- —6 правил в линтере: no-restyle, no-raw-colors, no-arbitrary-values, no-inline-styles, no-unknown-classes и requires-static-classes
- —2 линтера поддерживаются — ESLint и Oxlint, а Biome пока вне списка
- —3 нарушения показаны в демо: отступ у кнопки, background pink 500 и padding 13 пикселей вместо шага темы
- —Tailwind 4 — версия дизайн-систем, под которую написан линтер
- Честно
- Сам инструмент открытый и бесплатный, но в финале автор зовёт в своё сообщество Mighty Horde. Все команды и содержимое rule-файла в речи не называются — их видно только на экране, поэтому зависимости придётся смотреть в setup-файле репозитория, а его адрес в ролике не звучит. Учтите, что автосубтитры пишут shadcn как «shed cien», «shedsen» и «sheden»: искать инструмент по этим названиям бесполезно.
Если слова незнакомы — 8 терминов
- линтерпрограмма, которая проверяет код по заданным правилам и показывает ошибки
- дизайн-системанабор согласованных компонентов, цветов и отступов, из которых собирается интерфейс
- Tailwindподход к вёрстке, где оформление задаётся короткими классами прямо в разметке
- токен темыименованное значение цвета или отступа из вашей темы вместо конкретного числа
- classNameатрибут, через который задают классы оформления компонента
- ESLint и Oxlintпроверяющие инструменты, в конфиг которых подключается новое правило
- StyleXальтернативная система стилей от Meta, из-за которой многие уходили с Tailwind
- агентпрограмма, которая сама пишет и правит код по вашим указаниям
Понадобится экран
Часть информации есть только на экране (настройки). Открыть на YouTube с 0:49.
Связки из этого ролика
6 шт.- shadcn lint + Tailwind v4 — правила дизайн-системы вместо свободной генерации классов агентом
- shadcn lint + ESLint или Oxlint — линтер подключается в существующий rule-файл проекта
- shadcn lint + AI-агент — ошибка приходит агенту готовым промптом с исправлением из темы и вариантов компонента
- shadcn lint + setup.md — агент сам ставит зависимости, изучает проект и предлагает набор правил
- shadcn lint + компоненты shadcn/ui — правила работают без обязательного использования shadcn/ui
- StyleX + TypeScript — типобезопасные токены (defineVars), которые теперь воспроизводятся связкой Tailwind и shadcn lint
Компоненты
9 шт.Цитаты-доказательства
дословно из субтитров- Everything you need to do is just to install the dependencies and to add it to your rule file.0:49
- So you give your coding agent this prompt read and then this file setup.md and setup sheds and lint in this project.1:04
- So we have here the prompt basically for our AI agent that we need to put in for this to get fixed and to look good like this.5:30
- So I would put a rule for my CTA button for example1:56
Формат: разбор · для практикующих · уверенность разметки 0.72 · источник