Deployment automatico da GitHub

Collega il repository GitHub del tuo tema a un sito storefront e ogni push al branch scelto distribuisce automaticamente: la piattaforma scarica il tuo commit, lo costruisce lato server e lo attiva — con il risultato riportato direttamente sul commit.

Collega il repository

1. Nel tuo Workspace, apri Website → Settings e trova la scheda GitHub.
2. Installa l’app GitHub Kotao Storefront Deploy — sul tuo account o organizzazione, e concedi l’accesso al repository del tema (i repository privati funzionano).
3. Tornando alla scheda delle impostazioni, scegli il repository e il branch da cui distribuire. Se il tema risiede in una sottocartella di un repository più grande, imposta la subdirectory — la build inizia da lì.

Un repository + branch si collega a un solo sito storefront.

Push

git commit -am "polish the hero"
git push

Questo è tutto il processo di distribuzione. Su ogni push al branch collegato:

1. La piattaforma verifica il webhook, mette in coda la build e segnala uno stato commit (kotao/deploy) — pending mentre si costruisce.
2. Il tuo codice committato viene scaricato e costruito lato server (le dipendenze @kotao/* si installano da npm — come un publish CLI).
3. In caso di successo la distribuzione si attiva e lo stato diventa success; in caso di errore di build diventa failure.

Controlla l’esito

• Su GitHub: il controllo di stato del commit mostra pending → success/failure.
• Nel tuo Workspace: Website → Operations → Deployments mostra ogni esecuzione in tempo reale — queued → building → deployed, con il repo, branch, commit, durata e il motivo del fallimento quando una build si interrompe.

Consiglio

Inviare nuovamente lo stesso commit (o consegnare di nuovo il webhook) è sicuro: il deployment è idempotente per ogni commit e converge semplicemente allo stesso stato.

Note

• Il branch collegato distribuisce al live theme del sito — trattalo come un branch di produzione e itera su branch di feature.
• La build utilizza solo i file committed; .dev.vars rimane locale.