Pastas
Arquivos novos só podem ser criados nestas pastas (diretamente dentro delas):
Arquivos que vieram com o tema base podem estar em outros lugares e continuam valendo.
O tema Vega usa:
components/, layouts/layout.liquid, pages/ (com
pages/account/), scripts/, styles/core.css e um tailwind.config.json na raiz.Tipos de arquivo
Qualquer outra extensão (
.ts, .jsx, .md, .svg, imagens, fontes…) é recusada.
Imagens não ficam no tema: entram pelos campos image/images do
schema e são servidas pela CDN (ver Imagens).
Limites
Nomes de arquivo
- Arquivos novos: só letras minúsculas, números,
.,_e-; o primeiro caractere precisa ser letra ou número. Ex.:product-card.liquid. - Nada de espaços nem caracteres fora do ASCII visível.
dotfiles(.env,.git/…) e segmentos./..são recusados em qualquer nível.- Arquivos novos ficam a no máximo 2 níveis (
components/card.liquid), ou 3 empages/account/.
Arquivos de sistema
tailwind.config.json e config/settings_schema.json são arquivos de sistema: o conteúdo
é editável, mas eles só podem existir nesses caminhos. No editor web, eles, a página
inicial e os arquivos do tema base aparecem como travados (sem apagar/renomear).
Componentes
Inclua um componente com{% render %}:
'navbar'), a AllBay procura a partir da raiz do tema, depois em
snippets/ e depois em components/ — com a extensão dada, .liquid, .html ou sem
extensão. Ver Tags.
Layouts
Duas formas de envolver as páginas — ver Páginas:- Automática: se existir
layouts/base.liquid, toda página é renderizada dentro dele, no lugar de{{ content_for_layout }}. - Declarada: a página começa com
{% layout 'layouts/layout' %}e o conteúdo dela entra no{% block %}{% endblock %}do layout (é o que o Vega usa).
Resolução de páginas (aliases)
Cada rota resolve para um arquivo de entrada, e você não precisa nomear tudo exatamente igual. A AllBay tenta, em ordem:templates/<nome>(.liquid, depois.html);templates/<alias>;pages/<nome>;pages/<alias>.
product ≡ package, collection ≡ category,
cart ≡ checkout, 404 ≡ not-found. O nome canônico sempre vence o alias.
Por isso o Vega (que só tem pages/) atende a rota de produto com
pages/package.liquid e a de coleção com pages/category.liquid. Ver a tabela
completa em Páginas.
Configuração (schema)
O arquivoconfig/settings_schema.json define as opções que aparecem no painel
(cores, textos, imagens…). Ver Schema.