Mit der CLI deployen

kotao storefront publish paketiert deinen committeten Quellcode und übergibt ihn der Plattform. Die installiert die @kotao/*-Pakete von npm, baut das Theme serverseitig und aktiviert es auf deiner Storefront-Site. Ein vorgebautes Bundle lädst du nie hoch.

Voraussetzungen

• Dein Theme ist ein Git-Repository und alles ist committet — publish lädt nur committete Dateien hoch, und der Build braucht bun.lock und kotao.theme.json im Commit.
• bun install ist im Projekt gelaufen (die kotao-CLI ist eine lokale Dev-Dependency).

Publish

bun x kotao auth login --device
bun x kotao workspace select
bun x kotao storefront select
bun run publish

auth login --device öffnet eine Browser-Bestätigung auf accounts.kotao.com. Bestätige innerhalb von etwa zehn Minuten; die CLI pollt solange. Die Session wird global gespeichert (~/.config/kotao/cli-session.json) — einmal anmelden pro Rechner reicht.

workspace select und storefront select wählen Workspace und Ziel-Site des Publishes. Beide merken sich die Wahl — jederzeit neu wählbar.

bun run publish lädt hoch, baut und aktiviert. Die CLI streamt den Build-Status und endet, wenn das Deployment live ist.

Achtung

Publish ersetzt das aktive Theme der Site. Zeige beim Iterieren auf eine Test- oder Draft-Site — wähle das Ziel bewusst in kotao storefront select, bevor du auf einen echten Shop publishst.

Fehlerbehebung

• „needs a git repository“ — erst git init && git add -A && git commit; publish liest den committeten Stand.
• Der kotao-Befehl verhält sich außerhalb des Projekts seltsam — erst bun install, dann im Projekt als bun x kotao aufrufen, damit die lokale @kotao/cli-Dev-Dependency aufgelöst wird.
• Device-Login abgelaufen — bun x kotao auth login --device erneut ausführen und die Browser-Bestätigung innerhalb des Zehn-Minuten-Fensters erteilen.