Quickstart

Crie, valide e abra seu primeiro tema Corvex em poucos minutos.

Crie o primeiro tema e abra no editor. Este guia assume uma agência, parceiro ou tema próprio — sem acesso ao código interno da Corvex.

---

Pré-requisitos

Antes de começar:

• Node.js >= 18 (exigido pela Corvex CLI)
• Corvex CLI instalada globalmente
• Acesso a uma loja Corvex na qual você pode instalar temas
• Conhecimento básico de React e JavaScript

npm install -g @corvex/theme-cli
corvex --version

---

1. Criar o tema

mkdir minha-loja
cd minha-loja
corvex init . --name "Minha Loja" --slug minha-loja

A pasta precisa estar vazia. O init copia o starter (layout, templates, seções de exemplo e config/settings) e imprime Tema criado em …, o name, o slug e quatro próximos passos numerados. Não há uma linha ✓ Tema criado.

---

2. Autenticar e vincular a loja

corvex auth
corvex link

corvex auth salva credenciais locais (API key da sua conta ou fluxo interativo).
corvex link associa esta pasta a uma loja de desenvolvimento.

Ver CLI — autenticação.

---

3. Validar

corvex validate .

A CLI avisa se faltam capturas em screenshots/ para o marketplace público. O tema continua válido. A linha de sucesso usa slug e versão separados por @:

Tema válido: minha-loja@1.0.0

O validate não exige o bundle. Rode o build em seguida.

---

4. Compilar e abrir no Editor

corvex build .
corvex sync --open

corvex sync compila o tema, publica uma versão privada no catálogo da sua conta e instala na loja vinculada. Com --open, o Editor abre no navegador.

---

5. Publicar no catálogo (opcional)

Quando o tema estiver pronto para outras lojas ou versões:

corvex publish . --visibility PRIVATE

Use --visibility PUBLIC apenas se sua conta tem permissão para o marketplace público.

Guarde o themeVersionId retornado para instalação em outras lojas.

Detalhes: Publish Contract e Marketplace.

---

Próximos passos

• Conceitos — loja, tema, seção e schema
• Theme SDK — dados no JSX
• Criar um tema completo
• Exemplos
• Solução de problemas