Quickstart

A Kotao theme is a real React Router 7 project built on the @kotao/storefront SDK — server-rendered, running in the same Workers runtime locally and in production. All you need is Bun.

Create a theme

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

The scaffolder asks for your storefront’s connection details (or reads them from flags) and writes them to .dev.vars. You can skip that and fill in .dev.vars later — copy .dev.vars.example to get the shape.

Run it

bun run dev

vite dev serves your theme in workerd — the exact runtime it ships to — with hot reload. Open the printed URL and you have a rendering storefront: a home page with a product grid, a product page with variant selection, and a collection page.

Ship it

Two ways, both upload your committed source (never a prebuilt bundle) and let the platform build it server-side:

• Deploy with the CLI — log in, select your storefront, bun run publish.
• GitHub push-to-deploy — connect a repository once; every push to your branch builds and goes live.

Next

• Project structure — what the scaffolder generated.
• Local development — .dev.vars, typed GraphQL, and the runtime constraints your theme runs under.