Zum Hauptinhalt springen

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.

CLI ausführen​

In einem beliebigen Arbeitsverzeichnis (z. B. ~/projekte/):

npx git+https://forge.repair.nrw/2TAP2B/create-musterstadt-theme.git stadtname-website

Der CLI fragt interaktiv nach den Projektdaten:

Projektverzeichnis / Repo-Name:          stadtname-website
Kundenname (Anzeigename):                Stadt Musterstadt
Öffentliche Website-URL:                 https://www.musterstadt.de

Forgejo-Instanz URL:                     https://forge.repair.nrw
Forgejo Organisation oder Nutzer:        2TAP2B

Sveltia CMS OAuth2 app_id:              [leer lassen – wird im nächsten Schritt erstellt]
Website-URL

Die öffentliche Website-URL muss mit https:// beginnen, sonst funktioniert das CMS-Login nicht.

Nach Abschluss wurde erstellt:

  • Verzeichnis stadtname-website/ mit fertig konfiguriertem Astro-Projekt
  • src/consts.ts, astro.config.mjs und public/admin/config.yml bereits angepasst
  • Git-Remotes: upstream → Haupt-Theme, origin → (noch anzulegendes) Kundenprojekt-Repo

Leeres Repo auf Forgejo anlegen​

Im Browser: https://forge.repair.nrw/repo/create

FeldWert
Namestadtname-website
Sichtbarkeitintern (oder privat)
READMENein – leer lassen
.gitignoreNein – leer lassen

Das Repo muss leer sein, sonst schlägt der erste Push fehl.

Projekt ins Repo pushen​

cd stadtname-website

# Origin hinzufügen (noch nicht gesetzt, da Repo gerade erst angelegt):
git remote add origin ssh://git@forge.repair.nrw:222/2TAP2B/stadtname-website.git

# Prüfen:
git remote -v

# Pushen:
git push -u origin main

Damit ist das Kundenprojekt im Repo und bereit für die weiteren Schritte.

Weiter​