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

# Comment créer votre fichier squarecloud.ignore

> Découvrez comment exclure des fichiers de vos déploiements Square Cloud avec squarecloud.ignore

## Qu'est-ce que le fichier `squarecloud.ignore` ?

Le fichier `squarecloud.ignore` définit les fichiers et dossiers à exclure lors de l'envoi ou du déploiement d'une application. Il fonctionne avec l'extension Square Cloud pour VS Code et avec la CLI Square Cloud.

Sa syntaxe est similaire à celle de `.gitignore` : vous pouvez utiliser des commentaires, des motifs, des règles de dossiers et des règles de négation.

## Créer le fichier

Créez un fichier nommé `squarecloud.ignore` à la racine du projet.

```gitignore theme={null}
# Dépendances locales
node_modules/

# Fichiers locaux et secrets
.env
.env.*

# Garder le déploiement léger
*.log
```

<Info>Le fichier doit s'appeler exactement `squarecloud.ignore`</Info>

## Syntaxe

Chaque ligne est une règle. Le fichier ou le dossier correspondant est exclu du déploiement.

| Motif           | Correspondance                                               |
| --------------- | ------------------------------------------------------------ |
| `file.txt`      | Un fichier portant ce nom dans le même dossier que la règle. |
| `/config.json`  | `config.json` à la racine du projet.                         |
| `logs/`         | Chaque dossier nommé `logs` et son contenu.                  |
| `*.log`         | Les fichiers se terminant par `.log`.                        |
| `**/cache/`     | Un dossier `cache` à n'importe quel niveau.                  |
| `# commentaire` | Un commentaire ; il n'exclut rien.                           |

<Note>Utilisez `/` comme séparateur de dossiers dans les motifs, y compris sous Windows.</Note>

## Exemples courants

Excluez les outils de développement, les fichiers générés et les secrets locaux tout en conservant les fichiers de production dans le déploiement :

```gitignore theme={null}
# Dépendances et outils
node_modules/
.vscode/
.idea/

# Fichiers d'environnement
.env
.env.local

# Fichiers générés
coverage/
__pycache__/
*.log

# Fichiers temporaires
*.tmp
*.cache

```

## Fonctionnement

L'extension VS Code et la CLI lisent `squarecloud.ignore` lorsqu'elles préparent les fichiers à envoyer ou à déployer. Les fichiers correspondant à une règle d'exclusion ne sont pas inclus dans le contenu envoyé à l'environnement de production.
Conservez hors des chemins ignorés les fichiers nécessaires à l'exécution, comme le fichier défini par `MAIN`.