Distribuisci con la CLI

kotao storefront publish prepara il codice sorgente incluso nei commit e lo invia alla piattaforma, che installa i pacchetti @kotao/* da npm, compila il tema sul server e lo attiva sul sito del tuo negozio. Non devi mai inviare un bundle già compilato.

Prerequisiti

Il tema è un repository git con tutte le modifiche salvate in un commit — la pubblicazione carica solo i file inclusi nei commit e la build richiede che il commit contenga bun.lock e kotao.theme.json.
Nel progetto è stato eseguito bun install (la CLI kotao è una dipendenza di sviluppo locale).

Pubblicazione

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

auth login --device apre una richiesta di approvazione nel browser su accounts.kotao.com. Approva entro circa dieci minuti; la CLI continua a verificare finché non lo fai. La sessione viene salvata globalmente (~/.config/kotao/cli-session.json), quindi basta accedere una volta per computer.

workspace select e storefront select scelgono l’area di lavoro e il sito di destinazione della pubblicazione. Entrambi ricordano la scelta: puoi ripeterla in qualsiasi momento per cambiare destinazione.

bun run publish carica, compila e attiva il tema. La CLI mostra in tempo reale lo stato della build e termina quando il deployment è online.

Risoluzione problemi

“È necessario un repository git” — esegui prima git init && git add -A && git commit; la pubblicazione legge i file del commit.
Il comando kotao si comporta in modo imprevisto fuori dal progetto — esegui prima bun install e avvialo come bun x kotao all’interno del progetto, così viene usata la dipendenza di sviluppo locale @kotao/cli.
Accesso tramite dispositivo scaduto — esegui di nuovo bun x kotao auth login --device e approva la richiesta nel browser entro dieci minuti.