Alle Docs

Aktualisiert am 2026-10-28

Deployment

Build, Hosting, Domain und Analytics-Setup.

Build

Die Website wird beim Build von Next.js als statisches HTML erzeugt:

pnpm build

Next.js prärenderisiert Startseite, Dokumentationsseiten, Sitemap und statische Assets für alle sieben Sprachen zur Build-Zeit. Das Ausliefern braucht trotzdem ein Runtime, das die Locale-Verhandlungs-Middleware (apps/web/src/proxy.ts) und die Security-Header ausführt; das Ziel ist daher Vercel mit dem Next.js-Preset. Ein rein statischer Host verlöre die Locale-Verhandlung.

Hosting

Das Produktions-Hosting ist Vercel:

  • framework preset: Next.js
  • root directory: apps/web
  • build command: pnpm build

Die Domain ist ella.yuricunha.com, konfiguriert in apps/web/src/data/site.ts und den App-Metadata, die kanonische URLs, Open Graph und Sitemap steuern.

Dokumentations-Routen

  • /docs Index der verfügbaren Dokumentationsseiten, pro Sprache;
  • /docs/<slug> einzelne Dokumentationsseite, pro Sprache.

Beides sind statische Routen, die beim Build erzeugt werden. Die Standardsprache (Englisch) hat kein URL-Präfix; andere Sprachen tragen ihr Präfix, zum Beispiel /pt/docs oder /ja/docs.

Lokalisierungs-Routen

  • Standard Englisch: https://ella.yuricunha.com
  • Andere Sprachen: https://ella.yuricunha.com/<locale>

Jede Seite deklariert hreflang-Alternates für alle sieben Sprachen, und die Sitemap listet jede Variante.

Analytics

Umami ist vorbereitet, aber standardmäßig inert. Die Analytics-Komponente rendert nur, wenn beide Umgebungsvariablen beim Build vorhanden sind:

NEXT_PUBLIC_UMAMI_SRC=https://ihr-umami-host/script.js
NEXT_PUBLIC_UMAMI_WEBSITE_ID=ihre-website-id

Ohne sie liefert die Website null Analytics-JavaScript. Es werden keine Platzhalter-IDs committet.

Qualitäts-Gates

Kein CI-Server überwacht Pushes mehr: Die GitLab-Pipelines wurden eingestellt, das GitLab-Remote ist nur noch ein Spiegel. Führe die Gates vor dem Push aus:

pnpm type-check && pnpm lint && pnpm test && pnpm format:check && pnpm build

Auch pnpm audit --prod muss sauber durchlaufen. Vercel baut das Produktions-Bundle beim Deploy; da die Seiten prärenderisiert sind, ist der grüne Build das Gate.

SEO

  • Metadata, Open Graph, Twitter Cards, Canonical und JSON-LD im Locale-Layout;
  • robots.txt und Sitemap werden in den Build erzeugt;
  • die Social Card ist public/og.png (1200x630, erzeugt mit den Geist- Schriften aus einem gerenderten HTML-Template);
  • jede Sprache erhält eigene Metadata und hreflang-Alternates.