> ## 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.

# O que é o Corvex Store V2

> Plataforma de storefronts em React — Themes, Sections, Templates e Theme SDK.

# Corvex Store V2

Corvex Store V2 é a plataforma de desenvolvimento de **storefronts** baseada em **React**. Você entrega **Themes** com Sections, Blocks, Snippets e Templates; a plataforma fornece o **Editor visual**, o **Preview** e a **loja publicada**.

> [!NOTE]
>
> A [Corvex Store V1](https://corvex.mintlify.app/introduction/overview) usa contratos diferentes (engine legada). A V2 usa **React (JSX)**. Não assuma compatibilidade entre versões.

***

## Modelo mental

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Theme
  → Layout (wrapper global)
  → Template / Page (composição de sections)
  → Sections (regiões da página)
  → Blocks (subcomponentes opcionais dentro da section)
```

* **Snippets** — componentes React reutilizáveis importados por Sections (não são páginas).
* **Theme SDK** (`@corvex/theme-sdk`) — interface pública para dados da loja, carrinho, menus, hooks e helpers.

O merchant compõe páginas no Editor (ordem das sections, settings). O desenvolvedor de tema define **o que pode ser editado** via `schema.json` e **como renderizar** via JSX.

***

## O que você desenvolve

| Artefato | Responsabilidade |
| - | - |
| **Theme** | Manifest, layout, templates padrão, settings globais, bundle de sections/blocks |
| **Section** | Bloco de UI de página com `schema.json` + `section.jsx` |
| **Block** | Subitem editável dentro de uma section |
| **Snippet** | Componente compartilhado (ex.: card de produto) |
| **Template** | JSON com sections padrão para um tipo de página (`index`, `product`, …) |

***

## O que a plataforma faz

* Renderiza o tema no **Editor** (preview ao vivo) e no **Storefront** (visitantes)
* Persiste **draft** (edição) separado de **published** (loja ao vivo)
* Resolve **dados da loja** (produtos, coleções, carrinho, …) e injeta nas sections conforme contrato
* Valida e compila o tema via **CLI** (`corvex validate`, `corvex build`)

***

## Contratos canônicos

A fonte normativa da V2 está em **Reference → Contracts**. Comece por:

> **[Theme Contract](https://docs-loja.usecorvex.com.br/reference/contracts/theme.md)**
>
> Estrutura e manifest

> **[Section Contract](https://docs-loja.usecorvex.com.br/reference/contracts/section.md)**
>
> Section JSX + schema

> **[Schema Contract](https://docs-loja.usecorvex.com.br/reference/contracts/schema.md)**
>
> Settings e field types

> **[Data Contract](https://docs-loja.usecorvex.com.br/reference/contracts/data.md)**
>
> Dados disponíveis para o tema

***

## Por onde começar

> **[Fundamentos](https://docs-loja.usecorvex.com.br/introduction/fundamentos.md)**
>
> Loja, tema, página, seção e bloco

> **[Conceitos](https://docs-loja.usecorvex.com.br/introduction/concepts.md)**
>
> Vocabulário e fluxo draft → published

> **[Quickstart](https://docs-loja.usecorvex.com.br/introduction/quickstart.md)**
>
> Primeiro tema com a CLI

> **[Estrutura do tema](https://docs-loja.usecorvex.com.br/themes/structure.md)**
>
> Árvore de arquivos V2

> **[SDK](https://docs-loja.usecorvex.com.br/sdk/overview.md)**
>
> `@corvex/theme-sdk`

> **[Cookbooks](https://docs-loja.usecorvex.com.br/cookbook/overview.md)**
>
> Referências com smoke tests

***

## Separação da documentação

| Área | Função |
| - | - |
| `reference/contracts/*` | Contratos canônicos (o que é obrigatório e opcional) |
| `themes/*`, `sections/*`, `data/*` | Explicação e detalhes |
| `guides/*` | Passo a passo |
| `cookbook/*` | Soluções práticas validáveis ([índice](https://docs-loja.usecorvex.com.br/cookbook/overview.md)) |


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