> ## Documentation Index
> Fetch the complete documentation index at: https://docs-loja.usecorvex.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```jsx theme={"theme":{"light":"github-light","dark":"github-dark"}}
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](https://docs-loja.usecorvex.com.br/reference/runtime-api.md) |

Dados: [SDK overview](https://docs-loja.usecorvex.com.br/sdk/overview.md) · [pitfalls](https://docs-loja.usecorvex.com.br/data/pitfalls.md).

***

## Build e publish

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex validate .
corvex build .
corvex publish . --visibility PRIVATE
```

Ou loop de desenvolvimento:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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](https://docs-loja.usecorvex.com.br/guides/create-hero-section.md) · [Cookbooks](https://docs-loja.usecorvex.com.br/cookbook/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.