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.
| Änderung | Ort | Hinweis |
|---|---|---|
| Logo / Favicon | public/logo*.png, public/favicon* | Dateinamen beibehalten, dann keine Komponenten-Änderung nötig |
| Seitenname / SEO-Defaults | src/lib/seo.ts (SITE_NAME, Default-Keywords) | Wird von jedem Page-Head genutzt |
| Marketing-Texte | messages/{en,zh,de}/*.json | Paraglide-Kataloge; keine Code-Änderung nötig |
| Blog-Artikel | content/english-blog/*.md + Publish-Pipeline | Frontmatter-gesteuert |
| Template-Katalog | Admin-Katalog (DB) oder src/content/templates/*.json als Fallback | DB ist die Wahrheit, wenn vorhanden |
| Preise / Pläne | Billing-Katalog + /pricing-Daten | Preise kommen aus Stripe, nicht aus hartkodierten Strings |
| Farben / Theme | CSS-Variablen im globalen Stylesheet | Tokens ändern, nicht einzelne Komponenten |
Branding ohne Komponenten-Fork
- Logo-Dateien in
public/ersetzen (gleiche Namen, gleiche Maße). SITE_NAMEund Default-OG-Bild insrc/lib/seo.tsaktualisieren.- Footer-/About-Texte in den Message-Katalogen anpassen.
- Theme-Tokens (z. B.
--coral,--sea-ink) im globalen CSS anpassen.
Gut zu wissen
Stabile Dateinamen und Message-Keys bedeuten:
git pullvom 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/undsrc/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:
- Locale in der Paraglide-Konfiguration ergänzen und
messages/<locale>/anlegen. - Kataloge übersetzen (Maschinenübersetzung für den ersten Wurf okay; Marketing-Texte prüfen).
- Blog-Übersetzungen unter
content/i18n/<locale>/mit passendemslugundgroup_idablegen. - 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:
- Stripe-Produkt/Preis aktualisieren.
- Billing-Referenzen der Katalogzeile aktualisieren.
- 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; stattdessenmessages/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.