> ## Documentation Index
> Fetch the complete documentation index at: https://docs-loja.usecorvex.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Publicar e instalar

> Fluxo público — catálogo de temas, instalação na loja e publicação da vitrine.

Dois fluxos distintos — **não misture**:

| Fluxo | Quem | Ferramenta | O que muda |
| - | - | - | - |
| **Código do tema** | Developer / agência | `corvex publish` | Versão no catálogo Corvex |
| **Conteúdo da loja** | Merchant | Editor → **Publicar** | Layout e settings na vitrine |

Ver [Publish Contract](https://docs-loja.usecorvex.com.br/reference/contracts/publish.md).

***

## 1. Publicar tema (developer)

Autentique e vincule a loja antes:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex auth
corvex link .
corvex validate .
corvex build .
corvex publish . --visibility PRIVATE
```

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](https://docs-loja.usecorvex.com.br/cli/commands.md).

***

## 2. Instalar tema na loja

Após `corvex publish` ou ao receber um `themeVersionId`:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex sync .                    # build + publish PRIVATE + atualiza loja
corvex sync . --keep-content     # só código — preserva personalizações do editor
corvex sync . --open             # abre o Editor
```

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](https://docs-loja.usecorvex.com.br/cli/commands.md).

### Baixar loja para o local (`corvex pull`)

**Estado atual da loja** (templates + settings + código, incluindo edições do Editor):

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex pull . --force
```

**Versão específica publicada no catálogo** (só o código-fonte do `publish`, sem edições posteriores do Editor):

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex pull . --version 1.0.130 --force
```

Detalhes e flags: [CLI — `corvex pull`](https://docs-loja.usecorvex.com.br/cli/commands#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

| Situação | Causa provável |
| - | - |
| Publish falha com auth | Rode `corvex auth` |
| Tema não aparece na loja | `corvex link` ou `corvex sync` |
| Mudança no JSX não aparece | Falta `corvex build` / `corvex sync` |
| Merchant não vê alteração | Falta **Publicar** no Editor |
| Versão duplicada | Use `corvex publish --update` |

***

## Veja também

* [Marketplace overview](https://docs-loja.usecorvex.com.br/marketplace/overview.md)
* [CLI overview](https://docs-loja.usecorvex.com.br/cli/overview.md)
* [Preview Contract](https://docs-loja.usecorvex.com.br/reference/contracts/preview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.