Guida rapida

Un tema Kotao è un vero progetto React Router 8 basato sull’SDK @kotao/storefront, con rendering sul server ed esecuzione nello stesso ambiente Workers sia in locale sia in produzione. Ti serve solo Bun.

Crea un tema

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

Il generatore richiede i dati di connessione del negozio online (o li legge dai parametri) e li scrive in .dev.vars. Puoi saltare questo passaggio e compilare .dev.vars in seguito — copia .dev.vars.example per avere un modello.

Run it

bun run dev

vite dev serve il tema in workerd, lo stesso ambiente usato in produzione, con ricaricamento automatico. Apri l’URL mostrato per vedere il negozio: una pagina iniziale con una griglia di prodotti, una pagina prodotto con selezione delle varianti e una pagina collezione.

Pubblica

Sono disponibili due modalità. Entrambe caricano il codice sorgente incluso nei commit (mai un bundle già compilato) e lasciano alla piattaforma la compilazione sul server:

• Deployment tramite CLI — accedi, seleziona il negozio online ed esegui bun run publish.
• Push-to-deploy con GitHub — collega il repository una volta; ogni push al branch avvia la build e la pubblicazione.

Prossimi passi

• Struttura del progetto — cosa ha creato il generatore.
• Sviluppo locale — .dev.vars, GraphQL tipizzato e vincoli dell’ambiente di esecuzione del tema.