Next.js ベストプラクティス
選択的読み取りルール
まずは以下から始めます:
references/senior-master-standard.md
references/usage-routing.md
references/quality-checklist.md
その後、ユーザーの実際のタスクに合致する継承ドキュメント、スクリプト、アセット、または例のみを読み込みます。
Next.js App Router 開発のための原則。
1. サーバーコンポーネントとクライアントコンポーネント
判断ツリー
何が必要か?
│
├── 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ページ |
ルートの構成
| パターン | 用途 |
|---|
ルートグループ (名前) | URLに影響なく整理 |
パラレルルート @スロット | 同一階層に複数ページ |
インターセプト (.) | モーダルオーバーレイ |
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オプション |
| データ | revalidate/tags |
| フルルート | ルート設定 |
再検証 (Revalidation)
| 方法 | 用途 |
|---|
| 時間ベース | 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/
覚えておいてください: サーバーコンポーネントがデフォルトであるのには理由があります。まずはそこから始め、必要な場合にのみクライアントを追加してください。
使用タイミング
このスキルは、概要で説明されているワークフローやアクションを実行する際に適用されます。
制限事項
- タスクが上記のスコープに明確に合致する場合にのみこのスキルを使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
- 必要な入力、権限、安全境界、または成功基準が不足している場合は、立ち止まって明確化を求めてください。