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

base-ui-react — скилл для Claude Code: React-компоненты

Скилл base-ui-react помогает собирать интерфейсы на MUI Base UI: настраивать доступные компоненты и плавающие элементы, а также переносить проект с Radix UI.

MIT 259 установок ★ 250 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add secondsky/claude-skills --skill base-ui-react -a claude-code
Открыть на GitHub

Что делает base-ui-react

Скилл подсказывает, как работать с MUI Base UI — библиотекой React-компонентов без встроенного оформления. Он охватывает диалоги, списки выбора, подсказки и другие элементы, паттерн render props и позиционирование через Floating UI. В комплекте есть шаблоны компонентов и справочные материалы, включая руководство по миграции с Radix UI.

Для всплывающих элементов нужны Portal и Positioner, а модальным диалогам — Backdrop. API Base UI находится на стадии Release Candidate и может меняться; скилл отдельно предупреждает об этом. Требуется React 19 или новее, поэтому проекты на более ранних версиях с ним не подойдут.

Какие задачи решает

  • собрать доступный модальный диалог на Base UI
  • настроить позиционирование выпадающего списка или подсказки
  • перенести компонент с Radix UI на render props
  • оформить компоненты Base UI с помощью CSS или Tailwind

Примеры запросов агенту

  • Собери доступный диалог подтверждения на MUI Base UI с Portal и Backdrop.
  • Перенеси мой компонент с Radix UI на Base UI и используй render props.
  • Проверь, правильно ли настроены Portal и Positioner у выпадающего списка.

Как установить base-ui-react

1Через Skills CLI (Vercel)

npx skills add secondsky/claude-skills --skill base-ui-react -a claude-code

2Вручную: положить файлы

~/.claude/skills/base-ui-react/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/base-ui-react/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о base-ui-react

Как установить base-ui-react в Claude Code?

Выполните npx skills add secondsky/claude-skills --skill base-ui-react -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/base-ui-react/SKILL.md.

Что делает base-ui-react?

Скилл помогает создавать интерфейсы с компонентами MUI Base UI: настраивать диалоги, списки выбора и плавающие элементы. Он также объясняет render props и миграцию с Radix UI.

Какая версия React нужна для base-ui-react?

Base UI требует React 19 или новее. Его API ещё может меняться, поскольку библиотека находится в статусе Release Candidate.

Исходный текст

SKILL.md · MIT
---
name: base-ui-react
description: "MUI Base UI unstyled React components with Floating UI. Use for accessible components, Radix UI migration, render props API, or encountering positioning, popup, v1.0 rc / pre-GA issues."
license: MIT
metadata:
  version: "2.0.0"
  last_verified: "2026-08-03"
  production_tested: true
  token_savings: "~62%"
  errors_prevented: 10
  templates_included: 7
  references_included: 3
  keywords:
    - base-ui
    - "@base-ui-components/react"
    - mui base ui
    - unstyled components
    - accessible components
    - render props
    - radix alternative
    - radix migration
    - floating-ui
    - positioner pattern
    - headless ui
    - accessible dialog
    - accessible select
    - accessible popover
    - accessible tooltip
    - accessible accordion
    - number field
    - cloudflare workers ui
    - beta components
---
# Base UI React

**Status**: Release Candidate (v1.0.0-rc.0) ⚠️ | **Last Verified**: 2026-08-03

---

## What Is Base UI?

MUI's unstyled, accessible React component library:
- 27+ accessible components
- Render props pattern
- Full styling control
- Floating UI integration
- Alternative to Radix UI

**Release Candidate status:** v1.0.0-rc.0 (stable v1.0 GA expected soon — still pre-GA, API may change)

---

## Quick Start

### Install

```bash
bun add @base-ui-components/react
```

### Basic Dialog

```typescript
import * as Dialog from '@base-ui-components/react/dialog';

export function MyDialog() {
  return (
    <Dialog.Root>
      <Dialog.Trigger>Open</Dialog.Trigger>
      <Dialog.Portal>
        <Dialog.Backdrop />
        <Dialog.Popup>
          <Dialog.Title>Title</Dialog.Title>
          <Dialog.Description>Content</Dialog.Description>
          <Dialog.Close>Close</Dialog.Close>
        </Dialog.Popup>
      </Dialog.Portal>
    </Dialog.Root>
  );
}
```

### Basic Select

```typescript
import * as Select from '@base-ui-components/react/select';

<Select.Root>
  <Select.Trigger>
    <Select.Value placeholder="Select" />
  </Select.Trigger>
  <Select.Portal>
    <Select.Positioner>
      <Select.Popup>
        <Select.Option value="1">Option 1</Select.Option>
        <Select.Option value="2">Option 2</Select.Option>
      </Select.Popup>
    </Select.Positioner>
  </Select.Portal>
</Select.Root>
```

