shadcn/ui — это набор готовых компонентов интерфейса для React, которые вы копируете в свой проект и дальше правите как собственный код. Это не пакет, который ставят и обновляют из npm, а источник заготовок.
Автор проекта — разработчик, известный под ником shadcn. Компоненты (кнопки, формы, диалоги, таблицы, выпадающие списки) написаны на React и TypeScript, стилизованы через Tailwind CSS и опираются на библиотеку Radix UI, которая отвечает за доступность: управление с клавиатуры, фокус, ARIA-атрибуты.
Главное отличие от привычных UI-китов в том, что код компонента лежит в вашем репозитории, обычно в папке components/ui. Вы можете изменить любую деталь: радиусы, анимацию, поведение. Нет зависимости от версии чужой библиотеки и нет борьбы с её стилями.
Как добавить компонент
- Инициализируйте shadcn/ui в проекте командой
npx shadcn@latest init. - Добавьте нужный компонент, например
npx shadcn@latest add button. - Подключите его в страницу как обычный Компонент.
- Настройте цвета и радиусы через переменные темы, чтобы они совпали с брендом.
Чем отличается от готовых библиотек
Material UI или Ant Design ставятся как зависимость и обновляются целиком, но кастомизация ограничена их системой стилей. shadcn/ui даёт полную свободу, но обновления вы переносите вручную.
Типичные ошибки
- Оставляют стандартную тему, и сайт выглядит как тысячи других.
- Правят внутренности компонента в десятке мест вместо общей настройки.
- Ломают доступность, убирая встроенное поведение Radix.
- Используют в проекте без React: библиотека заточена под него.
Частый вопрос
shadcn/ui — это библиотека? Не в обычном смысле. Это коллекция исходного кода и инструмент командной строки, который копирует этот код к вам. После копирования компоненты принадлежат вам, и обновлять их придётся самостоятельно.