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 という例外を定める。