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

# Come creare il tuo file squarecloud.ignore

> Scopri come escludere file dai deploy di Square Cloud usando squarecloud.ignore

## Cos'è il file `squarecloud.ignore`?

Il file `squarecloud.ignore` definisce quali file e cartelle devono essere esclusi quando carichi o esegui il deploy di un'applicazione. Funziona con l'estensione Square Cloud per VS Code e con la CLI Square Cloud.

La sintassi è simile a quella di `.gitignore`, quindi puoi usare commenti, pattern, regole per cartelle e regole di negazione.

## Creare il file

Crea un file chiamato `squarecloud.ignore` nella radice del progetto.

```gitignore theme={null}
# Dipendenze locali
node_modules/

# File locali e segreti
.env
.env.*

# Mantieni leggero il deploy
*.log
```

<Info>Il file deve chiamarsi esattamente `squarecloud.ignore`</Info>

## Sintassi

Ogni riga è una regola. Il file o la cartella corrispondente viene escluso dal deploy.

| Pattern        | Corrisponde a                                               |
| -------------- | ----------------------------------------------------------- |
| `file.txt`     | Un file con questo nome nella stessa cartella della regola. |
| `/config.json` | `config.json` nella radice del progetto.                    |
| `logs/`        | Ogni cartella chiamata `logs` e il suo contenuto.           |
| `*.log`        | I file che terminano con `.log`.                            |
| `**/cache/`    | Una cartella `cache` a qualsiasi livello.                   |
| `# commento`   | Un commento; non esclude nulla.                             |

<Note>Usa `/` come separatore delle cartelle nei pattern, anche su Windows.</Note>

## Esempi comuni

Escludi strumenti di sviluppo, file generati e segreti locali, mantenendo i file di produzione nel deploy:

```gitignore theme={null}
# Dipendenze e strumenti
node_modules/
.vscode/
.idea/

# File dell'ambiente
.env
.env.local

# File generati
coverage/
__pycache__/
*.log

# Ignora i file temporanei
*.tmp
*.cache

```

## Come viene applicato

L'estensione VS Code e la CLI leggono `squarecloud.ignore` quando preparano i file da caricare o distribuire. I file che corrispondono a una regola di esclusione non vengono inclusi nel contenuto inviato all'ambiente di produzione.
Tieni fuori dai percorsi ignorati i file necessari durante l'esecuzione, come quello definito in `MAIN`.