base-vs-radix — правило для Claude Code: API компонентов shadcn
Правило base-vs-radix для IDE, которое помогает разработчикам не путать API между базовыми компонентами shadcn и их Radix-версиями. Описывает различия в синтаксисе для Select, Button, Slider, Accordion и других компонентов.
LicenseRef-Proprietary ★ 7 523 обновлён 2026-10-29
.claude/rules/base-vs-radix.mdЧто делает base-vs-radix
Когда вы работаете с shadcn в разных ветках кода, базовые компоненты и версии на Radix используют разные API для одного и того же функционала. Правило перечисляет все основные отличия: asChild в Radix против render в базовых компонентах, отличия в свойствах Select (items, placeholder, positioning), разное значение defaultValue в ToggleGroup и Accordion (массив в base, строка в radix), скалярные числа в Slider против всегда массива.
При смене базового компонента на trigger нужно добавлять nativeButton={false} в base. Select в base требует явный items-массив, поддерживает множественный выбор и объектные значения — чего Radix не умеет. Accordion в base не требует type, но всегда использует массив для defaultValue.
Какие задачи решает
- различить синтаксис asChild и render при работе с triggers
- правильно настроить Select с items, placeholder и позиционированием в base
- контролировать значение ToggleGroup в обеих версиях компонентов
- использовать defaultValue как число или массив в зависимости от версии Slider
- расставить nativeButton={false} при замене Button на ссылку или другой элемент
Примеры запросов агенту
- Как правильно использовать asChild в DialogTrigger для Radix-версии?
- В base-версии Select нужен items-массив или можно обойтись без него?
- Почему ToggleGroup требует массив в defaultValue для base и строку для radix?
Как установить base-vs-radix
Вручную: положить файлы
.claude/rules/base-vs-radix.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/base-vs-radix.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/base-vs-radix.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/base-vs-radix.mdВручную: положить файлы
.clinerules/base-vs-radix.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о base-vs-radix
Как установить правило base-vs-radix в Claude Code?
Скопируйте файл в .claude/rules/base-vs-radix.md в корне проекта. Claude Code автоматически загружает правила из этой папки при запуске.
Что делает правило base-vs-radix?
Оно объясняет различия в API между базовыми компонентами shadcn и их Radix-версиями: синтаксис composition, поведение Select, значения по умолчанию в ToggleGroup и Accordion, требования к nativeButton и другие детали.
В чём главное отличие базовых компонентов от Radix?
Base использует render вместо asChild, требует items в Select, поддерживает множественный выбор и object-значения, использует массивы для defaultValue везде. Radix проще, но ограничен строковыми значениями и одиночным выбором в Select.