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

# Theme Check

> Análise ampliada de qualidade do tema — diagnósticos estruturados, regras, configuração e CI.

`corvex check` complementa `corvex validate` com diagnósticos estruturados de qualidade e boas práticas.

| Comando | Papel |
| - | - |
| `corvex validate` | Contrato obrigatório (manifest, schemas, templates, estrutura) |
| `corvex check` | Validate + SDK, JSX, acessibilidade estática, performance, schema experimental |

Os dois usam os mesmos contratos públicos. Uma mesma infração produz o mesmo `ruleId`, severidade e mensagem na CLI e no MCP.

## Uso

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex check .
corvex check . --json
corvex check . --list
corvex check . --severity warning
corvex check . --fix --dry-run
corvex check . --config ./corvex.check.json
```

Não exige autenticação nem loja.

## Flags

| Flag | Efeito |
| - | - |
| `--json` | Só JSON no stdout (adequado a CI e agentes) |
| `--fix` | Autocorreções seguras (BOM/newline em JSON) |
| `--dry-run` | Com `--fix`, lista o que seria alterado |
| `--list` | Lista regras oficiais |
| `--severity` / `--fail-on` | `error` (default), `warning` ou `info` |
| `--config` | Caminho de `corvex.check.json` |
| `--path` / `--theme` | Raiz do tema |
| `--watch` | Reexecuta ao salvar |
| `--verbose` | Logs extras (em `--json`, vão para stderr) |

## Exit codes

* `0` — passou segundo `failOn` (default: sem `error`)
* `1` — falhou segundo `failOn`

Warnings sozinhos não falham o CI com o default.

## Diagnóstico

Cada item inclui `ruleId`, `severity`, `file`, `line`/`column` quando disponíveis, `message`, `suggestion`, `docsUrl`, `fixable` e `contractVersion`.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "ruleId": "CVX-SCHEMA-001",
  "severity": "error",
  "file": "sections/hero/schema.json",
  "message": "Tipo de configuração não suportado: \"warp\".",
  "suggestion": "Utilize um tipo previsto no contrato público.",
  "fixable": false
}
```

## Taxonomia de regras

Prefixos oficiais:

| Prefixo | Categoria |
| - | - |
| `CVX-CONTRACT-*` | Resultado do validador oficial |
| `CVX-SCHEMA-*` | Tipos de setting (desconhecido / experimental) |
| `CVX-SDK-*` | Imports do SDK / runtime |
| `CVX-JSX-*` | Sintaxe e export default de section/block |
| `CVX-A11Y-*` | Acessibilidade estática (parcial) |
| `CVX-PERF-*` | Heurísticas de performance |
| `CVX-CONFIG-*` | Configuração do próprio check |

Rode `corvex check --list` para a lista completa.

## Configuração

Arquivo opcional na raiz do tema: `corvex.check.json`.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "version": 1,
  "failOn": "error",
  "ignore": [".corvex/**", "node_modules/**"],
  "categories": {
    "contract": true,
    "schema": true,
    "sdk": true,
    "jsx": true,
    "a11y": true,
    "performance": true
  },
  "rules": {
    "CVX-A11Y-001": "warning"
  },
  "performance": {
    "maxAssetBytes": 524288
  }
}
```

Desligar uma regra: `"CVX-PERF-001": "off"` ou `false`.

## Autocorreção

`--fix` só aplica transformações determinísticas (hoje: remover BOM UTF-8 e garantir newline final em JSON de schema/config). Não altera carrinho, preço, checkout nem hooks com efeito colateral.

## Acessibilidade e performance

As regras de a11y são estáticas e parciais — não são auditoria WCAG completa. Condições que dependem de renderização exigem análise dinâmica.

Performance usa limiares de tamanho de asset; classificadas como `warning`.

## CI

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

Use `--severity warning` se quiser falhar também em avisos.


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