📄️ Übersicht
Dieser Guide richtet sich an alle, die den repair.nrw-Webseitenbaukasten selbst betreiben, weiterentwickeln oder neue Kundenprojekte aufsetzen möchten. Er dient gleichzeitig als Dokumentation für den laufenden Betrieb und als Transparenzquelle für alle Interessierten.
📄️ Theme entwickeln & veröffentlichen
Hier wird beschrieben, wie Änderungen am Haupt-Theme entwickelt, getestet und ins Repository gepusht werden – damit alle Kundenprojekte sie per Update einziehen können.
📄️ Neues Kundenprojekt anlegen
Ein neues Kundenprojekt wird mit dem CLI-Installer aufgesetzt. Der CLI erzeugt ein fertig vorkonfiguriertes Astro-Projekt und verbindet es mit dem Haupt-Theme als Upstream.
📄️ Sveltia CMS – OAuth2 einrichten
Sveltia CMS verwendet OAuth2 über Forgejo für die Authentifizierung. Pro Kundenprojekt wird eine eigene OAuth2-App angelegt.
📄️ Hosting mit Coolify
Coolify übernimmt das Deployment und stellt die Webseite öffentlich bereit. Ein Webhook sorgt dafür, dass jeder Push automatisch einen neuen Build auslöst.
📄️ Theme-Updates ausrollen
Wenn am Haupt-Theme Änderungen vorgenommen wurden, können sie in alle laufenden Kundenprojekte eingespielt werden. Kundeneigene Dateien werden dabei nicht überschrieben.