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

# Como criar seu arquivo squarecloud.ignore

> Aprenda a excluir arquivos dos deploys da Square Cloud usando o squarecloud.ignore

## O que é o arquivo `squarecloud.ignore`?

O arquivo `squarecloud.ignore` define quais arquivos e pastas devem ser excluídos quando você envia ou faz deploy de uma aplicação. Ele funciona com a extensão da Square Cloud para VS Code e com a CLI da Square Cloud.

A sintaxe é similar à de um arquivo `.gitignore`, então você pode usar comentários, padrões, regras para diretórios e regras de negação.

## Criando o arquivo

Crie um arquivo chamado `squarecloud.ignore` na raiz do projeto.

```gitignore theme={null}
# Dependências locais
node_modules/

# Arquivos locais e secretos
.env
.env.*

# Mantenha o deploy pequeno
*.log
```

<Info>O arquivo deve se chamar exatamente `squarecloud.ignore`</Info>

## Sintaxe

Cada linha é uma regra. O arquivo ou pasta correspondente é excluído do deploy.

| Padrão         | Correspondência                                       |
| -------------- | ----------------------------------------------------- |
| `file.txt`     | Um arquivo com esse nome no mesmo diretório da regra. |
| `/config.json` | `config.json` na raiz do projeto.                     |
| `logs/`        | Todo diretório chamado `logs` e seu conteúdo.         |
| `*.log`        | Arquivos que terminam em `.log`.                      |
| `**/cache/`    | Um diretório `cache` em qualquer nível.               |
| `# comentário` | Um comentário; não exclui nada.                       |

<Note>Use `/` como separador de diretórios nos padrões, inclusive no Windows.</Note>

## Exemplos comuns

Exclua ferramentas de desenvolvimento, arquivos gerados e segredos locais, mantendo os arquivos de produção no deploy:

```gitignore theme={null}
# Dependências e ferramentas
node_modules/
.vscode/
.idea/

# Arquivos de ambiente
.env
.env.local

# Arquivos gerados
coverage/
__pycache__/
*.log

# Ignore arquivos temporários
*.tmp
*.cache
```

## Como ele é aplicado

A extensão do VS Code e a CLI leem o `squarecloud.ignore` ao preparar os arquivos para envio ou deploy. Os arquivos que correspondem a uma regra de exclusão ficam fora do conteúdo enviado ao ambiente de produção.
Mantenha fora dos caminhos ignorados os arquivos necessários em tempo de execução, como o arquivo definido em `MAIN` na sua configuração.