Next.js Best Practices
Regel für selektives Lesen
Beginne mit:
references/senior-master-standard.md
references/usage-routing.md
references/quality-checklist.md
Lade dann nur die vererbten Dokumente, Skripte, Assets oder Beispiele, die zur tatsächlichen Aufgabe des Benutzers passen.
Prinzipien für die Entwicklung mit Next.js App Router.
1. Server- vs. Client-Komponenten
Entscheidungsbaum
Benötigt 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. 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 | Fehlergrenze |
not-found.tsx | 404-Seite |
Routenorganisation
| Muster | Verwendung |
|---|
Routengruppen (name) | Organisieren ohne URL-Änderung |
Parallele Routen @slot | Mehrere Seiten auf gleicher Ebene |
Abfangen (.) | Modal-Overlays |
4. API-Routen
Routen-Handler
| Methode | Verwendung |
|---|
| GET | Daten lesen |
| POST | Daten erstellen |
| PUT/PATCH | Daten aktualisieren |
| DELETE | Daten löschen |
Best Practices
- Eingabe mit Zod validieren
- Korrekte Statuscodes zurückgeben
- Fehler ordnungsgemäß 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
- Routenbasierte Code-Aufteilung (automatisch)
- Mit Bundle-Analyzer analysieren
6. Metadaten
Statisch vs. Dynamisch
| Typ | Verwendung |
|---|
| Statischer Export | Feste Metadaten |
| generateMetadata | Dynamisch pro Route |
Essentielle Tags
- title (50-60 Zeichen)
- description (150-160 Zeichen)
- Open Graph Bilder
- Kanonische URL
7. Caching-Strategie
Cache-Ebenen
| Ebene | Kontrolle |
|---|
| Anfrage | fetch-Optionen |
| Daten | revalidate/tags |
| Ganze Route | Routenkonfiguration |
Revalidierung
| Methode | Verwendung |
|---|
| Zeitbasiert | revalidate: 60 |
| On-Demand | revalidatePath/Tag |
| Kein Cache | no-store |
8. Server-Aktionen
Anwendungsfälle
- Formularübermittlungen
- Datenänderungen
- Revalidierungsauslöser
Best Practices
- Mit 'use server' markieren
- Alle Eingaben validieren
- Typisierte Antworten zurückgeben
- Fehler behandeln
9. Anti-Patterns
| ❌ Nicht tun | ✅ Besser so |
|---|
| 'use client' überall | Standardmäßig Server |
| Abruf in Client-Komponenten | Abruf im Server |
| 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/
Denken Sie daran: Server-Komponenten sind aus gutem Grund der Standard. Beginnen Sie dort, fügen Sie Client nur hinzu, wenn nötig.
Verwendungshinweis
Dieses Skill ist anwendbar, um den im Überblick beschriebenen Workflow oder die Aktionen auszuführen.
Einschränkungen
- Verwenden Sie dieses Skill nur, wenn die Aufgabe eindeutig dem oben beschriebenen Umfang entspricht.
- Behandeln Sie die Ausgabe nicht als Ersatz für umgebungsspezifische Validierung, Tests oder Expertenüberprüfung.
- Halten Sie an und fragen Sie nach Klärung, wenn erforderliche Eingaben, Berechtigungen, Sicherheitsgrenzen oder Erfolgskriterien fehlen.