用途:查找并安装 KokonutUI 的 React 组件到目标项目,同时阅读组件源码与文档。KokonutUI 是包含 100 多个开源 React 组件的集合,基于 Next.js、React、Tailwind CSS v4 与 Motion 构建。组件不以 npm 包形式发布,而是通过 shadcn CLI 以源码形式复制进项目,安装后可自由编辑。
主要能力与发现方式:https://kokonutui.com/r/registry.json 是可机器读取的索引,列出所有可安装组件及其依赖和文件列表;https://kokonutui.com/llms.txt 是文档索引,每行一个组件并附 Markdown 源码链接;https://kokonutui.com/r/{name}.json 是单个组件的完整注册表条目,包含其全部文件源码。搜索文档时可请求任意文档页并带 Accept: text/markdown(或在 URL 后加 .md)以获得干净的 Markdown。
使用方式:若有 shadcn MCP 服务器,可直接浏览并安装组件,它开箱即支持 @kokonutui 注册表。否则使用 shadcn CLI 的 @kokonutui 命名空间:npx shadcn@latest add @kokonutui/card-flip,将 card-flip 替换为 registry.json 中的任意名称。CLI 会自动解析组件的 registryDependencies(如 button、textarea 等 shadcn/ui 原语)与 npm 依赖(如 motion、lucide-react)。
前置条件:目标项目需配置 Tailwind CSS v4;已初始化 shadcn/ui(npx shadcn@latest init),从而存在 components.json 与 lib/utils.ts 中的 cn 工具;使用现代 React 特性的组件需 React 19 或更高版本。
安装后:组件默认落在 components/kokonutui/{name}.tsx,是普通源码,应直接编辑而非包裹。组件的 props 与用法示例见其文档页。许可证为 MIT,可用于、修改并发布到商业项目。