| name | shadcn-base |
| description | Use when you need the Base UI version of shadcn/ui components, docs, CLI, theming, forms, registries, or MCP guidance for shadcn’s Base UI stack. |
shadcn/ui (Base UI) — shadcn-base
Overview
This skill documents the Base UI version of shadcn/ui. Use it to navigate the official Base UI docs and the shadcn/ui Base UI component pages.
shadcn/ui is not headless. It provides styled, copy-and-own components built on top of Base UI’s headless primitives. Composition follows compound components, composition-over-inheritance, and variant-driven styling.
Primary docs:
Important:
- Base UI vs Radix docs and the conversion rule are defined in
references/overview.md. Use that guidance instead of the Radix components index.
Start Here
- Read
references/overview.md for scope and doc entry points.
- Use
references/components.md to find the component you need.
- Use
references/installation.md or references/cli.md to set up a project.
- Use
references/theming.md and references/dark-mode.md for design tokens.
- Use
references/components-json.md for CLI config details.
- Use
references/forms.md for field patterns and references/forms-integrations.md for form libs.
- Use
references/registry.md and references/registry-schema.md for registries.
- Use
references/blocks.md for blocks workflows.
- Use
references/composition-pattern.md for the composition paradigm and Base UI render rule.
- Use
references/examples.md for render and useRender patterns.
- Check
references/changelog.md before shipping.
Composition Pattern (Short)
Base UI + shadcn/ui uses copy-and-own styled components on headless primitives, composed via compound subcomponents and render-prop substitution (render / useRender). Reference: references/composition-pattern.md.
Reference Map
references/overview.md: what shadcn/ui is and official doc entry points.references/components.md: full component list from llms.txt.references/installation.md: create/init and per-framework installation links.references/cli.md: CLI commands and options.references/components-json.md: components.json schema and key fields.references/theming.md: theming and design tokens.references/dark-mode.md: dark mode guidance and framework-specific pages.references/forms.md: field usage patterns and validation structure.references/forms-integrations.md: React Hook Form and TanStack Form pages.references/registry.md: registry docs.references/registry-schema.md: registry.json and registry-item.json schema details.references/blocks.md: blocks library workflows.references/composition-pattern.md: Base UI composition rule (render/useRender only).references/examples.md: render and useRender examples (Base UI).references/mcp.md: MCP server guidance.references/changelog.md: release notes.references/links.md: quick links index.
