Templates de página
Pasta:templates/
Define a composição padrão de cada tipo de página quando o tema é instalado na loja: quais sections aparecem e em qual ordem.
Arquivos obrigatórios
A CLI exige estes cinco. Sem eles,corvex validate falha (V2_REQUIRED_TEMPLATES em @corvex/theme-contract).
Arquivos recomendados
Não são exigidos pelo validador. O contrato também recomenda404.json.
Comportamento na vitrine publicada: Páginas de sistema.
Páginas customizadas podem usar
page.{handle}.json — ex.: page.sobre.json. A CLI reconhece esse sufixo ao descobrir templates do tipo página.
Formato do template
Sections com blocks podem incluir
blocks e block_order na instância — ver Block Contract.
Variantes de template
A CLI trata o nome do arquivo pelo trecho antes do primeiro ponto, com uma exceção:page.{handle}.json vira uma página com esse handle. Exemplo: page.sobre.json publica a página de handle sobre.
product.preorder.json não vira um segundo template de produto. O mapa usa a base product e o arquivo compete com product.json. Não use esse sufixo.
Na instalação do tema
Ao instalar o tema, a Corvex copia os templates do pacote como layout inicial da loja. O lojista edita instâncias (settings, ordem, blocks) no Editor — não o arquivotemplates/product.json do pacote original.
Criar templates no Editor
Monte a página no Editor, salve o rascunho e replique a composição no JSON do template se quiser que novas instalações comecem com o mesmo layout. Referência: scaffold oficial viacorvex init — pasta templates/.
Veja também
- Composição de templates — detalhes e variantes
- Theme Contract
- Section Contract