Repolode
nolly-studio

nolly-studio/cult-ui

基于 Tailwind CSS 和 Motion 的免费开源动画组件库,可直接集成到 shadcn/ui 项目中。

Star
6,629
Fork
350
未关闭 Issue
16
最近提交
6天前

这是什么?

Cult UI 是一套面向 shadcn/ui 项目的动画 React 组件库,包含 150 多个组件。每个组件都以 shadcn/ui registry 项的形式发布,通过 shadcn CLI 安装时会把源码复制到你的项目中,代码归你所有,可以直接修改。

组件使用 TypeScript 编写,样式基于 Tailwind CSS v4 和 shadcn 主题变量,大多数动画由 Motion 实现。每个文档页面都会列出该组件的依赖。安装方式有两种:直接用 CLI 指定单个组件的 JSON 地址,或在 components.json 中注册命名空间后按名称安装。

项目还提供适合编码代理阅读的 llms.txt 和 Markdown 格式文档,并提供 shadcn MCP 服务器,让 Cursor、Claude Code、VS Code 等编辑器可以通过自然语言搜索和安装组件。

核心功能

  • 01150 多个动画组件,可直接安装到 shadcn/ui 项目中
  • 02通过 shadcn CLI 安装,源码复制到项目内,便于自定义
  • 03基于 Tailwind CSS v4 和 shadcn 主题变量构建
  • 04多数组件使用 Motion 实现动画
  • 05文档提供 llms.txt 和逐页 Markdown,方便编码代理读取
  • 06提供 MCP 服务器,可在编辑器中搜索和安装组件

适用场景

  • 在 Next.js 落地页中加入带动画的卡片、地球、仪表盘等模块
  • 在 shadcn/ui 应用中快速原型化界面动效,无需从零编写动画代码
  • 让 AI 编程助手通过 MCP 服务器查找并安装 UI 组件

快速上手

  1. 1

    使用 shadcn CLI 从注册表 URL 安装组件

    npx shadcn@latest add https://www.cult-ui.com/r/shift-card.json
  2. 2

    或者在 components.json 中注册 @cult-ui 命名空间,然后按名称安装

    npx shadcn@latest add @cult-ui/shift-card

使用前须知

  • 组件专为使用 Tailwind CSS v4 的 shadcn/ui 项目设计,且大多数依赖 Motion 动画库。

标签

常见问题

cult-ui 是什么?
基于 Tailwind CSS 和 Motion 的免费开源动画组件库,可直接集成到 shadcn/ui 项目中。 Cult UI 是一套面向 shadcn/ui 项目的动画 React 组件库,包含 150 多个组件。每个组件都以 shadcn/ui registry 项的形式发布,通过 shadcn CLI 安装时会把源码复制到你的项目中,代码归你所有,可以直接修改。
cult-ui 可以免费使用吗?用的什么许可证?
cult-ui 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
cult-ui 还在维护吗?
活跃维护中。cult-ui 最近一次提交是在 2026年10月14日。
cult-ui 适合用来做什么?
在 Next.js 落地页中加入带动画的卡片、地球、仪表盘等模块 在 shadcn/ui 应用中快速原型化界面动效,无需从零编写动画代码 让 AI 编程助手通过 MCP 服务器查找并安装 UI 组件
cult-ui 怎么安装和运行?
使用 shadcn CLI 从注册表 URL 安装组件: npx shadcn@latest add https://www.cult-ui.com/r/shift-card.json 或者在 components.json 中注册 @cult-ui 命名空间,然后按名称安装: npx shadcn@latest add @cult-ui/shift-card
在哪里获取 cult-ui?
源代码和安装说明在 GitHub 上:https://github.com/nolly-studio/cult-ui

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目