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

# Quickstart

> Crie, valide e abra seu primeiro tema Corvex em poucos minutos.

Crie o primeiro tema e abra no editor. Este guia assume uma agência, parceiro ou tema próprio — sem acesso ao código interno da Corvex.

***

## Pré-requisitos

Antes de começar:

* **Node.js** `>= 18` (exigido pela [Corvex CLI](https://docs-loja.usecorvex.com.br/cli/overview.md))
* **Corvex CLI** instalada globalmente
* **Acesso a uma loja Corvex** na qual você pode instalar temas
* Conhecimento básico de **React** e **JavaScript**

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
npm install -g @corvex/theme-cli
corvex --version
```

***

## 1. Criar o tema

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
mkdir minha-loja
cd minha-loja
corvex init . --name "Minha Loja" --slug minha-loja
```

A pasta precisa estar vazia. O init copia o starter (layout, templates, seções de exemplo e `config/settings`) e imprime `Tema criado em …`, o `name`, o `slug` e quatro próximos passos numerados. Não há uma linha `✓ Tema criado`.

***

## 2. Autenticar e vincular a loja

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex auth
corvex link
```

`corvex auth` salva credenciais locais (API key da sua conta ou fluxo interativo).\
`corvex link` associa esta pasta a uma loja de desenvolvimento.

Ver [CLI — autenticação](https://docs-loja.usecorvex.com.br/cli/overview.md).

***

## 3. Validar

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

A CLI avisa se faltam capturas em `screenshots/` para o marketplace público. O tema continua válido. A linha de sucesso usa slug e versão separados por `@`:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Tema válido: minha-loja@1.0.0
```

O validate não exige o bundle. Rode o build em seguida.

***

## 4. Compilar e abrir no Editor

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

`corvex sync` compila o tema, publica uma versão privada no catálogo da sua conta e instala na loja vinculada. Com `--open`, o Editor abre no navegador.

***

## 5. Publicar no catálogo (opcional)

Quando o tema estiver pronto para outras lojas ou versões:

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

Use `--visibility PUBLIC` apenas se sua conta tem permissão para o marketplace público.

Guarde o `themeVersionId` retornado para instalação em outras lojas.

Detalhes: [Publish Contract](https://docs-loja.usecorvex.com.br/reference/contracts/publish.md) e [Marketplace](https://docs-loja.usecorvex.com.br/marketplace/overview.md).

***

## Próximos passos

* [Conceitos](https://docs-loja.usecorvex.com.br/introduction/fundamentos.md) — loja, tema, seção e schema
* [Theme SDK](https://docs-loja.usecorvex.com.br/sdk/overview.md) — dados no JSX
* [Criar um tema completo](https://docs-loja.usecorvex.com.br/guides/create-theme.md)
* [Exemplos](https://docs-loja.usecorvex.com.br/cookbook/overview.md)
* [Solução de problemas](https://docs-loja.usecorvex.com.br/guides/troubleshooting.md)


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