项目概览
Cult UI 是 nolly-studio 开发的开源前端组件集，提供 60+ 动效丰富、可定制的 UI 组件，兼容 shadcn/ui 生态，采用"复制即拥有"的分发模式。它解决的核心问题是 shadcn/ui 只提供无样式底层原语，当产品需要"好看"和"有动效"的组件时，开发者需从零编写。Cult UI 通过 shadcn registry CLI 分发源码，组件代码复制到项目后完全归开发者所有，可自由定制。技术栈为 React + TypeScript + Tailwind CSS v4 + motion。项目还提供 AI SDK Agents（92+ 免费 Agent 模式）、Cult Pro（129 个付费 Block 和 10 个 Starter Template）以及 MCP Server，覆盖从组件到产品的完整链路。
解决什么问题
Cult UI 解决的核心问题是：shadcn/ui 提供了无样式的底层原语，但当产品需要"好看"和"有动效"的组件时，开发者得从零写起。Cult UI 补上了这一层。在 Cult UI 出现之前，前端动效组件开发存在六大痛点：shadcn/ui 只给原语不给设计；动效组件从零写成本高；Design Engineer 缺乏中间层；npm 组件库"黑盒"问题；AI 时代缺少可组合的 Agent UI；从原型到生产的断层。
工作方式
Cult UI 不是传统 npm 组件库，而是一套源码级组件集合，专为 shadcn/ui 项目设计。组件通过 shadcn 的 registry 协议分发，在 components.json 中配置 Cult UI 的 registry URL 后，可用 npx shadcn add cult-ui/xxx 安装。安装过程本质上是：CLI 从 registry 下载组件源码，按项目结构调整代码，安装必要依赖（如 motion），把源码复制到项目中。Cult UI 不重复造轮子，复用 shadcn 的主题变量、cn() 工具函数和组件模式，只负责在上层加动效和视觉。动效系统分三个层次：Layout 动画（motion 的 layout prop）、入场/退场（AnimatePresence）、背景动画（CSS @keyframes / Canvas）。视觉系统采用噪声纹理、毛玻璃效果、新拟态、渐变流动、Shader 效果等技术。项目还提供 MCP Server，允许 AI 编码助手直接查询组件信息、获取安装代码。
核心能力
-
- 动效丰富、可定制的 UI 组件，按 13 个类别组织
- 源码复制模式，代码完全拥有，无黑盒依赖
- 动效默认开启，每个组件都带精心设计的动画
- 与 shadcn/ui 无缝兼容，复用其主题变量和工具函数
-
- AI Agent 交互模式，覆盖数据分析、竞品研究等场景
- MCP Server 集成，AI 编码助手可直接查询和使用组件
- Cult Pro 提供 129 个付费 Block 和 10 个 Starter Template
- 提供 Full-Stack 模板，从 Landing Page 到 SaaS 平台
- MIT 开源协议，免费使用
- TypeScript 原生，类型安全
使用前需要了解
- AI 整理 · 本地测试，未经人工复核；依据历史报告节选，不代表当前产品状态。
- Cult UI 仅支持 React，不支持 Vue、Svelte 等其他框架；强依赖 Tailwind CSS，不使用 Tailwind 的项目无法使用；动效组件的无障碍支持相对薄弱，不适合需要严格 WCAG AA/AAA 合规的政务/金融系统；部分复杂组件依赖 WebGL 或 Canvas，在低端设备上可能出现性能问题；源码复制是一次性操作，不会自动更新，需要手动跟进新版本；Cult Pro 高级 Blocks 和模板需要付费，免费版功能有限；部分组件可能不支持 RTL，不适合需要 RTL 支持的国际化产品。
