Bundle de agência

Sections customizadas em React, build com Corvex CLI e publish no catálogo.

Sections customizadas no tema

Temas podem incluir sections próprias (slideshow, depoimentos, etc.) compiladas no bundle do tema e publicadas com a Corvex CLI.

Não é necessário modificar código interno da plataforma.

---

Fluxo

sections/{id}/section.jsx + schema.json
        ↓
corvex build .
        ↓
.corvex/theme.js
        ↓
corvex publish .  →  catálogo

Instalar na loja não é o padrão. corvex publish --update --install é que pede a instalação. Para a loja ligada no dia a dia, use corvex sync.

---

Estrutura

meu-tema/
├── theme.json          # lista section ids
├── sections/
│   └── slideshow/
│       ├── section.jsx
│       ├── schema.json
│       └── styles.css

Registrar o id em theme.json → sections: ["slideshow", ...].

---

Componente mínimo

export default function SlideshowSection({ settings = {} }) {
  return (
    <section>
      <h2>{settings.title}</h2>
    </section>
  );
}

O schema fica só em sections/slideshow/schema.json. O corvex build anexa esse JSON ao componente. Não exporte schema no JSX e não atribua SlideshowSection.schema.

---

APIs públicas

Pacote	Uso
@corvex/theme-sdk	defineSection, defineSectionData, usePage, useCorvexCart
@corvex/runtime	SectionChrome, integrações documentadas em Runtime API

Dados: SDK overview · pitfalls.

---

Build e publish

corvex validate .
corvex build .
corvex publish . --visibility PRIVATE

Ou loop de desenvolvimento:

corvex sync --open

---

Checklist nova section

1. sections/{id}/section.jsx + schema.json
2. Id em theme.json → sections[]
3. corvex validate . · corvex build .
4. corvex sync ou corvex publish

Golden path: Criar hero · Cookbooks