Grundlagen des Frontend-Reviews (Frontend Fundamentals Review)
„Eine Komponente sollte EINE Sache gut machen. Wenn du sie mit ‚und‘ beschreibst, teile sie auf.“
Wann anwenden
Aktiviere dieses Skill bei der Überprüfung von:
- React/Vue/Svelte-Komponenten
- UI-Rendering-Logik
- State-Management-Code
- CSS/Styling-Entscheidungen
- Client-seitigem Routing
Review-Checkliste
Komponentenarchitektur
- Einzelverantwortung: Macht jede Komponente EINE Aufgabe?
- Größenprüfung: Ist die Komponente unter 200 Zeilen?
- Anzahl der Props: Sind es weniger als 7 Props?
- Benennung: Kannst du die Komponente beschreiben, ohne „und“ zu sagen?
State-Management
- Colocation: Ist der State so nah wie möglich an der Stelle, an der er verwendet wird?
- Lifting: Wird State korrekt zwischen Geschwistern über das Elternelement geteilt?
- Context vs. Props: Wird Prop Drilling vermieden (max. 3 Ebenen)?
- Server-State: Werden Serverdaten separat verwaltet (React Query/SWR)?
Performance
- Memoization: Sind teure Berechnungen in useMemo eingeschlossen?
- Callbacks: Sind Ereignis-Handler bei Bedarf in useCallback eingeschlossen?
- Re-Renders: Verursacht dies unnötige Re-Renders?
- Lazy Loading: Werden schwere Komponenten per Code-Splitting geladen?
Barrierefreiheit (Accessibility)
- Semantisches HTML: Werden die richtigen Elemente verwendet (z. B. button vs. div)?
- ARIA: Sind interaktive Elemente zugänglich?
- Tastatur: Können Benutzer ohne Maus navigieren?
---\n
Häufige Fehler (Anti-Patterns)
1. God-Komponenten (Überkomponenten)
❌ UserDashboard.tsx (1000 Zeilen)
- Holt Daten, verwaltet State, rendert UI, kümmert sich um Routing
✅ Aufteilen in:
- UserDashboardPage.tsx (Container)
- UserStats.tsx (Präsentation)
- UserActivity.tsx (Präsentation)
- useUserData.ts (Hook)
2. Logik im Render-Bereich
❌ return <div>{users.filter(u => u.active).map(u => ...)}</div>
✅ const activeUsers = useMemo(() => users.filter(u => u.active), [users]);
return <div>{activeUsers.map(u => ...)}</div>
3. Prop Drilling
❌ <App user={user}>
<Layout user={user}>
<Main user={user}>
<Widget user={user} />
✅ const user = useUser(); // in Widget.tsx
4. Boolescher Prop-Salat
❌ <Button primary secondary large small disabled loading />
✅ <Button variant="primary" size="large" state="loading" />
Sokratische Fragen
Stelle dem Junior-Entwickler diese Fragen anstatt Antworten zu geben:
- Architektur: „Was ist die EINE Aufgabe dieser Komponente?“
- Aufteilung: „Wenn ich dich bitten würde, nur den Header-Teil woanders zu verwenden – könntest du das?“
- State: „Wer braucht diese Daten? Sollten sie hier oder weiter oben leben?“
- Performance: „Was passiert, wenn die Elternkomponente neu rendert?“
- Komplexität: „Könnte ein neuer Entwickler das in 5 Minuten verstehen?“
Referenz zu Standards
Siehe detaillierte Muster in:
/standards/frontend/component-architecture.md
Alarmzeichen (Red Flags), die du ansprechen solltest
| Alarmzeichen | Frage zum Stellen |
|---|---|
| Datei > 200 Zeilen | „Können wir das in kleinere Teile aufteilen?“ |
| > 5 useState-Aufrufe | „Sollte ein Teil dieses States angehoben oder kombiniert werden?“ |
| useEffect mit [] als Dependencies, verwendet aber externe Werte | „Fehlen uns Dependencies?“ |
| Direkte DOM-Manipulation | „Gibt es einen React-Ansatz, um das zu tun?“ |
| Überall Inline-Styles | „Sollten wir einen einheitlichen Styling-Ansatz verwenden?“ |