Урок 16. Справочник: термины и команды

📁 Раздел: shadcn/ui ⏱️ Время изучения: ~40 мин 🎯 Сложность: Средняя

⚡ Кратко

Термины: реестр, примитив, слот, вариант. Основные команды: init, add, view, diff.

Словарь

Термин	Что означает
Реестр (registry)	каталог описаний компонентов, откуда CLI берёт исходники
Примитив (primitive)	headless-компонент с поведением и доступностью, без оформления
Base UI	набор примитивов, используемый по умолчанию в стиле `base-nova`
Radix UI	альтернативный набор примитивов; на нём построены старые версии shadcn/ui
Слот (`data-slot`)	атрибут-метка части компонента; по нему удобно стилизовать и тестировать
Вариант	значение из `cva`: `variant="outline"`, `size="sm"`
Стиль (style)	набор оформления реестра, например `base-nova`
`components.json`	конфигурация проекта для CLI: пути, алиасы, базовый цвет

Команды CLI

Команда	Что делает
`init`	подготовить проект: конфигурация, темы, `cn()`
`add [компоненты…]`	скопировать компоненты в проект
`add --all`	добавить все компоненты реестра
`add --dry-run`	показать, что будет сделано, ничего не записывая
`add [компонент] --diff`	показать отличия вашей версии от реестра
`view [элементы…]`	посмотреть содержимое элемента реестра
`search / list`	искать элементы в реестрах
`docs [компоненты…]`	получить документацию и примеры
`info`	сведения о проекте: фреймворк, версия Tailwind, алиасы
`migrate`	запустить миграцию
`eject`	встроить `shadcn/tailwind.css` и убрать пакет `shadcn`
`build`	собрать собственный реестр
`mcp`	MCP-сервер для интеграции с ИИ-инструментами

Полный перечень ключей — в справочнике «CLI: Tailwind и shadcn».

Что появится в проекте после init

components.json          ← конфигурация CLI
src/index.css            ← токены темы и @theme inline
src/lib/utils.ts         ← функция cn()
src/components/ui/       ← сюда попадают компоненты

Ключевые зависимости

Пакет	Роль
`@base-ui/react`	примитивы: поведение и доступность
`class-variance-authority`	варианты компонентов
`clsx` + `tailwind-merge`	функция `cn()`
`lucide-react`	иконки по умолчанию
`tw-animate-css`	анимации появления и закрытия оверлеев

⚠️ Проверить по документации: состав зависимостей зависит от выбранного стиля и версии CLI. Приведённый список соответствует прогону init -d с base-nova.