Deployment-Anleitung

Anpassungsleitfaden

Wo Sie Branding, Inhalte, Preise und Locales ändern, ohne Updates zu brechen.

Zuerst diese vier Dinge ändern

Die meisten Teams brauchen vor dem Launch nur vier Anpassungen: Brand, Inhalte, Preise und Locales. Jede hat einen klar abgegrenzten Ort, damit Upstream-Updates mergebar bleiben.

ÄnderungOrtHinweis
Logo / Faviconpublic/logo*.png, public/favicon*Dateinamen beibehalten, dann keine Komponenten-Änderung nötig
Seitenname / SEO-Defaultssrc/lib/seo.ts (SITE_NAME, Default-Keywords)Wird von jedem Page-Head genutzt
Marketing-Textemessages/{en,zh,de}/*.jsonParaglide-Kataloge; keine Code-Änderung nötig
Blog-Artikelcontent/english-blog/*.md + Publish-PipelineFrontmatter-gesteuert
Template-KatalogAdmin-Katalog (DB) oder src/content/templates/*.json als FallbackDB ist die Wahrheit, wenn vorhanden
Preise / PläneBilling-Katalog + /pricing-DatenPreise kommen aus Stripe, nicht aus hartkodierten Strings
Farben / ThemeCSS-Variablen im globalen StylesheetTokens ändern, nicht einzelne Komponenten

Branding ohne Komponenten-Fork

  1. Logo-Dateien in public/ ersetzen (gleiche Namen, gleiche Maße).
  2. SITE_NAME und Default-OG-Bild in src/lib/seo.ts aktualisieren.
  3. Footer-/About-Texte in den Message-Katalogen anpassen.
  4. Theme-Tokens (z. B. --coral, --sea-ink) im globalen CSS anpassen.

Gut zu wissen

Stabile Dateinamen und Message-Keys bedeuten: git pull vom Upstream kollidiert selten mit Ihren Brand-Änderungen.

Inhaltsmodell

  • Blog: Markdown mit YAML-Frontmatter (title, slug, date, tags, locale). Die Publish-Pipeline prüft EEAT-Felder vor dem Schreiben in die Datenbank.
  • Docs: Markdown unter src/content/deploy/ und src/content/features/, zur Build-Zeit geladen. Datei hinzufügen, Nav-Eintrag ergänzen, fertig.
  • Katalog: Produkte, Locales, Medien und FAQ-Zeilen liegen in der Datenbank; das Admin-UI bearbeitet sie. Statisches JSON unter src/content/templates/ ist nur Fallback.

Locales

Die Seite liefert en, zh und de. Neue Locale hinzufügen:

  1. Locale in der Paraglide-Konfiguration ergänzen und messages/<locale>/ anlegen.
  2. Kataloge übersetzen (Maschinenübersetzung für den ersten Wurf okay; Marketing-Texte prüfen).
  3. Blog-Übersetzungen unter content/i18n/<locale>/ mit passendem slug und group_id ablegen.
  4. Katalog-Locale-Zeilen für Produkte ergänzen, die Sie in diesem Markt verkaufen.

Preise und Billing

Preise werden aus dem Billing-Katalog (Stripe-gestützt) gelesen. Preis ändern:

  1. Stripe-Produkt/Preis aktualisieren.
  2. Billing-Referenzen der Katalogzeile aktualisieren.
  3. Katalog-Cache-Version erhöhen, damit Seiten es sofort übernehmen.

Preise nicht in Komponenten hartkodieren — Pricing-Seite, Template-Seiten und Checkout lesen dieselbe Quelle.

Nicht bearbeiten

  • src/paraglide/** — generiert; stattdessen messages/ bearbeiten.
  • src/routeTree.gen.ts — vom Router generiert.
  • Bereits auf Produktion angewendete Migrationen — neue Migration hinzufügen.

Sicher upgraden

Merge-Workflow und Lizenzumfang siehe Lizenz & Updates.