Next.js 16 Anwendungen
Erstelle Next.js 16-Anwendungen korrekt mit einem markanten Design.
Kritische Breaking Changes (Next.js 16)
1. params und searchParams sind jetzt Promises
DAS IST DER HÄUFIGSTE FEHLER.
// FALSCH - Next.js 15 Pattern (WIRD FEHLSCHLAGEN)
export default function Page({ params }: { params: { id: string } }) {
return <div>ID: {params.id}</div>
}
// RICHTIG - Next.js 16 Pattern
export default async function Page({
params,
}: {
params: Promise<{ id: string }>
}) {
const { id } = await params
return <div>ID: {id}</div>
}
2. Client-Komponenten benötigen den use()-Hook
"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 sind ebenfalls asynchron
export default async function Page({
searchParams,
}: {
searchParams: Promise<{ page?: string }>
}) {
const { page } = await searchParams
return <div>Seite: {page ?? "1"}</div>
}
Kernmuster
Projekteinrichtung
npx create-next-app@latest my-app --typescript --tailwind --eslint
cd my-app
# shadcn/ui hinzufügen
npx shadcn@latest init
npx shadcn@latest add button form dialog table sidebar
App Router Layout
// app/layout.tsx
export default function RootLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<html lang="de">
<body className="min-h-screen">
{children}
</body>
</html>
)
}
Dynamische Routen
// 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>
)
}
Server-Aktionen
// 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")
}
// Verwendung in einer Komponente
<form action={createTask}>
<input name="title" />
<button type="submit">Erstellen</button>
</form>
API-Routen
// 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 })
}
Middleware → proxy.ts
// proxy.ts (ersetzt middleware.ts in Next.js 16)
import { NextRequest } from "next/server"
export function proxy(request: NextRequest) {
// Authentifizierungsprüfung
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*"],
}
Datenabruf
Server-Komponente (Standard)
// Dies läuft auf dem Server - async/await kann direkt verwendet werden
async function TaskList() {
const tasks = await fetch("https://api.example.com/tasks", {
cache: "no-store", // SSR, oder
// next: { revalidate: 60 } // ISR
}).then(r => r.json())
return (
<ul>
{tasks.map(task => <li key={task.id}>{task.title}</li>)}
</ul>
)
}
Client-Komponente
"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>Laden...</div>
if (error) return <div>Fehler beim Laden der Aufgaben</div>
return (
<ul>
{data.map(task => <li key={task.id}>{task.title}</li>)}
</ul>
)
}
Projektstruktur
app/
├── layout.tsx # Root-Layout
├── page.tsx # Startseite
├── globals.css # Globale Styles
├── api/ # API-Routen
│ └── tasks/route.ts
├── tasks/
│ ├── page.tsx # /tasks
│ └── [id]/page.tsx # /tasks/:id
├── actions.ts # Server-Aktionen
└── proxy.ts # Request-Proxy (Middleware)
components/
├── ui/ # shadcn/ui-Komponenten
└── task-list.tsx # App-Komponenten
lib/
├── db.ts # Datenbankverbindung
└── utils.ts # Hilfsfunktionen
Next.js DevTools MCP
Verwende den next-devtools-mcp-Server für Laufzeitdiagnose und Entwicklungsautomatisierung.
Einrichtung
claude mcp add next-devtools npx next-devtools-mcp@latest
Oder in settings.json:
{
"mcpServers": {
"next-devtools": {
"type": "stdio",
"command": "npx",
"args": ["next-devtools-mcp@latest"]
}
}
}
Verfügbare Werkzeuge
| Werkzeug | Zweck |
|---|---|
init | Kontext mit verfügbaren Werkzeugen und Best Practices herstellen |
nextjs_docs | Offizielle Next.js-Dokumentation durchsuchen und abrufen |
browser_eval | Browser-Tests mit Playwright automatisieren |
nextjs_index | Laufende Next.js-Entwicklungsserver entdecken |
nextjs_call | MCP-Werkzeuge auf laufenden Entwicklungsservern ausführen |
upgrade_nextjs_16 | Automatisiertes Upgrade mit Codemods |
enable_cache_components | Cache-Komponenten für Next.js 16 konfigurieren |
Wichtige Anwendungsfälle
1. Echtzeitfehler abrufen
"Welche Build-Fehler gibt es in meiner Next.js-App?"
"Zeige mir TypeScript-Fehler im aktuellen Projekt"
2. Laufzeitprobleme debuggen
"Überprüfe die Dev-Server-Protokolle auf Fehler"
"Welche Laufzeitfehler treten auf der Dashboard-Seite auf?"
3. Upgrade-Unterstützung
"Führe ein Upgrade dieses Projekts auf Next.js 16 durch"
"Aktiviere Cache-Komponenten für diese App"
4. Dokumentationssuche
"Wie verwende ich die Image-Komponente in Next.js 16?"
"Wie ist der korrekte Weg, dynamische Routen zu behandeln?"
Next.js 16 MCP-Endpunkt
Next.js 16+ stellt einen integrierten MCP-Endpunkt unter http://localhost:3000/_next/mcp (oder deinem Dev-Server-Port) bereit. Das DevTools-MCP entdeckt und verbindet sich automatisch mit laufenden Servern.
Verifizierung
Führe aus: python3 scripts/verify.py
Erwartet: ✓ building-nextjs-apps skill ready
Wenn die Verifizierung fehlschlägt
- Überprüfe: Der Ordner references/ enthält nextjs-16-patterns.md
- Stoppe und melde falls es immer noch fehlschlägt
Verwandte Skills
- styling-with-shadcn - UI-Komponenten für Next.js-Apps
- fetching-library-docs - Aktuelle Next.js-Dokumentation:
--library-id /vercel/next.js --topic routing - configuring-better-auth - OAuth/SSO für Next.js-Apps
Referenzen
- references/nextjs-16-patterns.md - Vollständige Next.js 16-Muster
- references/frontend-design.md - Ästhetische Richtlinien für markante Benutzeroberflächen
- references/datetime-patterns.md - UTC/Zeitzonenbehandlung für datetime-local-Eingaben