Quickstart

Ein Kotao-Theme ist ein echtes React-Router-7-Projekt auf Basis des @kotao/storefront-SDK — serverseitig gerendert, lokal wie in Produktion in derselben Workers-Runtime. Alles, was du brauchst, ist Bun.

Theme erzeugen

bun create kotao-storefront my-theme
cd my-theme
bun install

Der Scaffolder fragt die Verbindungsdaten deiner Storefront ab (oder liest sie aus Flags) und schreibt sie nach .dev.vars. Du kannst das überspringen und .dev.vars später füllen — .dev.vars.example zeigt die Struktur.

Starten

bun run dev

vite dev serviert dein Theme in workerd — exakt der Runtime, in der es später läuft — mit Hot Reload. Öffne die ausgegebene URL und du hast eine rendernde Storefront: Startseite mit Produktgrid, Produktseite mit Variantenauswahl und eine Collection-Seite.

Veröffentlichen

Zwei Wege — beide laden deinen committeten Quellcode hoch (nie ein vorgebautes Bundle) und lassen die Plattform serverseitig bauen:

• Mit der CLI deployen — anmelden, Storefront wählen, bun run publish.
• GitHub Push-to-Deploy — Repository einmal verbinden; jeder Push auf deinen Branch baut und geht live.

Weiter

• Projektstruktur — was der Scaffolder erzeugt hat.
• Lokale Entwicklung — .dev.vars, typisiertes GraphQL und die Runtime-Regeln, unter denen Themes laufen.