linear-ui-skills

Linear UI スキル

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

適用する場面

次のような場合に、これらのガイドラインを参照してください。

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

色

• プライマリサーフェスには必ず明度 20 未満の暗い背景を使用してください（検出された明度：4）
• ページの背景（surface-base）には必ず #080A0A を使用してください
• カラーパレットは固有の色を 10 色以内に抑えることを推奨します
• アクセシビリティのため、テキストのコントラスト比を必ず 4.5:1 以上にしてください

セマンティックトークン

トークン	HEX	RGB	用途
surface-base	#080A0A	rgb(8,10,10)	ページの背景
surface-raised	#D2D2D3	rgb(210,210,211)	カード、モーダル、浮き上がったサーフェス
surface-overlay	#E3E3E6	rgb(227,227,230)	オーバーレイ、ツールチップ、ドロップダウン
text-primary	#5C5C5C	rgb(92,92,92)	見出し、本文テキスト
text-secondary	#2D2E30	rgb(45,46,48)	セカンダリテキスト、控えめなテキスト
text-tertiary	#444749	rgb(68,71,73)	追加テキスト
border-default	#B0B1B1	rgb(176,177,177)	控えめな境界線、区切り線

タイポグラフィ

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

テキストスタイル

スタイル	フォント	サイズ	ウェイト	色	数
heading-1	Inter	60px	700	#E2E4E3	1
body	Inter	17px	400	#444749	1
body-secondary	Inter	16px	400	#5C5C5C	1
body-secondary	Inter	15px	500	#2D2E30	1
text-14px	Inter	14px	400	#B2B3B3	1
text-13px	Inter	13px	400	#4C4C4C	1
text-13px	Inter	13px	400	#525355	1
text-12px	Inter	12px	400	#525456	1
caption	Inter	9px	400	#545557	1
label	Inter	9px	400	#565759	1

タイポグラフィの参照

フォントファミリー：

• Inter（13 回使用）

フォントサイズ： 9px、12px、13px、14px、15px、16px、17px、60px

余白

• 余白には必ず 4px グリッドを使用してください
• 次のスケールの余白を使用することを推奨します：5px、11px、12px、13px、14px、16px、19px、20px
• 要素間のデフォルトの間隔には 5px を使用することを推奨します
• 任意の余白値は使用しないでください（デザインスケールを使用してください）
• コンテナー内のパディングを一貫させることを推奨します

境界線

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

角丸の参照

スケール： 6px、8px

レイアウト

• 必ずビューポート幅 1920px を基準にデザインしてください
• 要素の幅を 52px で統一することを推奨します
• 明確な階層を備えた、テキスト主体のレイアウトを維持することを推奨します
• h-screen は使用せず、ビューポート全体の高さには h-dvh を使用してください
• 固定要素では必ず safe-area-inset を考慮してください
• 正方形の要素には w-* と h-* の代わりに size-* を使用することを推奨します

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

• メインコンテンツ：幅：1920px、高さ：1013px
• ヘッダー：高さ：63px

コンポーネント

ボタン

バリアント	背景	テキスト	境界線	高さ	角丸
ゴースト	透明	#5C5C5C	なし	-	-

インタラクティブ状態

フォーカス

• アクセントカラー（#5E6AD2）を使った 2px のアウトラインを必ず使用してください
• 2px のアウトラインオフセットを必ず使用してください
• フォーカスインジケーターを削除しないでください

ホバー

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

無効状態

• 必ず 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 を決して使用しません