技能: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 的 props(例如 whileHover、transition)擴展現有組件。 |
執行步驟
- 驗證先決條件:檢查
package.json中是否包含framer-motion(或motion)和tailwind-merge。 - 初始設定:如果尚未完成,請遵循
shadcn/ui的初始化流程。 - 選擇組件:判斷需要的是原始組件(邏輯 + 基礎動畫)還是組件(已樣式化的 UI 元件)。
- 安裝:使用 shadcn CLI,搭配
@animate-ui範圍套件名稱。 - 整合:從
@/components/animate-ui/...匯入,並傳遞必要的 props。 - 打磨:調整彈簧過渡效果(stiffness、damping)以符合專案的整體感覺。
輸出合約
- 透過 shadcn CLI 新增的組件清單。
- 在實作中驗證過的匯入路徑。
- 如有任何自訂動畫調整的說明。
參考資料
references/getting-started.md— 安裝與設定指南。references/components.md— 類別與命名慣例。references/motion-patterns.md— 常見的彈簧與過渡設定。