ベースラインUI は何をしますか?
AIが生成するインターフェースの「スロップ」を防ぐための、意見に基づいたUIベースラインを強制します。
使用方法
-
/baseline-uiこの会話内のすべてのUI作業にこれらの制約を適用します。 -
/baseline-ui <file>以下のすべての制約に対してファイルをレビューし、以下を出力します:- 違反箇所(正確な行またはスニペットを引用)
- 重要である理由(簡潔な一文)
- 具体的な修正(コードレベルの提案)
スタック
- MUST: カスタム値がすでに存在するか明示的に要求されていない限り、Tailwind CSSのデフォルトを使用する
- MUST: JavaScriptアニメーションが必要な場合は
motion/react(旧framer-motion)を使用する - SHOULD: Tailwind CSSでのエントランスアニメーションやマイクロアニメーションには
tw-animate-cssを使用する - MUST: クラスロジックに
cnユーティリティ(clsx+tailwind-merge)を使用する
コンポーネント
- MUST: キーボード操作やフォーカス動作を伴うものにはアクセシブルなコンポーネントプリミティブ(
Base UI、React Aria、Radix)を使用する - MUST: 既存のプロジェクトのコンポーネントプリミティブを優先して使用する
- NEVER: 同じインタラクションサーフェス内でプリミティブシステムを混在させない
- SHOULD: スタックと互換性がある場合、新しいプリミティブには
Base UIを優先する - MUST: アイコンのみのボタンに
aria-labelを追加する - NEVER: 明示的に要求されない限り、キーボード操作やフォーカス動作を手動で再構築しない
インタラクション
- MUST: 破壊的または取り消し不能なアクションには
AlertDialogを使用する - SHOULD: ローディング状態には構造的なスケルトンを使用する
- NEVER:
h-screenを使用せず、代わりにh-dvhを使用する - MUST: 固定要素には
safe-area-insetを尊重する - MUST: エラーはアクションが発生した場所の近くに表示する
- NEVER:
inputまたはtextarea要素でのペーストをブロックしない
アニメーション
- NEVER: 明示的に要求されない限り、アニメーションを追加しない
- MUST: コンポジター・プロパティ(
transform、opacity)のみをアニメーション化する - NEVER: レイアウト・プロパティ(
width、height、top、left、margin、padding)をアニメーション化しない - SHOULD: ペイント・プロパティ(
background、color)のアニメーションは、小さなローカルUI(テキスト、アイコン)の場合を除き避ける - SHOULD: エントランスには
ease-outを使用する - NEVER: インタラクションフィードバックは
200msを超えないようにする - MUST: ループするアニメーションは画面外で一時停止する
- SHOULD:
prefers-reduced-motionを尊重する - NEVER: 明示的に要求されない限り、カスタムのイージング曲線を導入しない
- SHOULD: 大きな画像や全画面サーフェスのアニメーションを避ける
タイポグラフィ
- MUST: 見出しには
text-balanceを、本文/段落にはtext-prettyを使用する - MUST: データには
tabular-numsを使用する - SHOULD: 密度の高いUIには
truncateまたはline-clampを使用する - NEVER: 明示的に要求されない限り、
letter-spacing(tracking-*)を変更しない
レイアウト
- MUST: 固定の
z-indexスケールを使用する(任意のz-*は使用しない) - SHOULD: 正方形の要素には
w-*+h-*の代わりにsize-*を使用する
パフォーマンス
- NEVER: 大きな
blur()またはbackdrop-filterサーフェスをアニメーション化しない - NEVER: アクティブなアニメーション以外で
will-changeを適用しない - NEVER: レンダーロジックとして表現できるものに
useEffectを使用しない
デザイン
- NEVER: 明示的に要求されない限り、グラデーションを使用しない
- NEVER: 紫色またはマルチカラーのグラデーションを使用しない
- NEVER: グローエフェクトを主要なアフォーダンスとして使用しない
- SHOULD: 明示的に要求されない限り、Tailwind CSSのデフォルトのシャドウスケールを使用する
- MUST: 空の状態には明確な次のアクションを1つ提示する
- SHOULD: アクセントカラーの使用はビューごとに1つに制限する
- SHOULD: 新しい色を導入する前に、既存のテーマまたはTailwind CSSのカラートークンを使用する