paddle-ui-skills

Paddle UI スキル

AI エージェントで Paddle スタイルのインターフェースを構築するための、独自の制約です。

適用する場面

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

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

色

• 主要なサーフェスには明るい背景を使用することを推奨します
• ページの背景（surface-base）には #FDFDFD を使用する必要があります
• プライマリアクションとフォーカス状態（accent）には #3475F2 を使用する必要があります
• カラーパレットを減らすことを推奨します（現在 23 色検出されています）
• アクセシビリティのため、テキストのコントラスト比を 4.5:1 以上に維持する必要があります

セマンティックトークン

トークン	HEX	RGB	用途
surface-base	#FDFDFD	rgb(253,253,253)	ページの背景
surface-raised	#78FDAF	rgb(120,253,175)	カード、モーダル、浮き上がったサーフェス
surface-overlay	#E0E0E1	rgb(224,224,225)	オーバーレイ、ツールチップ、ドロップダウン
text-primary	#2E8D5F	rgb(46,141,95)	見出し、本文テキスト
text-secondary	#6F7070	rgb(111,112,112)	二次テキスト、控えめなテキスト
text-tertiary	#929292	rgb(146,146,146)	補足テキスト
border-default	#8FF5BA	rgb(143,245,186)	控えめな境界線、区切り線
accent	#3475F2	rgb(52,117,242)	プライマリアクション、リンク、フォーカス
success	#78FDAF	rgb(120,253,175)	成功状態、確認

タイポグラフィ

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

テキストスタイル

スタイル	フォント	サイズ	ウェイト	色	数
heading-1	Inter	74px	700	#E3E5E4	1
body	Inter	32px	500	#CCD0D1	1
body-secondary	Inter	30px	extra_bold	#E5E6E3	1
text-23px	Inter	23px	semi_bold	#D7D9D6	1
text-19px	Inter	19px	400	#969996	1
text-18px	Inter	18px	700	#DADBD9	1
text-16px	Inter	16px	400	#5A5E5D	1
text-15px	Inter	15px	400	#4F5150	1
text-15px	Inter	15px	400	#B1B5B1	1
text-15px	Inter	15px	400	#7D8182	1

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

フォントファミリー：

• Inter（48 回使用）

フォントサイズ： 7px, 8px, 9px, 10px, 11px, 12px, 13px, 14px, 15px, 16px, 18px, 19px, 23px, 30px, 32px, 74px

余白

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

境界線

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

Border Radius の参照情報

スケール： 0px, 1px, 2px, 3px, 4px, 6px, 7px, 9px, 13px

レイアウト

• 基準ビューポート幅 1920px 向けに設計する必要があります
• 要素の幅には一貫した値を使用することを推奨します：33px, 28px, 306px, 25px, 17px
• 明確な階層を持つ、テキスト中心のレイアウトを維持することを推奨します
• h-screen は使用せず、全ビューポート高には h-dvh を使用してください
• 固定要素では safe-area-inset を尊重する必要があります
• 正方形の要素には w-* + h-* ではなく size-* を使用することを推奨します

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

• メインコンテンツ：幅：1920px、高さ：1080px
• メインコンテンツ：幅：1920px、高さ：726px
• ヘッダー：高さ：85px

コンポーネント

ボタン

バリアント	背景	テキスト	境界線	高さ	角丸
ゴースト	transparent	#2E8D5F	なし	-	-

インタラクティブ状態

フォーカス

• MUST アクセントカラー（#3475F2）の 2px のアウトラインを使用する
• MUST 2px のアウトラインオフセットを使用する
• NEVER フォーカスインジケーターを削除しない

ホバー

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

無効状態

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

インタラクション

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

アニメーション

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

パフォーマンス

• NEVER 大きな blur() または backdrop-filter のサーフェスをアニメーションさせない
• NEVER アクティブなアニメーションの外で will-change を適用しない
• NEVER レンダリングロジックで表現できる処理に useEffect を使用しない