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

# Cookbooks

> Índice dos Cookbooks Corvex — implementações canônicas para developers de Theme.

> Referências para tarefas comuns em temas Corvex. Cada cookbook documenta **somente APIs públicas** (`@corvex/theme-sdk`, `@corvex/runtime` documentado, Corvex CLI).

**Import canônico:** `@corvex/theme-sdk` · Snippets: `@corvex/snippets/{id}` · Runtime: [Runtime API](https://docs-loja.usecorvex.com.br/reference/runtime-api.md).

***

## Validar seu tema

Depois de adaptar um cookbook à sua pasta de tema:

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

Com loja vinculada:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex sync --open
```

***

## Índice

| Cookbook | Quando usar | Foco |
| - | - | - |
| [Header](https://docs-loja.usecorvex.com.br/cookbook/header.md) | Menu, navegação, cart link | `StorefrontNav`, layout group |
| [FAQ](https://docs-loja.usecorvex.com.br/cookbook/faq.md) | Accordion com blocks | Blocks repetíveis, a11y |
| [Colunas agrupadas](https://docs-loja.usecorvex.com.br/cookbook/grouped-columns.md) | Grupo com filhos | `BlockCanvas`, JSON aninhado |
| [Slider](https://docs-loja.usecorvex.com.br/cookbook/slider.md) | Carrossel + slides | Blocks, estado local, [defaults](https://docs-loja.usecorvex.com.br/guides/theme-defaults.md) |
| [Featured Product](https://docs-loja.usecorvex.com.br/cookbook/featured-product.md) | Um produto + `addItem` | `defineSectionData`, cart |
| [Product Card](https://docs-loja.usecorvex.com.br/cookbook/product-card.md) | Card reutilizável + grid | Snippet + `product_list` |
| [Grade com blocos de catálogo](https://docs-loja.usecorvex.com.br/cookbook/catalog-product-grid.md) | Card montável no editor (imagem, título, preço…) repetido em cada produto | Blocks `catalog-product-*` + `renderCatalogProductBlocks` |
| [Variant Selector](https://docs-loja.usecorvex.com.br/cookbook/variant-selector.md) | Opções → variante | Snippet, `addItem` |
| [Cart Drawer](https://docs-loja.usecorvex.com.br/cookbook/cart-drawer.md) | Drawer lateral | `useCorvexCart`, estado local |
| [Search Results](https://docs-loja.usecorvex.com.br/cookbook/search-results.md) | Página `/search` | `usePage('search')` |
| [Product Recommendations](https://docs-loja.usecorvex.com.br/cookbook/product-recommendations.md) | PDP “relacionados” | `recommendations.list` |
| [Product Reviews](https://docs-loja.usecorvex.com.br/cookbook/product-reviews.md) | Avaliações na PDP | `reviews.list` |
| [Newsletter Capture](https://docs-loja.usecorvex.com.br/cookbook/newsletter-capture.md) | Formulário de leads | `useCaptureLead` |
| [Blog & Article](https://docs-loja.usecorvex.com.br/cookbook/blog-article.md) | Blog e artigo | `usePage('blog'/'article')` |
| [Collection Grid](https://docs-loja.usecorvex.com.br/cookbook/collection-grid.md) | Grid de coleções | `collection_list` |
| [Hero com vídeo](https://docs-loja.usecorvex.com.br/cookbook/video-hero.md) | Hero imagem/vídeo + biblioteca de vídeos da loja | `video`, snippet `CorvexVideo` |

***

## Separação de responsabilidades

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Resolução de produto (picker, get)
  → Featured Product, Product Card

UI de produto (ProductSummary)
  → Product Card snippet (layout fixo no código)

Card de grade editável bloco a bloco no editor
  → Cookbook catalog-product-grid (Padrão C)

Seleção de variante (Product já resolvido)
  → Variant Selector snippet

Carrinho
  → useCorvexCart().addItem(product, qty, variant?)
  → Cart Drawer (open = estado local na sua layout)

Leads
  → useCaptureLead(source).capture({ email, optedIn })

Blog
  → o contexto da página já vem do template. usePage não escolhe blog ou artigo pelo argumento
```

***

## Contratos normativos

* [Section](https://docs-loja.usecorvex.com.br/reference/contracts/section.md) · [Block](https://docs-loja.usecorvex.com.br/reference/contracts/block.md) · [Snippet](https://docs-loja.usecorvex.com.br/reference/contracts/snippet.md)
* [Product](https://docs-loja.usecorvex.com.br/reference/contracts/product.md) · [Cart](https://docs-loja.usecorvex.com.br/reference/contracts/cart.md) · [Data](https://docs-loja.usecorvex.com.br/reference/contracts/data.md)
* [Runtime API](https://docs-loja.usecorvex.com.br/reference/runtime-api.md)

***

## Para agentes (LLM)

1. `AGENTS.md` e `llms.txt` na pasta desta documentação (não são páginas do site)
2. Contrato do recurso (`reference/contracts/*`)
3. Cookbook correspondente
4. `corvex validate .` no tema do developer

***

## Veja também

* [Golden Path — tema completo](https://docs-loja.usecorvex.com.br/guides/create-theme.md)
* [Golden Path — product grid](https://docs-loja.usecorvex.com.br/guides/create-product-grid.md)
* [Quickstart](https://docs-loja.usecorvex.com.br/introduction/quickstart.md)


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