Next.js 16 アプリケーション
正しいパターンと特徴的なデザインでNext.js 16アプリケーションを構築します。
重要な破壊的変更 (Next.js 16)
1. params と searchParams は Promise になりました
これは最も一般的なミスです。
// 間違い - Next.js 15 パターン (失敗します)
export default function Page({ params }: { params: { id: string } }) {
return <div>ID: {params.id}</div>
}
// 正しい - Next.js 16 パターン
export default async function Page({
params,
}: {
params: Promise<{ id: string }>
}) {
const { id } = await params
return <div>ID: {id}</div>
}
2. クライアントコンポーネントは use() フックが必要
"use client"
import { use } from "react"
export default function ClientPage({
params,
}: {
params: Promise<{ id: string }>
}) {
const { id } = use(params)
return <div>ID: {id}</div>
}
3. searchParams も非同期に
export default async function Page({
searchParams,
}: {
searchParams: Promise<{ page?: string }>
}) {
const { page } = await searchParams
return <div>Page: {page ?? "1"}</div>
}
コアパターン
プロジェクトセットアップ
npx create-next-app@latest my-app --typescript --tailwind --eslint
cd my-app
# shadcn/ui を追加
npx shadcn@latest init
npx shadcn@latest add button form dialog table sidebar
App Router レイアウト
// app/layout.tsx
export default function RootLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<html lang="en">
<body className="min-h-screen">
{children}
</body>
</html>
)
}
動的ルート
// app/tasks/[id]/page.tsx
export default async function TaskPage({
params,
}: {
params: Promise<{ id: string }>
}) {
const { id } = await params
const task = await getTask(id)
return (
<main>
<h1>{task.title}</h1>
</main>
)
}
サーバーアクション
// app/actions.ts
"use server"
import { revalidatePath } from "next/cache"
export async function createTask(formData: FormData) {
const title = formData.get("title") as string
await db.insert(tasks).values({ title })
revalidatePath("/tasks")
}
// コンポーネント内での使用例
<form action={createTask}>
<input name="title" />
<button type="submit">作成</button>
</form>
API ルート
// app/api/tasks/route.ts
import { NextResponse } from "next/server"
export async function GET() {
const tasks = await db.select().from(tasksTable)
return NextResponse.json(tasks)
}
export async function POST(request: Request) {
const body = await request.json()
const task = await db.insert(tasksTable).values(body).returning()
return NextResponse.json(task, { status: 201 })
}
ミドルウェア → proxy.ts
// proxy.ts (Next.js 16 では middleware.ts を置き換えます)
import { NextRequest } from "next/server"
export function proxy(request: NextRequest) {
// 認証チェック
const token = request.cookies.get("token")
if (!token && request.nextUrl.pathname.startsWith("/dashboard")) {
return Response.redirect(new URL("/login", request.url))
}
}
export const config = {
matcher: ["/dashboard/:path*"],
}
データフェッチング
サーバーコンポーネント (デフォルト)
// これはサーバー上で実行されます - async/await を直接使用できます
async function TaskList() {
const tasks = await fetch("https://api.example.com/tasks", {
cache: "no-store", // SSR、または
// next: { revalidate: 60 } // ISR
}).then(r => r.json())
return (
<ul>
{tasks.map(task => <li key={task.id}>{task.title}</li>)}
</ul>
)
}
クライアントコンポーネント
"use client"
import useSWR from "swr"
const fetcher = (url: string) => fetch(url).then(r => r.json())
export function ClientTaskList() {
const { data, error, isLoading } = useSWR("/api/tasks", fetcher)
if (isLoading) return <div>読み込み中...</div>
if (error) return <div>タスクの読み込み中にエラーが発生しました</div>
return (
<ul>
{data.map(task => <li key={task.id}>{task.title}</li>)}
</ul>
)
}
プロジェクト構造
app/
├── layout.tsx # ルートレイアウト
├── page.tsx # ホームページ
├── globals.css # グローバルスタイル
├── api/ # API ルート
│ └── tasks/route.ts
├── tasks/
│ ├── page.tsx # /tasks
│ └── [id]/page.tsx # /tasks/:id
├── actions.ts # サーバーアクション
└── proxy.ts # リクエストプロキシ (ミドルウェア)
components/
├── ui/ # shadcn/ui コンポーネント
└── task-list.tsx # アプリケーションコンポーネント
lib/
├── db.ts # データベース接続
└── utils.ts # ユーティリティ
Next.js DevTools MCP
ランタイム診断と開発自動化には、next-devtools-mcpサーバーを使用します。
セットアップ
claude mcp add next-devtools npx next-devtools-mcp@latest
または settings.json で:
{
"mcpServers": {
"next-devtools": {
"type": "stdio",
"command": "npx",
"args": ["next-devtools-mcp@latest"]
}
}
}
利用可能なツール
| ツール | 目的 |
|---|---|
init | 利用可能なツールとベストプラクティスでコンテキストを確立 |
nextjs_docs | 公式Next.jsドキュメントの検索と取得 |
browser_eval | Playwrightを使用したブラウザテストの自動化 |
nextjs_index | 実行中のNext.js開発サーバーの検出 |
nextjs_call | 実行中の開発サーバーでMCPツールを実行 |
upgrade_nextjs_16 | codemodsを使用した自動アップグレード |
enable_cache_components | Next.js 16 の Cache Components を設定 |
主なユースケース
1. リアルタイムエラーの取得
"私のNext.jsアプリにどのようなビルドエラーがありますか?"
"現在のプロジェクトのTypeScriptエラーを表示してください"
2. ランタイム問題のデバッグ
"開発サーバーのログでエラーを確認してください"
"ダッシュボードページで発生しているランタイムエラーは何ですか?"
3. アップグレード支援
"このプロジェクトをNext.js 16にアップグレードしてください"
"このアプリでcache componentsを有効にしてください"
4. ドキュメント検索
"Next.js 16 で Image コンポーネントを使用するにはどうすればよいですか?"
"動的ルートを正しく処理する方法は?"
Next.js 16 MCP エンドポイント
Next.js 16+ は、http://localhost:3000/_next/mcp(または開発サーバーのポート)に組み込みのMCPエンドポイントを公開します。devtools MCPは自動的に実行中のサーバーを検出して接続します。
検証
実行: python3 scripts/verify.py
期待される出力: ✓ building-nextjs-apps skill ready
検証に失敗した場合
- 確認: references/ フォルダに nextjs-16-patterns.md があるか
- それでも失敗する場合は 停止して報告
関連スキル
- styling-with-shadcn - Next.jsアプリケーション用UIコンポーネント
- fetching-library-docs - 最新のNext.jsドキュメント:
--library-id /vercel/next.js --topic routing - configuring-better-auth - Next.jsアプリケーション用OAuth/SSO
リファレンス
- references/nextjs-16-patterns.md - 完全なNext.js 16パターン
- references/frontend-design.md - 特徴的なUIのための美的ガイドライン
- references/datetime-patterns.md - datetime-local入力のためのUTC/タイムゾーン処理