​

Defaults de section e block

Quero banners/slides na seção nova. Quando o lojista adicionar os próprios blocks, esses defaults não podem “competir” com o conteúdo real.

Theme Code (JSX + schema)
Theme Defaults (templates/*.json, groups/*.json)
Merchant Content (Editor → publicar)

​

O que cada camada faz

​

Regra para LLM e tema

1. Looks da home / PDP / coleção na instalação → templates/{type}.json com blocks + block_order preenchidos. Cada item é um block de verdade (type = pasta em blocks/).
2. Looks do header/footer → groups/*.json do mesmo jeito.
3. Campo de um block novo (lojista clica “Adicionar slide”) → default no blocks/{id}/schema.json. O build copia esses defaults para o componente quando ele ainda não tem props próprias. Não declare propriedade estática no componente. Imagem: default só se for asset do tema (URL ou path estável); senão deixe vazio e use fallback visual.
4. Seção sem nenhum block (paleta “Adicionar seção”, ou lojista apagou todos) → empty state da UI (“Adicione um slide”), não 2–3 <img> hardcoded.
5. Nunca faça:

// PROIBIDO
const slides = children?.length ? children : DEFAULT_BANNERS.map(...)

// PROIBIDO
{useSectionBlockCount() === 0 && <img src="/banner-padrao.jpg" />}

​

Slideshow / lista / cards — padrão canônico

{
  "type": "slider",
  "settings": { "autoplay": true, "interval": 5 },
  "blocks": {
    "slide-1": {
      "type": "slider-slide",
      "settings": {
        "heading": "Primeiro slide",
        "text": "Conteúdo inicial do tema."
      }
    },
    "slide-2": {
      "type": "slider-slide",
      "settings": {
        "heading": "Segundo slide",
        "text": "O lojista edita ou exclui este block."
      }
    }
  },
  "block_order": ["slide-1", "slide-2"]
}

<SectionBlockCanvas className="slider__track">
  {children}
</SectionBlockCanvas>

const bg = settings.image
  ? `url(${settings.image}) center/cover`
  : 'linear-gradient(135deg, #374151, #111827)';

​

Empty state (zero blocks)

​

Settings da section vs blocks

• Autoplay, altura, intervalo → default no schema da section.
• Cada banner, depoimento, item de FAQ → block no template (Theme Defaults) + default nos campos do block.
• Não coloque slides: [{ image, title }, …] num setting da section se o Editor já gerencia blocks.

​

corvex sync

​

Checklist

• Looks iniciais em templates/*.json (blocks + block_order), não no JSX
• Cada type de block existe em theme.json → blocks[] e no bundle
• default só em campos do schema. Sem propriedade estática no componente
• Fallback visual só quando um setting está vazio
• Zero blocks → empty state, não lista hardcoded
• Presets só no modal Adicionar; slides da home vêm de templates/*.json
• Canvas sempre {children} — Runtime API