Skip to main content

Publicar e instalar

Dois fluxos distintos — não misture: Ver Publish Contract.

1. Publicar tema (developer)

Autentique e vincule a loja antes:
Flags úteis:
  • --update — nova versão do mesmo slug
  • --visibility PUBLIC — marketplace (requer permissão na conta)
  • --install — instala na loja vinculada após publish
A CLI envia manifest, schemas, templates e bundle à API pública do catálogo. Guarde o themeVersionId (version.id) da resposta. Detalhes: CLI — publish.

2. Instalar tema na loja

Após corvex publish ou ao receber um themeVersionId:
No Editor: Temas → catálogo / instalados → escolher versão. Na primeira instalação ou com --full, a plataforma copia defaults do tema (templates, settings iniciais). O merchant edita composição e settings no Editor. Em syncs seguintes, use --keep-content para enviar apenas alterações de código (CSS/JS/seções) sem sobrescrever textos, imagens e layouts que o merchant configurou no painel. Detalhes: CLI — sync e pull.

Baixar loja para o local (corvex pull)

Estado atual da loja (templates + settings + código, incluindo edições do Editor):
Versão específica publicada no catálogo (só o código-fonte do publish, sem edições posteriores do Editor):
Detalhes e flags: CLI — corvex pull.

3. Publicar loja (merchant)

No Editor Corvex:
  1. Editar páginas (sections, ordem, settings)
  2. Salvar rascunho
  3. Publicar loja
Visitantes passam a ver a revisão publicada no domínio da loja. Isso não substitui corvex publish — é conteúdo do merchant, não código do tema.

4. Ler vitrine publicada

A vitrine pública consome a revisão publicada + Theme SDK (createStorefront, usePage, …). Developers não chamam endpoints admin de publish diretamente — use CLI e Editor.

Erros comuns


Veja também