Next.js Best Practices
Prinzipien für die Entwicklung mit Next.js App Router.
1. Server- vs. Client-Komponenten
Entscheidungsbaum
Braucht es...?
│
├── useState, useEffect, Event-Handler
│ └── Client-Komponente ('use client')
│
├── Direkter Datenabruf, keine Interaktivität
│ └── Server-Komponente (Standard)
│
└── Beides?
└── Aufteilen: Server-Eltern + Client-Kind
Standardmäßig
| Typ | Verwendung |
|---|
| Server | Datenabruf, Layout, statische Inhalte |
| Client | Formulare, Schaltflächen, interaktive UI |
2. Datenabrufmuster
Abrufstrategie
| Muster | Verwendung |
|---|
| Standard | Statisch (beim Build gecached) |
| Revalidate | ISR (zeitbasierte Aktualisierung) |
| No-store | Dynamisch (bei jeder Anfrage) |
Datenfluss
| Quelle | Muster |
|---|
| Datenbank | Server-Komponenten-Abruf |
| API | fetch mit Caching |
| Benutzereingabe | Client-Status + Server-Aktion |
3. Routing-Prinzipien
Dateikonventionen
| Datei | Zweck |
|---|
page.tsx | Routen-UI |
layout.tsx | Gemeinsames Layout |
loading.tsx | Ladezustand |
error.tsx | Fehlerbegrenzung |
not-found.tsx | 404-Seite |
Routenorganisation
| Muster | Verwendung |
|---|
Routengruppen (name) | Organisieren ohne URL-Änderung |
Parallele Routen @slot | Mehrere gleichzeitige Seiten |
Abfangen (.) | Modale Overlays |
4. API-Routen
Routen-Handler
| Methode | Verwendung |
|---|
| GET | Daten lesen |
| POST | Daten erstellen |
| PUT/PATCH | Daten aktualisieren |
| DELETE | Daten löschen |
Best Practices
- Eingaben mit Zod validieren
- Korrekte Statuscodes zurückgeben
- Fehler ordentlich behandeln
- Nach Möglichkeit Edge Runtime verwenden
5. Leistungsprinzipien
Bildoptimierung
- next/image-Komponente verwenden
- Priorität für oberhalb der Falz setzen
- Blur-Placeholder bereitstellen
- Responsive Größen verwenden
Bundle-Optimierung
- Dynamische Importe für schwere Komponenten
- Routenbasiertes Code-Splitting (automatisch)
- Mit Bundle-Analyzer analysieren
6. Metadaten
Statisch vs. Dynamisch
| Typ | Verwendung |
|---|
| Statischer Export | Feste Metadaten |
| generateMetadata | Dynamisch pro Route |
Wesentliche Tags
- title (50–60 Zeichen)
- description (150–160 Zeichen)
- Open-Graph-Bilder
- Kanonische URL
7. Caching-Strategie
Cache-Ebenen
| Ebene | Steuerung |
|---|
| Anfrage | fetch-Optionen |
| Daten | revalidate/tags |
| Ganze Route | Routenkonfiguration |
Aktualisierung (Revalidation)
| Methode | Verwendung |
|---|
| Zeitbasiert | revalidate: 60 |
| On-Demand | revalidatePath/Tag |
| Kein Cache | no-store |
8. Server-Aktionen
Anwendungsfälle
- Formularübermittlungen
- Datenänderungen
- Aktualisierungsauslöser
Best Practices
- Mit 'use server' markieren
- Alle Eingaben validieren
- Typisierte Antworten zurückgeben
- Fehler behandeln
9. Anti-Patterns
| ❌ Nicht tun | ✅ Stattdessen |
|---|
| 'use client' überall | Server als Standard |
| Daten in Client-Komponenten abrufen | Daten im Server abrufen |
| Ladezustände überspringen | loading.tsx verwenden |
| Fehlergrenzen ignorieren | error.tsx verwenden |
| Große Client-Bundles | Dynamische Importe |
10. Projektstruktur
app/
├── (marketing)/ # Routengruppe
│ └── page.tsx
├── (dashboard)/
│ ├── layout.tsx # Dashboard-Layout
│ └── page.tsx
├── api/
│ └── [resource]/
│ └── route.ts
└── components/
└── ui/
Denk dran: Server-Komponenten sind aus gutem Grund der Standard. Starte dort und füge Client nur hinzu, wenn nötig.
Wann verwenden
Diese Skill ist anwendbar, um den im Überblick beschriebenen Workflow oder die Aktionen auszuführen.
Einschränkungen
- Verwende diese Skill nur, wenn die Aufgabe klar mit dem oben beschriebenen Umfang übereinstimmt.
- Behandle die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenprüfung.
- Halte inne und frage nach, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.