nolly-studio/cult-ui
开发工具面向 React 与 Next.js 开发者的开源动画组件库,提供 150+ 个 shadcn/ui 组件。
项目介绍
Cult UI 是一套 MIT 许可的动画 React 组件,用来扩展 shadcn/ui。目标用户是 React、Next.js 和 Tailwind CSS 方向的设计工程师与前端团队。项目提供 150+ 个组件,每个组件以 shadcn registry item 的形式分发,而不是发布成 npm 包;CLI 会把组件源码复制进你的项目,代码归你所有。
组件基于 Tailwind CSS v4 和 shadcn 主题 token,大部分动画由 Motion (10) 实现。组件覆盖卡片、Dock、设备模型、图表、看板等场景,每个组件的文档页都会列出它自己的依赖。
快速使用
推荐做法是在已有的 shadcn/ui 项目中用 shadcn CLI 安装单个组件:
npx shadcn@latest add https://www.cult-ui.com/r/shift-card.json
也可以在 components.json 中一次性注册命名空间,然后按名称安装:
{
"registries": {
"@cult-ui": "https://www.cult-ui.com/r/{name}.json"
}
}
npx shadcn@latest add @cult-ui/shift-card
执行后,组件源码会被放入你的项目。前置条件、环境准备和排错步骤写在安装文档 (6) 中;README 没有复述这些步骤,开始添加组件前应先阅读该页面。
浏览与文档
组件目录 (4) 和文档 (5) 提供预览与用法说明。文档也面向编程 Agent 发布:llms.txt 索引所有页面,llms-full.txt 汇总完整文档,给文档 URL 加上 .md 会返回干净的 Markdown。项目还提供 MCP server (52),让 Cursor、Claude Code 和 VS Code 能通过提示词搜索并安装组件。
使用约束
- 组件面向使用 Tailwind CSS v4 的 shadcn/ui 项目;依赖其他 Tailwind 主版本时需要自行适配。
- 动画依赖 Motion,每个组件的额外依赖列在对应文档页。
- 安装通过
npx shadcn@latest进行,需要可用的 Node.js 环境和已初始化的 shadcn 项目。 - 组件会复制进你的仓库,后续升级需要你参照变更日志 (7) 自行维护。
HotRepo 点评
在 2026-11-15 的 TypeScript 日榜上,Cult UI 新增 120 星,排在第 9 位,累计 7,439 星、398 个 fork。HotRepo 没有记录到该项目的全语言日榜名次,因此这个数字反映的是单一语言榜的一次快照,而不是更大范围的趋势。值得关注的细节是 registry 式分发:它让组件紧贴 shadcn 工作流,同时保持 MIT 许可,并由工作室的其他付费产品支撑项目持续维护。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- Caho1/open-claude-ui把 Claude 官方桌面端的设计系统与动效物理逆向还原成 React 组件库,供人直接抄用。
- kevintngo/looseleaf一套手绘纸张风格的 React 组件库,提供 123 个可访问组件并通过 shadcn 注册表分发。
- DavidHDev/react-bits提供可直接拷进项目的动画 React 组件,让开发者不必从零手写打磨好的界面动效。
- meta/astryx面向 React 19+ 的设计系统,提供 150+ 无障碍组件和可主题化样式,同时服务开发者与 AI 编程助手。
- saadeghi/daisyui面向 Tailwind CSS 开发者的组件库,提供现成的 UI 类名和主题。