⌨️ CLI: Tailwind и shadcn

Все ключи и частые рецепты

Tailwind CLI

npx @tailwindcss/cli -i ./src/input.css -o ./dist/output.css --watch
npx @tailwindcss/cli -i ./src/input.css -o ./dist/output.css --minify
КлючЗначение
-i, --inputвходной CSS
-o, --outputвыходной файл (по умолчанию — stdout)
-w, --watch[=always]пересобирать при изменениях
--poll[=ms]опрос вместо событий файловой системы
-m, --minifyоптимизировать и минифицировать
--optimizeоптимизировать без минификации
--cwdрабочая директория
--mapsource map
--silentтолько ошибки
-h, --helpсправка

Подкоманды: build (то же, что вызов по умолчанию) и canonicalize — приведение классов к каноническому виду.

shadcn CLI: команды

КомандаЧто делает
init (create)подготовить проект: конфигурация, тема, cn()
add [элементы…]добавить компоненты в проект
apply [preset]применить готовый набор настроек
docs <компоненты…>документация и примеры использования
view <элементы…>показать содержимое элемента реестра
search (list)искать элементы в реестрах
migrate [миграция] [путь]запустить миграцию
ejectвстроить shadcn/tailwind.css и убрать пакет
infoчто CLI видит в проекте
build [реестр]собрать собственный реестр компонентов
mcpMCP-сервер для интеграции с ИИ-инструментами
preset, registryуправление наборами и реестрами
diff [компонент]устарело — используйте add [компонент] --diff

Ключи init

КлючЗначение
-t, --templatenext, start, vite, react-router, laravel, astro
-b, --baseпримитивы: base, radix, aria
-p, --preset [name]готовая конфигурация
-d, --defaultsбез вопросов, значения по умолчанию
-y, --yesне спрашивать подтверждение
-f, --forceперезаписать конфигурацию
-c, --cwdрабочая директория
-n, --nameимя нового проекта
--css-variables / --no-css-variablesтемизация переменными
--rtl / --no-rtlподдержка письма справа налево
--pointer / --no-pointerкурсор-указатель на кнопках
--monorepo / --no-monorepoструктура монорепозитория
--reinstall / --no-reinstallпереустановить компоненты
-s, --silentбез вывода

Ключи add

КлючЗначение
-y, --yesбез подтверждения
-o, --overwriteперезаписать существующие файлы
-a, --allдобавить все компоненты
-p, --pathкуда положить файлы
-c, --cwdрабочая директория
--dry-runпоказать изменения без записи
--diff [path]отличия вашей версии от реестра
--view [path]показать содержимое файла
-s, --silentбез вывода

Частые рецепты

ЗадачаКоманда
Понять, что CLI видит в проектеnpx shadcn@latest info
Посмотреть исходник, не добавляяnpx shadcn@latest view button
Проверить, что изменитсяnpx shadcn@latest add card --dry-run
Сравнить свою версию с реестромnpx shadcn@latest add button --diff
Поставить всё сразу (для изучения)npx shadcn@latest add --all
Выбрать Radix вместо Base UInpx shadcn@latest init --base radix
Собрать CSS без сборщикаnpx @tailwindcss/cli -i in.css -o out.css --minify
Найти класс в собранном CSSgrep "text-brand-600" dist/assets/*.css
Перед любой командой, которая пишет файлы, полезно иметь чистое рабочее дерево: тогда результат виден в git diff.