**Load `references/setup-guide.md` for complete examples.**

---

## Core Components

**Available (27+):**
- Dialog
- Select
- Popover
- Tooltip
- Accordion
- NumberField
- Checkbox
- Switch
- Tabs
- Slider
- And more...

---

## Critical Rules

### Always Do ✅

1. **Use Portal** for popups (Dialog, Select, Popover)
2. **Use Positioner** for floating elements
3. **Add Backdrop** for modal dialogs
4. **Style with Tailwind** (or any CSS)
5. **Use render props** (not asChild like Radix)
6. **Test accessibility** (ARIA built-in)
7. **Handle Portal edge cases** (SSR, hydration)
8. **Check beta docs** for breaking changes
9. **Use TypeScript** for better DX
10. **Test on target browsers**

### Never Do ❌

1. **Never use asChild** (use render function instead)
2. **Never skip Portal** for popups (positioning breaks)
3. **Never skip Positioner** (Floating UI won't work)
4. **Never assume API stability** (beta software)
5. **Never skip accessibility testing**
6. **Never use with React <19** (requires React 19+)
7. **Never skip Backdrop** for modals
8. **Never hardcode z-index** (use Portal)
9. **Never skip SSR testing** (hydration issues)
10. **Never assume Radix compatibility** (different API)

---

## With Tailwind

```typescript
<Dialog.Popup className="rounded-lg bg-white p-6 shadow-xl dark:bg-gray-800">
  <Dialog.Title className="text-xl font-bold text-gray-900 dark:text-white">
    Dialog Title
  </Dialog.Title>
  <Dialog.Description className="mt-2 text-gray-600 dark:text-gray-300">
    Dialog content here
  </Dialog.Description>
  <Dialog.Close className="mt-4 rounded bg-blue-500 px-4 py-2 text-white hover:bg-blue-600">
    Close
  </Dialog.Close>
</Dialog.Popup>
```

---

## Common Use Cases

### Use Case 1: Modal Dialog

```typescript
<Dialog.Root>
  <Dialog.Trigger className="btn">Open Modal</Dialog.Trigger>
  <Dialog.Portal>
    <Dialog.Backdrop className="fixed inset-0 bg-black/50" />
    <Dialog.Popup className="fixed left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 rounded-lg bg-white p-6">
      <Dialog.Title>Confirm Action</Dialog.Title>
      <Dialog.Description>Are you sure?</Dialog.Description>
      <Dialog.Close>Cancel</Dialog.Close>
    </Dialog.Popup>
  </Dialog.Portal>
</Dialog.Root>
```

### Use Case 2: Dropdown Select

```typescript
<Select.Root>
  <Select.Trigger className="flex items-center gap-2 rounded border px-4 py-2">
    <Select.Value placeholder="Select option" />
  </Select.Trigger>
  <Select.Portal>
    <Select.Positioner className="z-50">
      <Select.Popup className="rounded border bg-white shadow-lg">
        <Select.Option value="1" className="px-4 py-2 hover:bg-gray-100">
          Option 1
        </Select.Option>
        <Select.Option value="2" className="px-4 py-2 hover:bg-gray-100">
          Option 2
        </Select.Option>
      </Select.Popup>
    </Select.Positioner>
  </Select.Portal>
</Select.Root>
```

### Use Case 3: Tooltip

```typescript
import * as Tooltip from '@base-ui-components/react/tooltip';

<Tooltip.Root>
  <Tooltip.Trigger>Hover me</Tooltip.Trigger>
  <Tooltip.Portal>
    <Tooltip.Positioner>
      <Tooltip.Popup className="rounded bg-gray-900 px-2 py-1 text-sm text-white">
        Tooltip text
      </Tooltip.Popup>
    </Tooltip.Positioner>
  </Tooltip.Portal>
</Tooltip.Root>
```

---

## Beta Considerations

**Stable for production:**
- Dialog
- Popover
- Tooltip
- Select
- Accordion

**Use with caution:**
- NumberField (API may change)
- Complex form components

**Migration path:**
- v1.0 stable GA expected soon (currently v1.0.0-rc.0)
- Breaking changes will be documented
- Codemods likely provided

---

## vs Radix UI

| Feature | Base UI | Radix UI |
|---------|---------|----------|
| Pattern | Render props | asChild |
| Positioning | Floating UI built-in | Manual |
| Beta | Yes | Stable |
| Tree-shaking | Better | Good |
| Bundle size | Smaller | Larger |

**When to use Base UI:**
- Prefer render props
- Need built-in positioning
- Want smaller bundle
- Okay with beta

**When to use Radix:**
- Need stability
- Prefer asChild pattern
- Established ecosystem

---

## Resources

**References** (`references/`):
- `example-reference.md` - Detailed component examples and patterns
- `migration-from-radix.md` - Complete migration guide from Radix UI (includes render prop pattern explanation)
- `setup-guide.md` - Installation and setup walkthrough

**Templates** (`templates/`):
- `Accordion.tsx` - Accordion component with render props
- `Dialog.tsx` - Modal dialog example
- `NumberField.tsx` - Number input with validation
- `Popover.tsx` - Popover with positioning
- `Select.tsx` - Select dropdown
- `Tooltip.tsx` - Tooltip component
- `migration-example.tsx` - Radix to Base UI migration example

---

## Official Documentation

- **Base UI**: <https://base-ui.mui.com/>
- **Components**: <https://base-ui.mui.com/components/>
- **Migration Guide**: <https://base-ui.mui.com/base-ui/getting-started/migration/>

---

**Questions? Issues?**

1. Check `references/setup-guide.md` for setup
2. Review beta status warnings
3. See official docs for latest updates
4. Consider Radix if need stability

© secondsky · MIT · secondsky/claude-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
migrate-radix-to-base shadcn-ui Скилл migrate-radix-to-base для Claude Code переносит компоненты и проекты с Radix UI на Base UI. Запускается по просьбе заменить библиотеку или перенести отдельный компонент. CX Codex +1 37 800установок experience-lwc-base-components-integrate forcedotcom Скилл experience-lwc-base-components-integrate для Claude Code подбирает Lightning Base Component для задачи UI, загружает API из справочника и встраивает его в LWC без конфликтов со SLDS. CX Codex +1 2 800установок taiwan-md-knowledge-base reason-machines Скилл taiwan-md-knowledge-base для Claude Code ведёт открытую базу знаний о Тайване на Astro v5: статьи на китайском и английском, граф связей на D3.js. Помогает писать и переводить материалы для такого проекта. CX Codex +1 1 300установок mui-base pproenca 48 правил сборки headless-библиотек React-компонентов по стилю MUI Base UI. Логика и стили живут отдельно. CX Codex +1 341установок base-ui itechmeat Скилл обучает ИИ-ассистента собирать доступные UI-компоненты на базе @base-ui/react, настраивать оверлеи и работать с паттерном render prop. CX Codex +1 238установок base-ui-migrator pproenca Скилл base-ui-migrator переводит React-компоненты с Radix UI, Headless UI или самописных оверлеев на Base UI (@base-ui/react). Помогает стандартизировать интерфейс без потери стилей. CX Codex +1 144установок

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

Весь набор →
nextjs Скилл для работы с Next.js 16, React 19.2 и современными паттернами серверных компонентов, Server Actions и кэширования. Помогает при миграции с версии 15, ошибках async params и настройке Partial Prerendering. CX Codex +1 299установок feature-dev Скилл feature-dev для Claude Code ведёт разработку функции через семь фаз — от изучения кодовой базы до проверки результата. Охватывает многофайловые задачи и спорные архитектурные решения. CX Codex +1 294установок cloudflare-nextjs Скилл cloudflare-nextjs для Claude Code настраивает и развёртывает Next.js на Cloudflare Workers через OpenNext. Помогает переносить проект и разбирать ошибки среды Workers. CX Codex +1 267установок cloudflare-turnstile Скилл cloudflare-turnstile для Claude Code помогает добавить Turnstile и проверять токены на сервере. Подключается при настройке защиты форм или разборе ошибок виджета. CX Codex +1 261установок auto-animate Скилл показывает, как подключить @formkit/auto-animate в React для списков, аккордеонов и toast-уведомлений — анимация без конфигов, 3.28 КБ. CX Codex +1 257установок hono-routing Скилл hono-routing для работы с Hono: маршруты, middleware, валидация через Zod или Valibot, RPC-клиент с выводом типов. Помогает избежать 12 типичных ошибок при построении API. CX Codex +1 256установок pinia-colada Скилл pinia-colada для управления асинхронным состоянием в Vue и Nuxt через useQuery и useMutation. Помогает при кешировании, SSR, инвалидации кеша и миграции с TanStack Vue Query. CX Codex +1 253установок github-project-automation Скилл github-project-automation для Claude Code помогает настроить GitHub Actions, шаблоны задач и проверку безопасности репозитория. Также помогает искать ошибки в YAML и workflow. CX Codex +1 1установок

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

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