Skip to main content
skill CX Codex

base-ui-react — Claude Code skill for React components

base-ui-react is a Claude Code skill for building MUI Base UI interfaces, configuring accessible components and popup positioning, and migrating from Radix UI.

MIT 259 installs ★ 250 updated 2026-10-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add secondsky/claude-skills --skill base-ui-react -a claude-code
Open on GitHub

What base-ui-react does

This skill covers MUI Base UI, an unstyled component library for React. It explains components such as dialogs, selects and tooltips, the render props pattern, and positioning with Floating UI. The package also includes component templates and references, including a guide to migrating from Radix UI.

Popup elements need a Portal and Positioner, while modal dialogs need a Backdrop. Base UI is at Release Candidate stage, so its API may change. React 19 or later is required; projects on earlier React versions cannot use this setup.

What it helps with

  • build an accessible modal dialog with Base UI
  • position a dropdown or tooltip with Floating UI
  • replace Radix UI patterns with render props
  • style Base UI components with CSS or Tailwind

Example prompts for the agent

  • Build an accessible confirmation dialog with MUI Base UI, using a Portal and Backdrop.
  • Migrate my Radix UI component to Base UI and use render props.
  • Check whether the dropdown uses Portal and Positioner correctly.

How to install base-ui-react

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/base-ui-react/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about base-ui-react

How do I install base-ui-react in Claude Code?

Run npx skills add secondsky/claude-skills --skill base-ui-react -a claude-code. The skill file is available at ~/.claude/skills/base-ui-react/SKILL.md.

What does base-ui-react do?

It guides you through building interfaces with MUI Base UI, including dialogs, selects and floating elements. It also covers render props and migration from Radix UI.

Which React version does base-ui-react require?

Base UI requires React 19 or later. Its API is still subject to change because the library is a Release Candidate.

Source text

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

Similar skills

All skills for Frontend and UI →

From the same set138

The whole set →
nextjs Skill for Next.js 16 and React 19.2 with App Router, Server Components, Server Actions, and caching patterns. Handles migration from version 15, async params errors, and Partial Prerendering setup. CX Codex +1 299installs feature-dev The feature-dev skill guides feature work through seven phases, from codebase discovery to review. Use it for multi-file changes and unclear architecture decisions. CX Codex +1 294installs cloudflare-nextjs The cloudflare-nextjs skill guides Next.js deployments to Cloudflare Workers with OpenNext. Use it to migrate a project or troubleshoot Workers-specific configuration and runtime issues. CX Codex +1 267installs cloudflare-turnstile cloudflare-turnstile is a Claude Code skill for adding Turnstile and checking tokens on the server. It activates for bot protection work, widget errors, and CSP or token validation failures. CX Codex +1 261installs auto-animate Shows how to wire up @formkit/auto-animate in React for lists, accordions and toasts. Animations with zero config, 3.28 KB gzipped. CX Codex +1 257installs hono-routing hono-routing — a skill for building Hono APIs: routes, middleware, Zod or Valibot validation, RPC client with type inference. Covers 12 common errors and their solutions. CX Codex +1 256installs pinia-colada Brings Pinia Colada data fetching into Claude Code and other AI editors. Handles async state, query caching, SSR, and migration from TanStack Vue Query with useQuery and useMutation. CX Codex +1 253installs github-project-automation github-project-automation is a Claude Code skill for setting up GitHub Actions, repository templates, CodeQL, and Dependabot. It helps start projects and troubleshoot workflow YAML. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open