awwwards-ui-skills

Awwwards UI スキル

AI エージェントで Awwwards 風のインターフェースを構築するための、推奨事項を含む制約です。

適用するタイミング

以下の場合に、このガイドラインを参照してください。

• ライトモードのインターフェースを構築するとき
• Awwwards にインスパイアされたデザインシステムを作成するとき
• Inter フォントと 4px グリッドを使って UI を実装するとき

色

• プライマリサーフェスにはライトカラーの背景を使用することを推奨します
• ページの背景（surface-base）には #E4E4E4 を使用する必要があります
• カラーパレットを減らすことを推奨します（現在は 15 色が検出されています）
• アクセシビリティのため、テキストのコントラスト比を少なくとも 4.5:1 に保つ必要があります

セマンティックトークン

トークン	HEX	RGB	用途
surface-base	#E4E4E4	rgb(228,228,228)	ページの背景
surface-raised	#2F2E30	rgb(47,46,48)	カード、モーダル、浮き上がったサーフェス
surface-overlay	#191919	rgb(25,25,25)	オーバーレイ、ツールチップ、ドロップダウン
text-primary	#565656	rgb(86,86,86)	見出し、本文テキスト
text-secondary	#939393	rgb(147,147,147)	セカンダリテキスト、控えめなテキスト
text-tertiary	#B5B5B5	rgb(181,181,181)	補足テキスト
border-default	#3A3A3A	rgb(58,58,58)	控えめな境界線、区切り線

タイポグラフィ

• プライマリフォントファミリーには Inter を使用する必要があります
• 一貫性を保つため、単一のフォントファミリーを使用することを推奨します
• プライマリ見出しには 127px / 700 を使用する必要があります
• 本文テキストには 16px / 500 を使用する必要があります
• フォントウェイトを減らすことを推奨します（現在は 5 種類が検出されています）
• 見出しには text-balance、本文テキストには text-pretty を使用する必要があります
• 数値データには tabular-nums を使用することを推奨します
• 明示的に依頼されない限り、文字間隔を変更してはいけません

テキストスタイル

スタイル	フォント	サイズ	ウェイト	色	数
heading-1	Inter	127px	700	#1C1C1C	1
text-28px	Inter	28px	700	#ECEEE4	1
text-18px	Inter	18px	500	#3C3C3C	1
text-17px	Inter	17px	semi_bold	#3D3D3D	1
body	Inter	16px	500	#B5B5B5	1
body-secondary	Inter	16px	500	#B0B3A3	1
body-secondary	Inter	15px	400	#4A4A4A	1
body-secondary	Inter	15px	400	#4D4D4D	1
body-secondary	Inter	15px	400	#646464	1
body-secondary	Inter	14px	400	#5C5C5C	2

タイポグラフィの参考情報

フォントファミリー：

• Inter（31 回使用）

フォントサイズ： 7px、8px、9px、10px、11px、12px、14px、15px、16px、17px、18px、28px、127px

間隔

• 間隔には 4px グリッドを使用する必要があります
• 次のスケールから間隔を選ぶことを推奨します：1px、2px、3px、4px、5px、6px、8px
• 要素間のデフォルトの間隔には 5px を使用することを推奨します
• 任意の間隔値を使用してはいけません（デザインスケールを使用してください）
• コンテナ内のパディングを一貫させることを推奨します

境界線

• 角丸には次のスケールを使用する必要があります：2px、3px、4px、6px、7px、8px、9px
• 境界線の幅は一貫して 1px にする必要があります
• デフォルトの角丸には 7px を使用することを推奨します
• 任意の角丸値を使用してはいけません（デザインスケールを使用してください）
• 要素を区切るために、控えめな境界線（1px）を使用することを推奨します

角丸の参考情報

スケール： 2px、3px、4px、6px、7px、8px、9px

レイアウト

• 基準ビューポート幅を 1920px として設計する必要があります
• 次の一貫した要素幅を使用することを推奨します：91px、58px、32px、42px、88px
• 明確な階層を持つ、テキスト中心のレイアウトを保つことを推奨します
• h-screen を使用してはいけません。ビューポート全体の高さには h-dvh を使用してください
• 固定要素では safe-area-inset を考慮する必要があります
• 正方形の要素には、w-* と h-* の代わりに size-* を使用することを推奨します

検出されたレイアウトパターン

• メインコンテンツ：幅：1920px、高さ：629px
• メインコンテンツ：幅：1601px、高さ：632px

コンポーネント

• 入力フィールドの高さは 0px にする必要があります

ボタン

バリエーション	背景	テキスト	境界線	高さ	角丸
ゴースト	透明	#565656	なし	-	-

入力

• 高さ：0px

インタラクティブ状態

フォーカス

• アクセントカラー（#5E6AD2）の 2px アウトラインを使用する必要があります
• 2px の outline-offset を使用する必要があります
• フォーカスインジケーターを削除してはいけません

ホバー時

• ボタン（プライマリ）：背景を10％明るくします
• ボタン（セカンダリ）：背景に #2F2E30 を使用します
• リスト項目：背景に #2F2E30 を使用します

無効状態

• MUST opacity: 0.5 を使用します
• MUST cursor: not-allowed を使用します

インタラクション

• 破壊的または取り消しできない操作には、MUST AlertDialog を使用します
• 読み込み状態には、SHOULD 構造的なスケルトンを使用します
• エラーは、操作が行われる場所の近くにMUST表示します
• input 要素や textarea 要素への貼り付けをNEVERブロックします
• アイコンのみのボタンには、MUST aria-label を追加します

アニメーション

• 明示的に要求されない限り、NEVERアニメーションを追加します
• コンポジターのプロパティ（transform、opacity）のみをMUSTアニメーションします
• レイアウトプロパティ（width、height、top、left、margin、padding）はNEVERアニメーションします
• 入場アニメーションには、SHOULD ease-out を使用します
• インタラクションのフィードバックは、NEVER 200ms を超えないようにします
• prefers-reduced-motion をSHOULD尊重します

パフォーマンス

• 大きな blur() や backdrop-filter のサーフェスはNEVERアニメーションします
• アニメーションが実行中でない限り、NEVER will-change を適用します
• レンダリングロジックで表現できる処理には、NEVER useEffect を使用します