UI Handler
使用說明
1. 安裝標準元件(原子元件)
使用 Shadcn MCP 來處理基礎 UI 元素(按鈕、輸入框、對話框)。
- 操作:向 Shadcn MCP 發送指令以新增元件。
「使用 Shadcn MCP 新增按鈕與對話框元件。」
- 手動備援:
pnpm dlx shadcn@latest add {component}
2. 生成複雜區塊(區塊元件)
使用 21st.dev Magic MCP 處理高階區塊(登陸頁面、Hero 區塊、儀表板)。
- 操作:向 21st.dev MCP 提供描述。
「生成一個現代 SaaS Hero 區塊,包含暗色漸層背景與電子郵件收集表單。」
- 放置位置:將生成的檔案放置於
src/components/sections/或src/components/website/。 - 整合:在
page.tsx中匯入並使用這些元件。
3. 主題與樣式
使用 Shadcn MCP 或直接編輯 src/app/globals.css。
- 主題更新:要求 Shadcn MCP 套用特定主題或色彩配置。
「將應用程式主題更新為使用『zinc』中性基底搭配『blue』主色。」
- CSS 變數:我們在
src/app/globals.css中使用 CSS 變數(通常是 OKLCH)。確保任何新樣式都使用這些變數(例如bg-background、text-primary)。
4. 建立佈局
- 識別:Header、Sidebar、內容區域。
- 組合:使用來自
@/components/ui的原子元件以及來自@/components/sections的區塊元件。 - 就近放置:如果某個元件僅用於單一頁面,則將其放置在該頁面旁的
_components/資料夾中。
參考資料
如需詳細的架構與最佳實踐,請參閱 reference.md。