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

# So erstellst du deine squarecloud.ignore-Datei

> Erfahre, wie du mit squarecloud.ignore Dateien aus Square Cloud-Deployments ausschließt

## Was ist die `squarecloud.ignore`-Datei?

Die `squarecloud.ignore`-Datei legt fest, welche Dateien und Ordner beim Hochladen oder Deployment einer Anwendung ausgeschlossen werden. Sie funktioniert mit der Square Cloud-Erweiterung für VS Code und der Square Cloud-CLI.

Die Syntax ähnelt `.gitignore`, daher kannst du Kommentare, Muster, Ordnerregeln und Negationsregeln verwenden.

## Datei erstellen

Erstelle eine Datei namens `squarecloud.ignore` im Projektstamm.

```gitignore theme={null}
# Lokale Abhängigkeiten
node_modules/

# Lokale und geheime Dateien
.env
.env.*

# Deployment klein halten
*.log
```

<Info>Die Datei muss genau `squarecloud.ignore` heißen.</Info>

## Syntax

Jede Zeile ist eine Regel. Eine passende Datei oder ein passender Ordner wird vom Deployment ausgeschlossen.

| Muster         | Trifft zu auf                                               |
| -------------- | ----------------------------------------------------------- |
| `file.txt`     | Eine Datei mit diesem Namen im selben Ordner wie die Regel. |
| `/config.json` | `config.json` im Projektstamm.                              |
| `logs/`        | Jeden Ordner namens `logs` und dessen Inhalt.               |
| `*.log`        | Dateien, die auf `.log` enden.                              |
| `**/cache/`    | Einen `cache`-Ordner auf jeder Ebene.                       |
| `# Kommentar`  | Ein Kommentar; schließt nichts aus.                         |

<Note>Verwende `/` als Trennzeichen für Ordner in Mustern, auch unter Windows.</Note>

## Häufige Beispiele

Schließe Entwicklungstools, erzeugte Dateien und lokale Geheimnisse aus, während Produktionsdateien im Deployment bleiben:

```gitignore theme={null}
# Abhängigkeiten und Tools
node_modules/
.vscode/
.idea/

# Umgebungsdateien
.env
.env.local

# Erzeugte Dateien
coverage/
__pycache__/
*.log

# Temporäre Dateien ignorieren
*.tmp
*.cache

```

## Anwendung

Die VS Code-Erweiterung und die CLI lesen `squarecloud.ignore`, wenn sie Dateien für den Upload oder das Deployment vorbereiten. Dateien, die einer Ausschlussregel entsprechen, werden nicht in den an die Produktionsumgebung gesendeten Inhalt aufgenommen.
Bewahre zur Laufzeit benötigte Dateien, etwa die in `MAIN` festgelegte Datei, außerhalb ignorierter Pfade auf.