GitHub Push-to-Deploy

Verbinde das GitHub-Repository deines Themes mit einer Storefront-Site und jeder Push auf den gewählten Branch deployt automatisch: Die Plattform lädt deinen Commit, baut serverseitig und aktiviert — das Ergebnis steht direkt am Commit.

Repository verbinden

1. Öffne im Workspace Website → Einstellungen und dort die GitHub-Karte.
2. Installiere die GitHub-App Kotao Storefront Deploy — auf deinem eigenen Account oder deiner Organisation, mit Zugriff auf das Theme-Repository (private Repositories funktionieren).
3. Wähle in der Karte Repository und Branch. Liegt das Theme in einem Unterordner eines größeren Repositories, setze das Unterverzeichnis — der Build startet dort.

Ein Repository + Branch verbindet sich mit einer Storefront-Site.

Pushen

git commit -am "Hero verfeinert"
git push

Das ist der ganze Deploy. Bei jedem Push auf den verbundenen Branch:

1. Die Plattform verifiziert den Webhook, stellt den Build in die Queue und meldet einen Commit-Status (kotao/deploy) — pending, solange gebaut wird.
2. Dein committeter Quellcode wird geladen und serverseitig gebaut (die @kotao/*-Dependencies kommen von npm — wie beim CLI-Publish).
3. Bei Erfolg aktiviert das Deployment und der Status springt auf success; bei einem Build-Fehler auf failure.

Zuschauen

• Auf GitHub: der Status-Check des Commits zeigt pending → success/failure.
• Im Workspace: Website → Operations → Deployments zeigt jeden Lauf live — queued → building → deployed, mit Repo, Branch, Commit, Dauer und dem Fehlergrund, wenn ein Build bricht.

Tipp

Denselben Commit erneut zu pushen (oder den Webhook erneut zuzustellen) ist sicher — der Deploy ist pro Commit idempotent und konvergiert einfach.

Hinweise

• Der verbundene Branch deployt auf das Live-Theme der Site — behandle ihn wie einen Produktions-Branch und iteriere auf Feature-Branches.
• Der Build nutzt ausschließlich committete Dateien; .dev.vars bleibt lokal.