shadcn/ui
コンポーネントを npm 依存ではなくソースとして components/ui/ へコピー配布する React UI 集と、その導入・配布を担う shadcn CLI のリファレンス。
対象バージョン
- shadcn CLI 4.22.0(GitHub release tag
shadcn@4.22.0、commit ad0a097d30cf9524ac4a3b5294c9513c5c344672、2026-10-16)
- Markdown twin(
https://ui.shadcn.com/<path>.md)を 2026-10-16 に取得。preview ページを除き、タグ時点の .mdx とバイト一致を確認済み
- 同梱パッケージ:
@shadcn/react 0.3.1 / @shadcn/helpers 0.3.0 / @shadcn/registry 0.2.0
- ドキュメントサイトの依存(タグ時点):
@base-ui/react 1.6.0 / radix-ui ^1.4.3 / react-aria-components 1.20.0 / tailwindcss ^4.3.0 / react 19.2.3
- canary / beta / rc は対象外
ディレクトリ構成
skills/shadcn-ui/
SKILL.md
references/
getting-started/ # 15 ページ: introduction, installation, manual, フレームワーク別 (next, vite, astro, ...), tailwind-v4, react-19
README.md
cli-config/ # 7 ページ: cli, components-json, package-imports, monorepo, skills, mcp, figma
README.md
theming/ # 14 ページ: theming, dark-mode-*, rtl-*, typeset, shimmer, scroll-fade
README.md
forms/ # 5 ページ: forms, react-hook-form, tanstack-form, formisch, next
README.md
components-form/ # 17 ページ: button, input, select, checkbox, field, calendar, date-picker, combobox, ...
README.md
components-display/ # 20 ページ: card, table, data-table, chart, carousel, sonner, toast, typography, ...
README.md
components-layout/ # 11 ページ: sidebar, tabs, accordion, navigation-menu, resizable, direction, ...
README.md
components-overlay/ # 11 ページ: dialog, alert-dialog, sheet, drawer, popover, dropdown-menu, command, ...
README.md
components-chat/ # 8 ページ: message, bubble, message-scroller, questionnaire, trace, code-block, ...
README.md
ai-elements/ # 22 ページ: ai-elements, chat, message, prompt-input, tool, reasoning, ...
README.md
registry/ # 15 ページ: registry, getting-started, registry-json, registry-item-json, namespace, mcp, ...
README.md
packages/ # 4 ページ: helpers-ai-sdk, helpers-tanstack-ai, react-message-scroller, react-questionnaire
README.md
samples/
README.md
nextjs-init-and-first-component.md
form-react-hook-form-zod.md
form-tanstack-form-zod.md
form-server-actions-nextjs.md
data-table-tanstack-table.md
dark-mode-next-themes.md
sidebar-app-layout.md
chat-ui-ai-sdk-helper.md
custom-registry-build.md
github-registry.md
monorepo-setup.md
scripts/
README.md
install.md
cli.md
mcp.md
registry.md
探索手順
タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:
- 下記マッピング表でタスクに対応するカテゴリを探す
- そのカテゴリの
references/{category}/README.md を参照して目的のページを特定する
- 該当ページの
.md を Read して詳細を確認する
- 動く実例は
samples/、コピペ実行できるコマンドは scripts/ の README から引く
ark-ui / chakra-ui / fandhe-frontend との使い分け
components-* と ai-elements の各ページは、ark-ui(ヘッドレス)・chakra-ui(スタイル付き)・fandhe-frontend(Rust)と同名のコンポーネントを扱う。shadcn/ui は npm パッケージではなくコピー配布で、ソースは components/ui/ に置かれる。import 元(@/components/ui/...)で区別する。
タスク → カテゴリ マッピング