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.

---

Validar seu tema

Depois de adaptar um cookbook à sua pasta de tema:

corvex validate .
corvex build .

Com loja vinculada:

corvex sync --open

---

Índice

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

---

Separação de responsabilidades

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 · Block · Snippet
• Product · Cart · Data
• Runtime API

---

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
• Golden Path — product grid
• Quickstart