Next.js ベストプラクティス
Next.js App Router 開発のための原則。
1. サーバーコンポーネント vs クライアントコンポーネント
判断ツリー
必要なものは...?
│
├── useState、useEffect、イベントハンドラ
│ └── クライアントコンポーネント('use client')
│
├── 直接データフェッチ、インタラクティブ性は不要
│ └── サーバーコンポーネント(デフォルト)
│
└── 両方?
└── 分割:サーバー親 + クライアント子
デフォルトでの使い分け
| タイプ | 用途 |
|---|
| サーバー | データフェッチ、レイアウト、静的コンテンツ |
| クライアント | フォーム、ボタン、インタラクティブUI |
2. データフェッチングのパターン
フェッチ戦略
| パターン | 用途 |
|---|
| デフォルト | 静的(ビルド時にキャッシュ) |
| Revalidate | ISR(時間ベースのリフレッシュ) |
| No-store | 動的(リクエストごとにフェッチ) |
データフロー
| ソース | パターン |
|---|
| データベース | サーバーコンポーネントでのfetch |
| API | キャッシュ付きfetch |
| ユーザー入力 | クライアント状態 + サーバーアクション |
3. ルーティングの原則
ファイル規約
| ファイル | 目的 |
|---|
page.tsx | ルートUI |
layout.tsx | 共有レイアウト |
loading.tsx | ローディング状態 |
error.tsx | エラーバウンダリ |
not-found.tsx | 404ページ |
ルート構成
| パターン | 用途 |
|---|
ルートグループ (name) | URLに影響させずに整理 |
パラレルルート @slot | 同じ階層の複数ページを同時表示 |
インターセプト (.) | モーダルオーバーレイ |
4. API ルート
ルートハンドラ
| メソッド | 用途 |
|---|
| GET | データの読み取り |
| POST | データの作成 |
| PUT/PATCH | データの更新 |
| DELETE | データの削除 |
ベストプラクティス
- Zod で入力を検証する
- 適切なステータスコードを返す
- エラーを適切に処理する
- 可能な場合は Edge ランタイムを使用する
5. パフォーマンスの原則
画像最適化
- next/image コンポーネントを使用する
- ファーストビュー画像には priority を設定する
- ぼかしプレースホルダーを提供する
- レスポンシブサイズを使用する
バンドル最適化
- 重いコンポーネントは動的インポートする
- ルートベースのコード分割(自動)
- バンドルアナライザーで分析する
6. メタデータ
静的 vs 動的
| タイプ | 用途 |
|---|
| 静的エクスポート | 固定メタデータ |
| generateMetadata | ルートごとに動的生成 |
必須タグ
- title(50~60文字)
- description(150~160文字)
- Open Graph 画像
- 正規URL(Canonical URL)
7. キャッシュ戦略
キャッシュレイヤー
| レイヤー | 制御方法 |
|---|
| リクエストキャッシュ | fetch options |
| データキャッシュ | revalidate / tags |
| フルルートキャッシュ | ルート設定 |
再検証
| 方法 | 用途 |
|---|
| 時間ベース | revalidate: 60 |
| オンデマンド | revalidatePath/Tag |
| キャッシュなし | no-store |
8. サーバーアクション
ユースケース
ベストプラクティス
- 'use server' でマークする
- すべての入力を検証する
- 型付けされたレスポンスを返す
- エラーを処理する
9. アンチパターン
| ❌ やらないこと | ✅ やるべきこと |
|---|
| あらゆる場所で 'use client' | デフォルトはサーバー |
| クライアントコンポーネントでフェッチ | サーバーコンポーネントでフェッチ |
| ローディング状態をスキップ | loading.tsx を使用 |
| エラーバウンダリを無視 | error.tsx を使用 |
| 大きなクライアントバンドル | 動的インポート |
10. プロジェクト構成
app/
├── (marketing)/ # ルートグループ
│ └── page.tsx
├── (dashboard)/
│ ├── layout.tsx # ダッシュボードレイアウト
│ └── page.tsx
├── api/
│ └── [resource]/
│ └── route.ts
└── components/
└── ui/
覚えておこう: サーバーコンポーネントがデフォルトであるのには理由があります。そこから始めて、必要な場合のみクライアントコンポーネントを追加しましょう。
使用するタイミング
このスキルは、概要に記載されたワークフローやアクションを実行するために使用します。
制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
- 出力を環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全境界、成功基準が不足している場合は、中断して明確化を求めてください。