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

# Getting started

> Instalar e usar Corvex Storefront Components em HTML ou no playground.

## Playground local

O pacote é privado `0.1.0` até publish autorizado:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
yarn workspace @corvex/storefront-elements test
yarn workspace @corvex/storefront-playground dev
```

Playground: `http://localhost:5179` (porta Vite padrão do app).

## HTML mínimo

```html theme={"theme":{"light":"github-light","dark":"github-dark"}}
<!doctype html>
<html lang="pt-BR">
  <body>
    <corvex-store mode="mock">
      <corvex-product handle="camiseta-basica"></corvex-product>
      <corvex-cart></corvex-cart>
    </corvex-store>
    <script type="module">
      import '@corvex/storefront-elements';
    </script>
  </body>
</html>
```

## Live (dados públicos da loja)

```html theme={"theme":{"light":"github-light","dark":"github-dark"}}
<corvex-store
  mode="live"
  store-id="SEU_STORE_ID"
  api-base="https://api.example.usecorvex.com.br"
>
  <corvex-product-list first="8"></corvex-product-list>
</corvex-store>
```

Sem tokens admin. Sem cookies de dashboard. Preço e estoque vêm da API pública.

## Variantes e add-to-cart

Para produto com várias variantes, `corvex-variant-selector` emite `corvex:variant-change` e `corvex-add-to-cart` envia o `productVariantId` selecionado — mesmo contrato do Theme SDK (`CartLineInput`).

## Distribuição

Planejada: npm + ESM/CDN após publish. **Não** use URLs inventadas. Até lá, use o playground documentado acima.


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