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

# Cómo crear tu archivo squarecloud.ignore

> Aprende a excluir archivos de tus despliegues de Square Cloud con squarecloud.ignore

## ¿Qué es el archivo `squarecloud.ignore`?

El archivo `squarecloud.ignore` define qué archivos y carpetas deben excluirse al subir o desplegar una aplicación. Funciona con la extensión de Square Cloud para VS Code y con la CLI de Square Cloud.

Su sintaxis es similar a la de `.gitignore`, por lo que puedes usar comentarios, patrones, reglas de directorios y reglas de negación.

## Crear el archivo

Crea un archivo llamado `squarecloud.ignore` en la raíz del proyecto.

```gitignore theme={null}
# Dependencias locales
node_modules/

# Archivos locales y secretos
.env
.env.*

# Mantén pequeño el despliegue
*.log
```

<Info>El archivo debe llamarse exactamente `squarecloud.ignore`</Info>

## Sintaxis

Cada línea es una regla. El archivo o carpeta que coincida se excluye del despliegue.

| Patrón         | Coincide con                                                    |
| -------------- | --------------------------------------------------------------- |
| `file.txt`     | Un archivo con este nombre en el mismo directorio que la regla. |
| `/config.json` | `config.json` en la raíz del proyecto.                          |
| `logs/`        | Cada directorio llamado `logs` y su contenido.                  |
| `*.log`        | Archivos que terminan en `.log`.                                |
| `**/cache/`    | Un directorio `cache` en cualquier nivel.                       |
| `# comentario` | Un comentario; no excluye nada.                                 |

<Note>Usa `/` como separador de directorios en los patrones, también en Windows.</Note>

## Ejemplos comunes

Excluye herramientas de desarrollo, archivos generados y secretos locales, manteniendo los archivos de producción en el despliegue:

```gitignore theme={null}
# Dependencias y herramientas
node_modules/
.vscode/
.idea/

# Archivos de entorno
.env
.env.local

# Archivos generados
coverage/
__pycache__/
*.log

# Ignorar archivos temporales
*.tmp
*.cache

```

## Cómo se aplica

La extensión de VS Code y la CLI leen `squarecloud.ignore` al preparar los archivos para subir o desplegar. Los archivos que coinciden con una regla de exclusión quedan fuera del contenido enviado al entorno de producción.
Mantén fuera de las rutas ignoradas los archivos necesarios en tiempo de ejecución, como el archivo definido en `MAIN`.