Next.js Best Practices
Prinzipien für die Next.js App Router-Entwicklung.
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, statischer Inhalt |
| Client | Formulare, Buttons, interaktive UI |
2. Datenabruf-Muster
Abrufstrategie
| Muster | Verwendung |
|---|
| Standard | Statisch (beim Build zwischengespeichert) |
| Revalidate | ISR (zeitbasierte Aktualisierung) |
| No-store | Dynamisch (bei jeder Anfrage) |
Datenfluss
| Quelle | Muster |
|---|
| Datenbank | Server-Komponente abrufen |
| API | Abruf mit Zwischenspeicherung |
| 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 |
Parallele Routen @slot | Mehrere Seiten auf gleicher Ebene |
Abfangende Routen (.) | Modale Overlays |
4. API-Routen
Routen-Handler
| Methode | Verwendung |
|---|
| GET | Daten lesen |
| POST | Daten erstellen |
| PUT/PATCH | Daten aktualisieren |
| DELETE | Daten entfernen |
Best Practices
- Eingaben mit Zod validieren
- Korrekte Statuscodes zurückgeben
- Fehler ordentlich behandeln
- Wenn möglich Edge Runtime verwenden
5. Leistungsprinzipien
Bildoptimierung
- next/image-Komponente verwenden
- Priorität für Inhalte über dem 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 |
Wichtige Tags
- title (50-60 Zeichen)
- description (150-160 Zeichen)
- Open Graph-Bilder
- Kanonische URL
7. Caching-Strategie
Cache-Ebenen
| Ebene | Steuerung |
|---|
| Anfrage | Abrufoptionen |
| Daten | revalidate/tags |
| Komplette Route | Routenkonfiguration |
Aktualisierung
| Methode | Verwendung |
|---|
| Zeitbasiert | revalidate: 60 |
| Auf Abruf | 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 | ✅ Tun |
|---|
| 'use client' überall | Standardmäßig Server |
| Daten in Client-Komponenten abrufen | Daten im Server abrufen |
| Ladestatus überspringen | loading.tsx verwenden |
| Fehlerbegrenzungen 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/
Denken Sie daran: Server-Komponenten sind aus gutem Grund der Standard. Beginnen Sie dort und fügen Sie Client nur hinzu, wenn es nötig ist.