フロントエンドデザインマスタークラス v2.1
共感を呼ぶインターフェースを構築します。単にレンダリングするのではなく、すべてのピクセルがその存在理由を証明しなければなりません。
1. コアスタック
- フレームワーク: SvelteKit 5 with Runes (
$state,$derived,$effect) - ランタイム: Bun (サーバー、パッケージ)
- バックエンド/API: Hono (エッジ優先のルート、ミドルウェア)
- UIプリミティブ: shadcn-svelte (ヘッドレス、完全カスタマイズ可能)。すべてのデフォルトをオーバーライドします。
- チャート: LayerChart (Layer Cake 上に構築、shadcn-svelteチャートを強化)
- アニメーション: Svelte Motion (
@humanspeak/svelte-motion) 複雑なオーケストレーション用。標準的なモーションには組み込みのsvelte/transitionとsvelte/animateを、単純なループにはCSSキーフレームを使用します。 - Mermaid: Shiki互換のテーマ付きSVGレンダリングのための
beautiful-mermaid - スタイリング: Tailwind CSS v4 (CSSカスタムプロパティで拡張)
- テスト: ビジュアルリグレッション用の Playwright
- アセット: 生成画像とテクスチャのための Nano Banana
- デプロイ: 静的サイト用
@sveltejs/adapter-static、SSR用@sveltejs/adapter-vercel
2. 意図の特定(リソース読み込み前)
リファレンスを読み込む前に、3つの軸に沿ってリクエストを分類します。これは後続のすべてのデザイン決定を形成します。
A. プロダクトタイプ
何を構築しているのかを特定します。各プロダクトタイプは、スタイル、色、レイアウトの規範を示唆します。
| 製品カテゴリ | 推奨スタイル | 色の方向性 |
|---|---|---|
| SaaS / B2B / プロダクティビティ | スイスグリッド、フラット+グラスモーフィズム | トラストブルー+アクセントコントラスト |
| Eコマース / リテール | ビビッドブロック、機能豊富なショーケース | ブランド原色+サクセスグリーン |
| Eコマース ラグジュアリー | リキッドグラス、シネマティック | ダークニュートラル+ゴールド/シャンパンアクセント |
| Fintech / 暗号資産 | データ密度高、ダークモード OLED | ダークネイビー/チャコール+ネオンアクセント |
| ヘルスケア / ウェルネス | オーガニックフロー、ソフトUI | ソフトティール/セージ+暖色ニュートラル |
| クリエイティブ / ポートフォリオ | ネオ・ブルータリズム、キネティックタイポグラフィ | ハイコントラスト+1つの大胆なアクセント |
| ゲーム / エンターテインメント | サイバーパンク、HUD/サイエンスフィクション | ダーク背景+ネオンマルチアクセント |
| 教育 / ドキュメント | エディトリアルブロードシート、ミニマル | ウォームペーパー+インク階層 |
| AI / ML プラットフォーム | オーロラUI、モーションドリブン | グラデーション原色+ダークサーフェス |
| ダッシュボード / 分析 | ベントーグリッド、データ密度高 | ニュートラルサーフェス+セマンティックデータカラー |
このテーブルを出発点として使用し、制約とはしないでください。常にカスタマイズしてください。
B. スタイルの意図
コンテキストの手がかり、明示的なリクエスト、またはプロダクトタイプから、美的ターゲットを決定します。完全な仕様については references/landing-pages.md のセクション3(8つのタイムレスなスタイル)を参照してください。
C. オーディエンスとコンテキスト
誰がどこでこれを使用するかを考慮します。エンタープライズユーザーは情報量の多さを許容しますが、コンシューマーユーザーには息継ぎのスペースが必要です。モバイルファーストでは、タッチターゲット、タイポグラフィスケール、アニメーションの強度のすべてが変化します。
3. リソース読み込みプロトコル
意図を特定した後、リクエスト内のトリガーワードをスキャンします。一致するリファレンスファイルを references/ から読み込み、深い実装パターンにアクセスします。
ランディングページとヒーローセクション
トリガー: "ランディングページ", "ヒーロー", "ファーストビュー", "ホームページ", "サイトタイトル", "ヘッドライン", "CTA", "コールトゥアクション", "コンバージョン", "ファーストインプレッション"
読み込み: references/landing-pages.md
提供内容: ヒーローセクションの構成、8つのタイムレスなランディングページスタイル(Apple Keynote、Editorial Broadsheet、Geometric Playground、Cinematic Immersive、Swiss Grid、Neo-Brutalist、Organic Flow、Retro Terminal)、ビジュアルフローパターン(Z/F/ゴールデン/ダイアゴナル)、コンバージョンアーキテクチャ、モバイルファーストヒーロー戦略、コードパターン。
タイポグラフィとフォント選択
トリガー: "フォント", "タイポグラフィ", "書体", "見出し", "テキストスタイル", "フォントペアリング", "タイプスケール", "文字間隔", "行の高さ", "読みやすい", "ディスプレイフォント"
読み込み: references/typography.md
提供内容: ペアリング推奨付きのディスプレイ/本文/モノフォントカタログ、タイプスケールの構築(数学的比率)、clamp()を使用したレスポンシブタイポグラフィ、バリアブルフォント、フォントの読み込みとパフォーマンス、タイポグラフィの詳細(トラッキング、ぶら下がり句読点、光学的配置)、読みやすさチェックリスト。
カラーシステムとテーマ設定
トリガー: "色", "パレット", "テーマ", "ダークモード", "ライトモード", "アクセント", "配色", "ブランドカラー", "コントラスト", "色相", "彩度"
読み込み: references/color-system.md
提供内容: 構造化された3グループパレットアーキテクチャ(ベーストーン、プライマリトーン、アクセントトーン)、色彩理論のハーモニーモデル、パレット生成ワークフロー、ライトテーマ構築、ダークテーマ構築(独立したルール)、追加テーマ(ウォーム/クール/モノ/ハイコントラストバリアント)付きテーマセレクター、セマンティックカラートークン、CSSカスタムプロパティシステム、WCAGコントラスト準拠。
画像、テクスチャ、背景
トリガー: "画像", "背景", "テクスチャ", "写真", "イラストレーション", "ディザリング", "オーバーレイ", "パララックス背景", "ヒーロー画像", "Nano Banana", "デュオトーン", "パターン"
読み込み: references/imagery.md
提供内容: 画像の役割の分類、サイズ設定とフォーマット戦略、3層背景構成、ディザリングアルゴリズム(Atkinson/Floyd-Steinberg/Bayer)、オーバーレイと幾何学的境界(斜線、クリップパス形状、コーナーマーク、グリッドオーバーレイ)、画像内の動き、芸術的スタイル選択(フォトリアリスティック/イラスト/生成/ミックスメディア/デュオトーン)、ボタンとバナー画像、Nano Banana統合、AI画像プロンプトガイド。
データグラフィック、テーブル、チャート、インフォグラフィック
トリガー: "テーブル", "チャート", "インフォグラフィック", "データ", "統計", "メトリクス", "ダッシュボードKPI", "比較", "タイムライン", "プロセスフロー", "数字表示"
読み込み: references/data-graphics.md
提供内容: デフォルトを超えたテーブルデザイン(グリッドなしテーブル、ステータスインジケーター、スパークラインセル、スティッキーヘッダー、強調テクニック)、チャートの美学とストーリーテリング(グラデーションフィル、グローエフェクト、注釈、グリッド代替)、Mermaid図の統合、インフォグラフィックパターン(数字ブロック、タイムライン、比較グリッド、プロセスフロー)、データビジュアルのためのAIプロンプティング、印刷対応データグラフィック。
マイクロアニメーションとインタラクティブコントロール
トリガー: "アニメーション", "ホバー", "クリック", "ボタン", "トグル", "フィードバック", "リップル", "ローディング", "スケルトン", "トランジション", "スナップ", "マグネティック", "スクロールアニメーション", "マイクロインタラクション", "レスポンシブコントロール", "状態遷移", "フォームアニメーション"
読み込み: references/microanimations.md
提供内容: 完全な5状態ボタンシステム(デフォルト/ホバー/アクティブ/フォーカス/無効)、ナビゲーションフィードバック(メニュー項目、ハンバーガー、タブインジケーター)、スクロール駆動アニメーション(段階的表示、プログレスバー、カウンターアニメーション)、フォームインタラクション(フローティングラベル、バリデーションフィードバック、カスタムチェックボックス)、ローディング状態(スケルトン、成功/エラー)、ページトランジション、ハプティックフィールパターン(プレス、バウンス、カードリフト、リップル)、スナップとマグネティック動作、パフォーマンスルール、イージングとタイミングリファレンステーブル。
ビジュアルモーションと奥行き
トリガー: "3d", "奥行き", "パララックス", "傾き", "疑似3d", "空間的", "キネティック", "モーション", "グラスモーフィズム", "ホログラフィック"
読み込み: references/visual-kinetics.md
提供内容: アニメーションティアシステム(CSS -> Svelte -> Svelte Motion -> GSAP)、グレア付きホログラフィック傾きカード、Nano Bananaレイヤーを使用したパララックスヒーロー、グラスモーフィズム2.0、キネティックタイポグラフィ(リビールマスク、マーキー、分割テキスト)、スクロールトリガー表示、物理ベースイージング、マグネティックボタン、パフォーマンスチェックリスト。
データ可視化(チャートとダッシュボード)
トリガー: "レイヤーチャート", "チャートコンポーネント", "ダッシュボードレイアウト", "ベントーグリッド", "スパークライン", "リアルタイム", "ネオンチャート", "エディトリアルチャート"
読み込み: references/data-visualization.md
提供内容: LayerChartコンポーザブルパターン、shadcn-svelteチャート統合、チャート美的モード(ネオン/エディトリアル/ミニマル)、テーブルスタイルレシピ、ベントーグリッドダッシュボードレイアウト、スパークライン、リアルタイムデータパターン、代替ライブラリ。
図(Mermaid)
トリガー: "mermaid", "図", "フローチャート", "シーケンス図", "アーキテクチャ図"
読み込み: references/mermaid-theming.md
提供内容: beautiful-mermaidのセットアップとテーマ設定、Shiki統合、ネイティブMermaid themeVariablesマッピング、SVG後処理(テクスチャオーバーレイ、シャドウ、ボーダー)、SvelteKitコンポーネントパターン、図タイプ別スタイリングノート、印刷に関する考慮事項。
複数のトリガーが検出された場合は、関連するすべてのリファレンスを読み込みます。 トリガーが検出されなかった場合は、以下の普遍的な義務を直接適用します。
4. アンチスロップ義務
LLMはトレーニングデータから確率の高い「安全な」デザインパターンに収束します。これは分布収束です。意図的にそれと戦ってください。
拒否: Bootstrap/Tailwindのデフォルトをそのまま使用すること、Inter/Roboto/Arial/システムフォント、白背景に紫の配色、予測可能なカードグリッド、画一的なヒーローセクション、中央揃えレイアウト、ストックフォト、一般的なグラデーション、UI内の絵文字アイコン、マジックナンバーでのスペーシング、非表示のホバー状態、レイアウトをずらすホバー時のスケール変換、30%未満の透明度のライトモードガラスカード、gray-500以下のコントラストのミュートテキスト。
採用: 意図的なタイポグラフィ階層、非対称な構成、雰囲気のある奥行き、キネティックフィードバック、エディトリアルグリッド、幾何学的な視線誘導、印刷物のような精度、色彩理論に基づいて構築されたカスタムカラーパレット、特徴的なフォントペアリング、一貫したviewBoxを持つSVGアイコンシステム(Lucide, Heroicons)、すべてのクリック可能要素へのカーソルポインター、レイアウトを乱さない色/不透明度を使用した安定したホバー状態。
5. デザイン思考(コード実装前)
コードを書く前に、方向性を決定します。
- 目的: これは何を解決するのか?誰が使うのか?
- プロダクトタイプ: セクション2Aのテーブルを使用して、初期の方向性を分類します。
- 美的トーン: 1つ選び、完全にコミットします。8つの実績あるスタイルについては
references/landing-pages.mdのセクション3を参照してください。またはハイブリッドを発明しても構いません。 - 色の方向性: 原色を選択し、色彩理論のハーモニーからアクセントを導き出します。完全なワークフローは
references/color-system.mdのセクション3を参照してください。 - タイポグラフィ:
references/typography.mdのカタログから、ディスプレイ+本文+モノの3種を選択します。 - 記憶に残るディテール: ユーザーが覚えているであろう1つの要素を特定します。
- 複雑さの一致: マキシマリスト=精巧なコード。ミニマリスト=外科手術のような正確さ。
6. 普遍的な美的義務
タイポグラフィ
特徴的で個性のあるペアリングを選択します。Google FontsまたはFontsourceから読み込みます。完全なフォントカタログとペアリング戦略については references/typography.md を参照してください。
大幅に変更しない限り、Inter、Roboto、Open Sans、Lato、またはデフォルトのシステムフォントを決して使用しないでください。
世代を超えてSpace Groteskに収束しないでください。
色(構造化パレット)
3グループのパレットを構築します:ベーストーン、プライマリトーン、アクセントトーン。
完全なシステムについては references/color-system.md を参照してください。
ライトテーマ:ハードシャドウ、太いタイポグラフィ、細い線。
ダークテーマ:色付きグロー、オフホワイトのテキスト (#E8E8E8)、微妙なサーフェスグラデーション。
純粋な紫 (H: 270-280) を原色として決して使用しないでください。インディゴ、ティール、コーラル、エメラルドにシフトしてください。
画像とテクスチャ
ヒーローセクションにフラットな単色背景を決して使用しないでください。
3層構成技法、ディザリングアルゴリズム、Nano Banana統合パターンについては references/imagery.md を参照してください。
マイクロアニメーション(必須)
すべてのインタラクティブ要素はモーションフィードバックを提供する必要があります。
完全な5状態ボタンシステム、スクロール駆動アニメーション、ハプティックフィールパターンについては references/microanimations.md を参照してください。
空間構成
垂直方向の足場、非対称性、ネガティブスペース、グリッドを破る要素。
ビジュアルフローパターンについては references/landing-pages.md のセクション4を参照してください。
アクセシビリティ(譲れない)
- セマンティックHTML:
<article>,<section>,<nav>,<aside>,<main> - フォーカス状態: 決して
outline: noneにしない。outline: 2px solid var(--accent); outline-offset: 4pxとスタイル設定する。 - WCAG AAコントラスト最小値。
references/color-system.mdのセクション9を参照。 - すべてのカスタムインタラクティブコンポーネントにARIAラベル
prefers-reduced-motion: パララックス、傾き、複雑なアニメーションを無効にする- 色を状態の唯一の指標にしてはならない
- すべての画像にaltテキストが必要。フォーム入力にはラベルが必要。
印刷とPDF
@media print がアクティブな場合、サイトは印刷可能なレポートとしても機能する必要があります。
ナビゲーション/フッター/ボタンを非表示にし、背景を白に強制し、SVGチャートを保持し、カード/チャート/テーブルに break-inside: avoid を使用します。
7. 実装ワークフロー
- 特定: プロダクトタイプ、スタイルの意図、オーディエンスを分類します(セクション2)。
- 読み込み: リソーストリガーをスキャンし、関連するリファレンスファイルを読み込みます(セクション3)。
- 調査: 複雑な構築の場合は、同等の受賞歴のあるサイト、パターン、ライブラリ機能について徹底的に調査します(最大10件のウェブ検索)。
- 設計: SvelteKitのファイル構造を計画します。CSS変数トークンを定義します。
- コード: セマンティックHTML、拡張Tailwind、Svelte 5 Runesを記述します。プロダクション対応、プレースホルダーなし。
- 研磨: マイクロアニメーション、テクスチャレイヤー、ホバー状態、スクロールトリガーを適用します。
- 検証: 出荷前チェックリスト(セクション8)を実行します。すべての失敗を修正します。
- 反復: 美的ビジョンと比較します。際立つまで調整します。
8. 出荷前チェックリスト
UIコードを提供する前にこれを実行します。各項目は既知の障害モードです。
ビジュアル品質
- UIアイコンに絵文字が使用されていない(LucideまたはHeroicons SVGを使用)
- すべてのアイコンが一貫したセットからのもので、viewBoxが一致している(24x24)
- ブランドロゴが公式ソース(Simple Icons)に対して検証されている
- ホバー状態がレイアウトシフトを引き起こさない(スケール変換ではなく、不透明度/色を使用)
- カスタマイズなしのデフォルトTailwindカラークラスがない
- タイポグラフィペアリングが意図的であり、読み込まれている(システムフォールバックではない)
インタラクション
- すべてのクリック可能要素に
cursor-pointerがある - すべてのインタラクティブ要素に可視のホバーフィードバックがある
- トランジションは150-300msの時間を使用している(UIで500msを超えない、0msにしない)
- フォーカス状態が可視であり、スタイル設定されている(ブラウザデフォルトではない、削除されていない)
- モバイルでのタッチターゲットは最低44x44px
ライト/ダークモード
- ライトモード:テキストコントラストがWCAG AAに合格している
- ダークモード:純粋な黒(#000)の背景がなく、オフホワイトテキスト(#E8E8E8)と微妙な表面グラデーションがある
- ダークモードでは要素の色がグロー/発光を帯びている
パフォーマンスと技術
- 画像は最適化され、適切なサイズである(巨大なアセットを直接使用しない)
- フォントは適切に読み込まれ(
font-display: swap)、サブセット化されている - アニメーションはCSSトランスフォームと不透明度を使用し(レイアウトやペイントプロパティではない)、
will-changeでヒントを与えている - スクロールアニメーションまたは Intersection Observer ベースのアニメーションは、ビューポートに表示されている場合にのみトリガーされる
- データの取得と状態管理がパフォーマンスのために最適化されている
コード品質
- セマンティックHTMLが使用されている(
<div>のみのスープではない) - 状態とスタイルにインラインスタイルや魔法の値がない
- コンソールエラーや警告がない
- すべてのパブリックアセットが適切にリンクされている
このチェックリストに合格しないコードは提供しないでください。
9. 必要なリファレンス資料
このスキルのために作成/保守するファイル:
references/landing-pages.md- ヒーローセクションのパターンと8つのスタイルreferences/typography.md- フォントカタログとペアリングreferences/color-system.md- パレット構築、テーマ設定、コントラストreferences/imagery.md- 画像、ディザリング、Nano Bananareferences/data-graphics.md- テーブル、Mermaid図、インフォグラフィックreferences/microanimations.md- 5状態ボタン、フォーム、ローディングreferences/visual-kinetics.md- 3D、パララックス、グラスモーフィズムreferences/data-visualization.md- LayerChart、shadcn-charts、ダッシュボードreferences/mermaid-theming.md- beautiful-mermaidのセットアップとテーマ
これらのリファレンスファイルが利用可能でない場合は、このドキュメントに含まれる原則に基づいて実装を進めてください。
10. 設計上の決定
- JavaScriptフレームワーク: 指定がない限りSvelteKitを優先。React/Next.jsは明示的に要求された場合のみ。
- コンポーネントライブラリ: 指定がない限りshadcn-svelteを優先。
- CSSフレームワーク: Tailwind CSS v4がデフォルト。CSSモジュールは小規模プロジェクト向け。
- 型安全性: 可能な限りTypeScriptを使用。
- テスト: 視覚的回帰テストにPlaywrightを使用。
- デプロイ: Vercelがデフォルト。