> ## Documentation Index
> Fetch the complete documentation index at: https://allbay.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Edite seu tema AllBay com o Claude Code, por linguagem natural.

O [Claude Code](https://claude.com/claude-code) é o agente de código da Anthropic (terminal ou
extensão do VS Code). Com o [Editor Local](https://allbay.mintlify.site/editor/editor-local.md), você descreve o que quer e o
Claude edita os arquivos do tema.

## Pré-requisitos

* O [Editor Local](https://allbay.mintlify.site/editor/editor-local.md) com login feito e rodando na pasta do tema.
* Claude Code instalado.

## Passo a passo

**1. Baixe o tema e deixe o CLI rodando**

```bash theme={null}
mkdir meu-tema && cd meu-tema
npx allbay-editor@latest --template SEU_ID_DO_TEMPLATE
```

Deixe esse terminal aberto — ele sincroniza cada save.

**2. Abra o Claude Code na pasta**

Em outro terminal, na mesma pasta, rode `claude` (ou abra a pasta pela extensão do VS Code).

**3. Peça a mudança**

Descreva em português:

> "Adicione um banner promocional verde no topo da home."

O Claude edita os `.liquid`/`.css`/`.js`. Ao salvar, o CLI sincroniza.

## Conecte a documentação ao Claude (MCP)

Esta documentação tem um servidor **MCP**: com ele, o Claude consulta as páginas da AllBay
sozinho enquanto trabalha, em vez de adivinhar sintaxe e objetos. Rode uma vez, na pasta do tema:

```bash theme={null}
claude mcp add --transport http allbay-docs https://allbay.mintlify.app/mcp
```

O servidor oferece busca na documentação e leitura das páginas. Para conferir, rode `/mcp`
dentro do Claude Code.

> [!TIP]
>
> Para outras IAs, a documentação inteira também está em texto em
> [llms.txt](https://allbay.mintlify.app/llms.txt) (índice) e
> [llms-full.txt](https://allbay.mintlify.app/llms-full.txt) (conteúdo completo).

## Dê contexto ao Claude (recomendado)

Crie um arquivo **`CLAUDE.md`** na raiz do tema com as regras da plataforma. Ele fica só na sua
máquina (o CLI não envia `.md`):

```md CLAUDE.md theme={null}
# Tema AllBay (Liquid)

- Lógica `{% %}`, saída `{{ }}`. Componentes: `{% render 'components/nome', var: valor %}`
  (componentes só veem globais e parâmetros).
- Falsos: nil, false, 0 e "". Lista vazia [] é verdadeira — use `lista.size > 0`.
- Dados: `{% load "packages", limit: 8 %}` (cards com imagens prontas).
  Alias logo após a entidade: `{% load "product" as p, slug: "x" %}`. Ids sempre entre aspas.
- Globais: store, theme, config, settings, user, customer, logged_in, categories, products,
  packages, product, gateways, socials, order, orders, posts, post, cart, terms, query, pathname.
- Preços com `| money` (valores em reais). Desconto: `price | percent_off: comparison_price` → número.
- Imagens já vêm como URL pronta: use direto e teste antes (`{% if img %}`).
  `cdn_url` só para hash de `load "products"/"product"/"categories"`:
  `{{ x.image | cdn_url: 'products', x.id, 'image' }}`.
- Schema: `config/settings_schema.json`; chaves só com letras, números e `_` (sem hífen).
- Arquivos novos: só .liquid/.html/.css/.js, nomes em minúsculas até 32 caracteres,
  nas pastas pages, templates, layouts, components, snippets, sections, styles, scripts, assets.
- Login é da plataforma (não crie pages/login).
- Página nova: `pages/<nome>.liquid` vira `/pages/<nome>` (nunca `/<nome>`). Nome em minúsculas,
  sem ponto, sem subpasta e diferente das páginas da plataforma. Sem dados próprios: use
  `{% load %}`. Comece com `{% layout %}` e ponha um link para ela no tema.
- Docs: https://allbay.mintlify.app/editor/introducao (MCP: https://allbay.mintlify.app/mcp)

Faça UMA mudança por vez e confira no preview antes de seguir.
```

> [!TIP]
>
> Referencie as páginas de [Sintaxe](https://allbay.mintlify.site/editor/sintaxe.md), [Tags](https://allbay.mintlify.site/editor/tags.md),
> [Filtros](https://allbay.mintlify.site/editor/filtros.md), [Imagens](https://allbay.mintlify.site/editor/imagens.md) e
> [Variáveis Globais](https://allbay.mintlify.site/editor/variaveis-globais.md) para o Claude acertar de primeira.

> [!WARNING]
>
> Faça mudanças pequenas e confira o preview a cada passo. Antes de mexidas grandes, baixe o
> tema em `.zip` pelo painel como backup.


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