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

# Cursor

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

O [Cursor](https://cursor.com) é um editor de código com IA integrada (baseado no VS Code). Com o
[Editor Local](https://allbay.mintlify.site/editor/editor-local.md), você descreve as mudanças e o Cursor 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.
* Cursor 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 a pasta no Cursor**

Use o chat (`Ctrl/Cmd + L`) ou a edição inline (`Ctrl/Cmd + K`).

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

> "Deixe o cabeçalho fixo no topo ao rolar a página."

O Cursor edita os arquivos; aceite as sugestões e salve — o CLI sincroniza.
Para mudanças em vários arquivos, use o chat com `@Codebase`.

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

Esta documentação tem um servidor **MCP**: com ele, o Cursor consulta as páginas da AllBay
enquanto trabalha. Crie o arquivo **`.cursor/mcp.json`** na raiz do tema (ele fica só na sua
máquina):

```json .cursor/mcp.json theme={null}
{
  "mcpServers": {
    "allbay-docs": {
      "url": "https://allbay.mintlify.app/mcp"
    }
  }
}
```

Depois, confira em **Settings → MCP** que o `allbay-docs` aparece ativo. O servidor oferece
busca na documentação e leitura das páginas.

> [!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 Cursor (recomendado)

Crie um arquivo **`.cursorrules`** na raiz do tema (ele fica só na sua máquina):

```md .cursorrules theme={null}
Este projeto é um tema AllBay em 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 %}. Alias logo após a entidade:
  {% load "product" as p, slug: "x" %}. Ids sempre entre aspas.
- Objetos: store, theme, config, settings, user, logged_in, categories, products, packages,
  product, gateways, socials, order, orders, posts, post, cart, terms, query, pathname.
- Preços com | money. Imagens já vêm como URL pronta (teste antes de usar);
  cdn_url só para hash de load "products"/"product"/"categories", com 4 argumentos.
- Schema: chaves só com letras, números e _ (sem hífen).
- Arquivos novos: só .liquid/.html/.css/.js, nomes em minúsculas até 32 caracteres.
- 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.
```

> [!TIP]
>
> Referencie [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).

> [!WARNING]
>
> Faça mudanças pequenas e confira o preview. 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.