デザイン & UI
意図的でプレミアム感のあるインターフェースを作成します。テンプレート的な凡庸なものにしないでください。これはアプリビルダーにおける最も重要な品質向上のレバーです。DOM / オーバーレイ UI(ページ、クローム、HUD、メニュー、フォーム)に適用します。(3Dゲームのゲームプレイキャンバスについては、building-gamesスキルを参照してください。このスキルはその上に重なるDOM UIを統轄します。)
詳細は references/ を参照してください(必要に応じて読み込まれます。すべてをインライン化しないでください):
references/refined-ui.md— 完全なプロダクトクローム/オーバーレイデザインシステム。references/typography.md— タイプスケール、ペアリング、リズム。references/surfaces.md— エレベーション、ボーダー、シャドウ、レイヤリング。references/animations.md— モーション、イージング、トランジション。references/performance.md— UIをスムーズに保つ(60fps、カクつきなし)。
1. デザインシステムファースト(何かをスタイリングする前に行うこと)
システムを一度定義し、それから組み立てます。アドホックな値を散りばめてはいけません。
- CSSのトークン(Tailwind v4はCSSファースト)。 パレット、半径、フォントを
src/styles.cssの@theme配下にCSS変数として配置し、Tailwindユーティリティとして利用します。唯一の情報源とします。@import "tailwindcss"; @theme { --color-bg: #0b0b0f; --color-surface: #16161d; --color-fg: #e7e7ea; --color-muted: #a0a0ab; --color-primary: #14b8a6; --color-border: #26262f; --radius: 0.75rem; --font-sans: "Inter", system-ui, sans-serif; } - shadcn/ui コンポーネントを使用します(Radixプリミティブ +
cvaバリアント +tailwind-merge)。ボタン、ダイアログ、ドロップダウン、入力などに使用します。これらはアクセシブルで一貫性があります。src/components/uiに生成し、インラインの16進数値ではなくトークンでスタイリングします。 - Tailwind v4 ベースの修正 — ボタンにはポインターカーソルが必要です。 v4のPreflightは
<button>に対してcursor: defaultを設定し、動作が壊れているように感じられます。これをsrc/styles.cssに一度追加して、ボタン/クリック可能なロールがポインターを表示するようにします:@layer base { button:not(:disabled), [role="button"]:not(:disabled) { cursor: pointer; } } - アドホックなスタイリングを禁止:JSX内の生の16進数値、
text-white/bg-blackリテラル、p-[16px]やtext-[13px]のような任意の値は使用禁止です。値が必要な場合は、トークンまたはスケールステップにします。
2. 定量化されたルーブリック(「ダサさ」を防ぐ簡単なルール)
- 最大3~5色(プライマリ1色+ニュートラル+最大1アクセント)。ランダムな追加色は禁止。特に指定がない限り、デフォルトでパープルにしないでください。
- 最大2フォントファミリー(多くの場合は1つ)。ディスプレイ/見出しとボディを組み合わせるか、1つに統一します。
- 行の高さ1.4~1.6(ボディテキスト)。大きな見出しではさらにタイトにします。
- 背景色をオーバーライドするときは、前景/テキストの色もオーバーライドします(コントラストを維持する必要があります。ライトモードとダークモードの両方を確認してください)。
- モバイルファースト:最初に約390pxのレイアウトをデザインし、その後スケールアップします。水平方向のオーバーフローを禁止。タップターゲットは44px以上。
- 一貫したスペーシングスケール(4/8ベース)。タップリなホワイトスペースが詰め込みより優先されます。
- 1つのアクセントを控えめに使用し、主要なアクションに限定します。あらゆる場所に使用しないでください。
3. アンチAIスロップ(出力を凡庸に見せる兆候 — 避けるべきもの)
- グラデーションブロブのフィラー、コンテンツの代わりとなる巨大なヒーローグラデーションは禁止。
- アイコンとしての絵文字は禁止 — 実際のアイコンセット(
lucide-react)を使用してください。 - 手描きSVGのイラスト/地図/チャートは禁止 — 実際のライブラリ(チャートには
recharts)または実際に生成された画像を使用してください。 - 最終製品におけるプレースホルダー画像/薄グレーのボックスは禁止 — 実際の画像を生成するか、実際のコンテンツを使用してください。キャンバス画像には
crossOrigin="anonymous"を設定してください。 - 多用されすぎたフォントの見た目(デフォルトのシステムフォントのみ、またはComic Sansレベルの選択)を避けてください。
- すべての要素はその場所に値するものでなければなりません。 装飾的なノイズを削減してください。システムを確立し、意図を持って変化させるのであって、ランダムに行ってはいけません。
- アプリを編集する際は既存のUIに合わせてください。2番目のビジュアル言語を持ち込まないでください。
4. レイアウト & 階層
- 明確な視覚的階層:ビューごとに1つのプライマリアクション。サイズ/ウェイト/カラーで重要度を表現します。
references/typography.mdとreferences/surfaces.mdを参照してください。 - 実際のレイアウト構造(グリッド/フレックス、コンテナ最大幅)を使用し、絶対配置のハックは使用しないでください。一貫したグリッドに合わせてください。
- 空の状態、ローディング状態、エラー状態はデザインの一部です。空/ギクシャクした中間状態を出荷しないでください。
5. モーション(控えめで、目的を持った)
- ホバー/プレス/エントリー時には、短くイージングされたトランジション(150~250ms)。
prefers-reduced-motionを尊重します。詳細はreferences/animations.mdにあります。 - カクつきの原因となる方法でレイアウトをアニメーション化しないでください。transform/opacityを優先します。
6. ゲームオーバーレイ(building-games と組み合わせる場合)
ゲームプレイキャンバスは building-games が所有します。このスキルはDOMオーバーレイ(スタート/「クリックしてプレイ」画面、HUD、スコア、メニュー、ポーズ、モバイルコントロール)のスタイリングを行います。オーバーレイはキャンバス上で読みやすくし(背景、コントラスト)、ポインターロック/ゲームプレイの入力パスから外してください。
完了チェックリスト(UI完了と呼ぶ前に行うこと)
- トークンが
@themeで定義されている。JSX内にアドホックな16進数値や任意の値がないこと。 - 5色以下、2フォント以下、一貫したスペーシングスケール。
- コントラストが維持されている。背景をオーバーライドした場所では前景もオーバーライドされていること。
- モバイル(約390px)でオーバーフローがないこと。ターゲットは44px以上。
- 実際のアイコン/画像/チャート — アンチスロップの兆候がないこと。
- ローディング/空/エラー状態が処理されている。モーションは控えめで、モーション軽減設定に対応していること。
- ブラウザでレンダリングされ、目視確認されていること(AGENTS.mdの確認手順を参照)。単なるcurlではないこと。