matter-ui-skills

Matter UI スキル

AI エージェントを使って Matter スタイルのインターフェースを構築する際の、独自の制約です。

適用する場面

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

• ダークモードのインターフェースを構築するとき
• Matter に着想を得たデザインシステムを作成するとき
• Inter フォントと 4px グリッドを使って UI を実装するとき

色

• 主要なサーフェスには、明度が 20 未満の暗い背景を必ず使用します（検出された明度：0）
• ページの背景（surface-base）には、必ず #000000 を使用します
• 主要なアクションとフォーカス状態（accent）には、必ず #5560EC を使用します
• カラーパレットを減らすことを推奨します（現在 19 色を検出）
• アクセシビリティのため、テキストのコントラスト比を 4.5:1 以上に保つ必要があります

セマンティックトークン

トークン	HEX	RGB	用途
surface-base	#000000	rgb(0,0,0)	ページの背景
surface-raised	#CFE3F9	rgb(207,227,249)	カード、モーダル、浮き上がったサーフェス
surface-overlay	#8DBDF7	rgb(141,189,247)	オーバーレイ、ツールチップ、ドロップダウン
text-primary	#627EA1	rgb(98,126,161)	見出し、本文テキスト
text-2	#8C9BAB	rgb(140,155,171)	追加のテキスト
text-secondary	#888888	rgb(136,136,136)	セカンダリテキスト、控えめなテキスト
border-default	#D4E5F8	rgb(212,229,248)	控えめな境界線、区切り線
accent	#5560EC	rgb(85,96,236)	主要なアクション、リンク、フォーカス
destructive	#200D11	rgb(32,13,17)	エラー状態、削除アクション

タイポグラフィ

• 基本のフォントファミリーには、必ず Inter を使用します
• 一貫性を保つため、単一のフォントファミリーを使用することを推奨します
• 主要な見出しには、必ず 81px / 700 を使用します
• 本文には、必ず 35px / 700 を使用します
• フォントウェイトを減らすことを推奨します（現在 6 種類を検出）
• 見出しには text-balance、本文テキストには text-pretty を必ず使用します
• 数値データには tabular-nums を使用することを推奨します
• 明示的に指定されていない限り、文字間隔は絶対に変更しないでください

テキストスタイル

スタイル	フォント	サイズ	ウェイト	色	件数
heading-1	Inter	81px	700	#F0F0F0	1
body	Inter	35px	700	#818181	1
text-32px	Inter	32px	semi_bold	#747474	1
text-26px	Inter	26px	extra_bold	#8C8C8C	1
text-24px	Inter	24px	700	#848484	1
text-21px	Inter	21px	semi_bold	#494949	1
text-20px	Inter	20px	500	#515151	1
text-19px	Inter	19px	400	#666666	1
text-16px	Inter	16px	400	#3C3C3C	1
text-15px	Inter	15px	400	#525252	1

タイポグラフィのリファレンス

フォントファミリー：

• Inter（32 回使用）

フォントサイズ： 8px、9px、10px、11px、12px、13px、14px、15px、16px、19px、20px、21px、24px、26px、32px、35px、81px

余白

• 余白には 4px グリッドを必ず使用します
• 次のスケールから余白を使用することを推奨します：1px、2px、4px、5px、6px、7px、9px、10px
• 要素間のデフォルトの間隔には 2px を使用することを推奨します
• 任意の余白値は絶対に使用せず、デザインスケールを使用してください
• コンテナ内のパディングを一貫させることを推奨します

境界線

• 必ず次のスケールから角丸を使用します：0px、1px、10px、15px
• 境界線の幅は 1px、2px に制限することを推奨します
• デフォルトの角丸には 1px を使用することを推奨します
• 任意の角丸値は絶対に使用せず、デザインスケールを使用してください
• 要素を分けるには、控えめな境界線（1px）を使用することを推奨します

角丸のリファレンス

スケール： 0px、1px、10px、15px

レイアウト

• 基準のビューポート幅を 1920px として必ずデザインします
• 次の一貫した要素幅を使用することを推奨します：13px、102px、38px、37px、14px
• 明確な階層を持つ、テキスト主体のレイアウトを保つことを推奨します
• h-screen は絶対に使用せず、ビューポート全体の高さには h-dvh を使用してください
• 固定要素では safe-area-inset を必ず考慮します
• 正方形の要素には、w-* と h-* の組み合わせではなく、size-* を使用することを推奨します

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

• ヘッダー：高さ：58px
• メインコンテンツ：幅：1920px、高さ：1025px
• メインコンテンツ：幅：1920px、高さ：1023px
• ヘッダー：高さ：59px

コンポーネント

ボタン

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

インタラクティブ状態

フォーカス

• アクセントカラー（#5560EC）の2pxのアウトラインを必ず使用します
• 2pxのアウトラインオフセットを必ず使用します
• フォーカスインジケーターを削除してはいけません

ホバー

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

無効状態

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

インタラクション

• 破壊的または取り消し不可能な操作には、必ずAlertDialogを使用します
• 読み込み状態には、構造を保ったスケルトンを使用することを推奨します
• エラーは、操作が行われる場所の近くに必ず表示します
• inputまたはtextarea要素での貼り付けを妨げてはいけません
• アイコンのみのボタンには、必ずaria-labelを追加します

アニメーション

• 明示的に要求されていない限り、アニメーションを追加してはいけません
• コンポジターのプロパティ（transform、opacity）のみをアニメーションさせてください
• レイアウトプロパティ（width、height、top、left、margin、padding）をアニメーションさせてはいけません
• 表示時のアニメーションには、ease-outを使用することを推奨します
• インタラクションフィードバックの時間は、必ず200ms以下にします
• prefers-reduced-motionを尊重することを推奨します

パフォーマンス

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