baseline-ui
執行意見化的 UI 基準,利用 Tailwind CSS、Radix UI 和 Framer Motion 確保介面一致性、無障礙與高效能,防止設計品質劣化。
簡介
baseline-ui 技能是前端開發的架構守護者,確保 UI 實作維持極高的無障礙性、效能與視覺一致性。專為現代 React 與 Tailwind CSS 專案的開發者與 AI 代理設計,透過系統化的組件構建與互動規則,消除了設計中的不一致(如隨意的間距、不連貫的焦點狀態與管理不當的動畫),確保所有 UI 成果符合業界標準。
-
強制執行組件原始基準,使用 Radix UI、Base UI 或 React Aria 來實現鍵盤導航與螢幕閱讀器相容性。
-
實作嚴格的動畫準則,優先使用複合屬性 (transform, opacity) 並限制動畫影響排版屬性,以維持 60fps 的效能。
-
透過 'cn' 工具 (clsx + tailwind-merge) 標準化類別邏輯,避免樣式衝突並維護整潔的 CSS。
-
提供命令列介面 (/baseline-ui <file>),針對指定檔案自動審核是否符合規範,指出違規事項並提供具體修復建議。
-
規定無障礙設計模式,例如圖示按鈕必須包含 aria-label,並確保用戶操作錯誤時有明確的顯示邏輯。
-
確保響應式 UI 的安全性,強制使用 h-dvh 取代 h-screen,並正確遵循 safe-area-inset。
-
透過規範 text-balance、text-pretty 與固定 z-index 比例,統一字體排版與層級,防止設計失控。
-
適用於管理複雜的 Astro/React 專案 UI 開發,確保樣式與效能的一致性。
-
在互動對話中使用 '/baseline-ui' 指令套用規範,使用 '/baseline-ui <file>' 進行具體的程式碼稽核。
-
在 Tailwind CSS 4.x 與 Framer Motion 環境下執行效果最佳,應避免使用自訂曲線或大型排版動畫。
-
確保所有互動回饋均保持在 200ms 延遲閾值內,以達成最佳使用者體驗。
-
嚴格禁止使用 'useEffect' 處理本應在渲染階段完成的邏輯,以提升應用程式效能。
倉庫統計
- Star 數
- 0
- Fork 數
- 0
- Open Issue 數
- 0
- 主要語言
- MDX
- 預設分支
- main
- 同步狀態
- 閒置
- 最近同步時間
- 2026年5月3日 下午10:33