このページの目次

このページの目次

Svelte(Svelte 5 + SvelteKit)

判定

条件付き — Svelte 5 + SvelteKit は、開発の楽しさも目標のひとつである小規模な個人プロジェクトと実験プロジェクトでの採用を認める。デフォルトではない。本番のフロントエンドはフロントエンドフレームワークで選定した React スタックのままにする。

使用する場面

  • 個人プロジェクト、プロトタイプ、小規模な実験プロジェクト — 開発を楽しむこと自体が目標として成り立つ場合。
  • ユーザーが明示的に Svelte を要求した場合。

避けるべき場面

  • AI の作業スループットとエコシステムの広さが重要になる、チーム向け・顧客向けの本番作業。
  • React エコシステムの広さが必要なプロジェクト。

長所

  • 主要なコンポーネントフレームワークの中でボイラープレートが最も少ない。コンパイル結果は細粒度のリアクティビティを備え、バンドルも小さい。
  • runes によりリアクティブな状態が明示的になり、静的解析できる。
  • SvelteKit は Vite 上にアプリケーション層一式(ルーティング、SSR、フォームアクション)を提供する。
  • 公式の AI ツール群(MCP サーバー、skills、sv add ai-tools)が、LLM 学習データに含まれる例が React より少ない点を補う。

トレードオフ

  • LLM の学習データに含まれる例は React より少なく、主なリスクは幻覚によって Svelte 4 の書き方を生成することである。このリスクを抑えるために公式 AI ツールを使い、記憶に頼らない。
  • コンポーネントのエコシステムは小さい。UI 作業は DaisyUI か手書きコンポーネントで行う。
  • 動きが速い。プレリリースのメジャー版は next チャネルで配布され、latest は常に安定版ラインである。新しいメジャーの探索自体がプロジェクトの目的でない限り、latest を維持する。

バージョン方針

  • Svelte 5 の最新安定版。コンポーネントレベルの await 式には experimental.async が必要(Svelte ≥ 5.36)— 実験的機能であり、デフォルトではない。
  • SvelteKit は 3.x の latest 安定版ライン。next チャネルのプレリリースはデフォルトでは採用しない。
  • クラスベースのキットが必要な場合は DaisyUI 5(Tailwind CSS v4 プラグインモデル)を使い、それ以外はネイティブ CSS の手書きコンポーネントとする。

利用ルール

  • npx sv create でスキャフォールドし、続けて npx sv add ai-tools を実行する — Svelte MCP ツール向けの公式 AGENTS.md インストラクションをプロジェクトに書き込むコマンドである。
  • 公式 MCP サーバー(npx -y @sveltejs/mcp)を登録する。構文が曖昧なときは記憶に頼らず、list-sections に続けて get-documentation を呼ぶ。作成・編集したすべてのコンポーネントに svelte-autofixer を実行し、指摘がゼロになるまで修正する。
  • runes モードのみを使い、レガシー構文は決して出力しない。特に:
    • 算出値には $derived(または $derived.by)を使う — 状態への代入を $effect で行ってはならない。$effect は実際に副作用が必要な場合の例外的な手段とする。
    • $state はリアクティブにすべき値に限定する。API レスポンスのような、丸ごと再代入される大きなオブジェクトには $state.raw を使う。
    • props は変わりうるものとして扱う。通常の let にコピーせず、$derived で派生させる。
    • イベントは onclick={...} 属性(on:click は禁止)。createEventDispatcher の代わりにコールバック props を使う。
    • スロットの代わりに {#snippet} + {@render}。{#each} はキー付きにする(インデックスをキーにしない)。class: ディレクティブの代わりに配列・オブジェクトの class 値を使う。
  • onMount や $effect のリスナーより <svelte:window> / <svelte:document> を優先する。外部ライブラリとの同期は $effect ではなく {@attach} で行う。共有モジュールの状態より、型付きの createContext を使う。
  • UI アプローチはプロジェクトごとに 1 つ選ぶ:
    • ネイティブ CSS による手書きコンポーネント — デフォルト。キットへの依存がなく、完全に制御できる。
    • DaisyUI 5 — Tailwind プラグイン(@plugin "daisyui";)。セマンティックなテーマクラスを持ち、コピーされるコンポーネントはない。小さなアプリと速度重視ならこちら。
  • 子コンポーネントのスタイルは CSS カスタムプロパティで渡す(<Child --color="red" />)。:global はサードパーティコンポーネント専用とする。

連携

  • Tailwind CSS — 併用:DaisyUI 5 は Tailwind v4 ベースであり、使う場合はクラス並べ替えの相互運用ルールを適用する。
  • フロントエンドフレームワーク — 文脈:デフォルトのフレームワーク選定は React 優先のまま。この文書は Svelte という例外を定める。