Admin Guide – Ü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.
Du kannst die Webseite entweder komplett selbst aufsetzen und betreiben – oder du meldest dich bei uns, und wir übernehmen das. Der Guide beschreibt beide Wege.
Was ist was?
Das Gesamtsystem besteht aus drei Typen von Repositories:
forge.repair.nrw/2TAP2B/musterstadt-starter-theme ← Haupt-Theme (gemeinsame Codebasis)
forge.repair.nrw/2TAP2B/create-musterstadt-theme ← CLI-Installer (eigenes Mini-Repo)
forge.repair.nrw/2TAP2B/<kundenname>-website ← Kundenprojekt (eins pro Instanz)
Haupt-Theme enthält alle gemeinsamen Komponenten, Layouts und Styles. Änderungen hier werden per pnpm theme:update in alle Kundenprojekte eingespielt.
CLI-Installer ist ein kleines Hilfswerkzeug, das ein neues Kundenprojekt automatisch aus dem Haupt-Theme erzeugt und vorkonfiguriert.
Kundenprojekt ist der Fork für eine konkrete Instanz (z. B. eine Stadt oder ein Café). Es enthält kundeneigene Inhalte, Konfiguration und Custom-Komponenten – alles sauber vom Theme getrennt.