К основному содержанию
правило CX Codex

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 Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/base-vs-radix.md
Открыть на GitHub

Что делает 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 и 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.

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
migrate-radix-to-base shadcn-ui Скилл migrate-radix-to-base для Claude Code переносит компоненты и проекты с Radix UI на Base UI. Запускается по просьбе заменить библиотеку или перенести отдельный компонент. CX Codex +1 37 800установок shadcn PyModel Подсказывает, как собирать и проверять интерфейсы на shadcn/ui. Помогает с формами, таблицами, темами и доступностью. CX Codex +1 599установок radix-ui-design-system sickn33 Скилл radix-ui-design-system для Claude Code собирает дизайн-систему на Radix UI primitives без готовых стилей, с контролем поведения компонентов. Требуется React 16.8+. CX Codex +1 1 400установок base-ui-migrator pproenca Скилл base-ui-migrator переводит React-компоненты с Radix UI, Headless UI или самописных оверлеев на Base UI (@base-ui/react). Помогает стандартизировать интерфейс без потери стилей. CX Codex +1 144установок affectUI flohoeller MCP-сервер affectUI для поиска и вставки готовых компонентов React в приложения для ИИ. Помогает сразу внедрять анимированные блоки без настройки внешних стилей. CX Codex +1 ★ 917звёзд репо UI Beats nikhils4 Находит анимированные компоненты React в каталоге UI Beats, читает их свойства и генерирует команды для установки. Помогает внедрять готовый интерфейс прямо из чата с ассистентом. CX Codex +1 ★ 235звёзд репо

Из того же набора42

Весь набор →
forms Правило forms задаёт единый способ собирать формы на UI-компонентах и проверять их состояния. Подходит для экранов с вводом, выбором и валидацией. CX Codex +1 ★ 7 523звёзд репо agent-first-screenshots Агент agent-first-screenshots открывает приложение по CDP и снимает кадры, которые прошли три проверки: структуру, пиксели и vision-модель. Для лендингов, писем и презентаций. CX Codex +1 ★ 7 523звёзд репо create-plugin Скилл create-plugin генерирует каркас плагина OpenCode для iPolloWork. Создаёт файл с инструментами, хуками и регистрирует его в конфигурации проекта. CX Codex +1 ★ 7 523звёзд репо daytona-dev Скилл daytona-dev для Claude Code и Codex, который разворачивает облачную песочницу Daytona с XFCE/noVNC-рабочим столом. Запускает Electron-приложение iPolloWork прямо в браузере через noVNC на порту 6080. CX Codex +1 ★ 7 523звёзд репо fraimz Формирует интерактивный отчёт fraimz.html со скриншотами и озвучкой, подтверждая сквозную работу приложения через CDP. CX Codex +1 ★ 7 523звёзд репо github-sync-pr-flow Скилл github-sync-pr-flow ведёт локальные изменения через синхронизацию личной ветки с main, коммит и публикацию PR. Он пригодится, когда нужно подготовить изменения для GitHub, сохранив текущую ветку. CX Codex +1 ★ 7 523звёзд репо daytona-recording-artifacts Скилл daytona-recording-artifacts собирает доказательства работы UI-сценария в песочнице Daytona: именованные PNG по шагам, HTML-страница для просмотра и MP4 там, где нужна динамика. CX Codex +1 ★ 7 523звёзд репо ipollowork-maintainable-code Правило ipollowork-maintainable-code проверки правок в кодовой базе iPolloWork. Оно заставляет агента переиспользовать готовые компоненты, не плодить дубликаты и проверять диф перед коммитом. CX Codex +1 ★ 7 523звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой