Criar um tema completo
O caminho é o scaffold oficial.corvex init copia o starter, ajusta name e slug no theme.json e para. Não monte um segundo tema à mão com outros nomes de seção.
Este percurso foi executado com a CLI deste repositório (@corvex/theme-cli 2.3.5), numa pasta vazia fora de qualquer loja: init, validate e build passaram. auth, link e sync não rodaram. Eles exigem conta e loja.
Pré-requisitos
Node.js>= 18. CLI instalada (npm install -g @corvex/theme-cli). React básico. Conta e loja só entram no sync.
A pasta de destino precisa estar vazia. Se não estiver, o init recusa com A pasta de destino não está vazia.
Criar
corvex init, a frase Tema criado em …, name e slug, e quatro próximos passos numerados: entrar na pasta, corvex auth, corvex link ., corvex sync --open. O slug só aceita a-z, 0-9 e hífen.
O que vem no starter
theme.json lista essas seções, os blocos heading e text, e os grupos de layout. O cabeçalho é header-nav. O rodapé é footer. Não existe site-header nem product-detail no scaffold.
Os cinco templates obrigatórios são index, product, collection, cart e search. blog, article e page vêm junto e são recomendados.
A home (templates/index.json) coloca a seção hero e depois featured-products.
Validar e compilar
validate pode avisar que faltam screenshots/desktop e screenshots/mobile. Esse aviso não invalida o tema. Ele importa para o marketplace público. A linha de sucesso é Tema válido: minha-loja@1.0.0. O bundle não precisa existir antes do validate.
build grava .corvex/theme.js e, se o tema tiver locales, .corvex/locales.json. Não versione .corvex/.
Ver no editor
sync publica uma versão privada e instala na loja vinculada. Sem loja, o comando não tem como abrir o editor. Detalhe das flags: Comandos.
corvex publish envia o código ao catálogo. O botão Publicar do editor envia o conteúdo da loja. São ações diferentes.
Onde continuar
Não substitua os arquivos do starter pelos exemplos longos de versões antigas deste guia. Parta dos arquivos que o init criou e altere um de cada vez.