技能:animate-ui
激活契约
在以下情况下使用此技能:
- 使用 Animate UI 分发库添加或自定义动画 UI 组件。
- 在 shadcn/ui 项目中实现 Motion(Framer Motion)驱动的模式。
- 设置 Animate UI 注册表或添加特定的原语/组件。
硬性规则
- 复制优先方法:始终将组件视为“开放代码”进行复制和修改,而非固定的库导入。
- 依赖检查:在添加组件前,确保已安装
motion、tailwind-merge、clsx和lucide-react。 - 命名约定:对于 shadcn CLI 命令,遵循
@animate-ui/{类别}-{子类别}-{名称}模式。 - 导入路径:所有添加的组件和原语默认导入路径为
@/components/animate-ui/。 - 标准技术栈:使用 React、Tailwind CSS 和 Framer Motion (Motion)。
决策门
| 任务 | 操作 |
|---|---|
| 新项目 | 运行 npx shadcn@latest init,然后配置 Tailwind/Motion。 |
| 添加原语 | 使用 npx shadcn@latest add @animate-ui/primitives-{类别}-{名称}。 |
| 添加组件 | 使用 npx shadcn@latest add @animate-ui/components-{类别}-{名称}。 |
| 自定义 Motion | 使用 motion 属性(例如 whileHover、transition)扩展现有组件。 |
执行步骤
- 验证先决条件:检查
package.json中是否包含framer-motion(或motion)和tailwind-merge。 - 初始设置:如果尚未完成,请遵循
shadcn/ui的初始化过程。 - 组件选择:确定是需要一个原语(逻辑 + 基础动画)还是一个组件(带样式的 UI 部件)。
- 安装:使用 shadcn CLI 并指定
@animate-ui作用域包名。 - 集成:从
@/components/animate-ui/...导入并传递必要的属性。 - 打磨:调整 spring 过渡(刚度、阻尼)以匹配项目的整体感觉。
输出契约
- 通过 shadcn CLI 添加的组件列表。
- 已验证的实现中的导入路径。
- 如有任何自定义运动调整,需提供相应解释。
参考
references/getting-started.md— 安装和设置指南。references/components.md— 类别和命名约定。references/motion-patterns.md— 常见的 spring 和过渡设置。