Entwicklung

Voraussetzungen

• Node.js 24 oder neuer
• pnpm 12 (über packageManager in package.json gepinnt)

Setup

pnpm install

Befehle

pnpm dev          # turbo dev: Web-App mit HMR
pnpm type-check   # turbo type-check über das ganze Monorepo
pnpm lint         # eslint (next + typescript Regeln), null Warnings
pnpm test         # turbo test (vitest)
pnpm format:check # prettier über das ganze Repo
pnpm build        # Produktions-Build nach apps/web/.next

Alle Checks müssen vor dem Push bestehen: pnpm lint mit null Fehlern, pnpm type-check mit null Fehlern, pnpm format:check ohne Unterschiede und ein erfolgreicher pnpm build.

Lokalisierungs-Workflow

• UI-Strings: packages/i18n/messages/en.json bearbeiten, dann die anderen sechs Sprachdateien übersetzen. Die Schlüsselstruktur identisch halten.
• Docs: packages/content/docs/en/<slug>.md bearbeiten, dann die Übersetzungen aktualisieren. Fehlende Übersetzungen fallen automatisch auf Englisch zurück.
• Nach Änderungen an Messages oder Docs pnpm build ausführen und jede Sprachroute im Browser prüfen.

Git-Identität

Commits im Repository werden mit der Identität des Projekteigentümers erstellt, und jeder Commit trägt einen Co-Author-Trailer:

Co-authored-by: Ella Mizuki

Branch-Schutz

main ist geschützt: Push durch Maintainer, Force Push deaktiviert. History-Umschreibungen (etwa das Neu-Zuweisen von Commit-Autoren) erfordern, den Schutz vorübergehend zu entfernen, den Force Push zu machen und ihn mit exakt denselben Einstellungen wiederherzustellen.

Kontinuierliche Integration

Kein CI-Server überwacht dieses Repository. Führe die Qualitäts-Gates vor jedem Push aus (pnpm type-check, pnpm lint, pnpm test, pnpm format:check, pnpm build); Vercel baut das Produktions-Bundle beim Deploy, und ein fehlgeschlagener Build scheitert im Deploy.

Tests vor dem Merge

Die Validierung ist:

• Lint, Typecheck, Format:check, Build;
• Browser-Durchlauf bei 375, 768, 1024, 1440 und 1920px mit null horizontalem Overflow, in allen Sprachen;
• Reduced-Motion-Durchlauf: kein Shimmer, keine aktiven Übergänge, Inhalt sichtbar;
• Anker-Navigation räumt den fixen Header frei (Scroll-Padding);
• Doc-Routen lösen in allen Sprachen auf, einschließlich Englisch-Fallback.