> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Cómo hacer tu primer deploy desde el Dashboard

## Requisitos previos

Antes de iniciar el proceso en el Dashboard, asegúrate de tener:
* Una cuenta activa y validada en Square Cloud.
* Un plan con recursos suficientes (RAM/CPU) para tu aplicación.
* El código de tu aplicación finalizado y probado localmente.

---

## 1. Preparando tu proyecto

Para que Square Cloud entienda y ejecute tu proyecto correctamente, debes asegurarte de que la estructura de los archivos sea la adecuada.

### El archivo de configuración (`squarecloud.app`)
Este es el paso más importante. Todo proyecto **debe** tener un archivo llamado `squarecloud.app` en la carpeta raíz. Este indica cómo debe manejar la infraestructura tu código. 

> Aunque nuestra plataforma cuenta con un sistema inteligente de creación automática de configuraciones vía dashboard, nada te impide ejercer tu lado 'power user'. Si prefieres anticiparte y configurar los archivos manualmente, siéntete libre de hacerlo: ¡apreciamos e incentivamos ese nivel de esmero técnico! 😉

Ejemplo básico de un `squarecloud.app` para Node.js:
```ini
DISPLAY_NAME=Mi Primer App
DESCRIPTION=Una aplicación increíble ejecutándose en Square Cloud
MAIN=index.js
MEMORY=512
VERSION=recommended
```

### Archivos de dependencias
Asegúrate de que el archivo que lista las librerías de tu proyecto esté en la raíz:
* **Node.js:** `package.json`
* **Python:** `requirements.txt`
* **Java:** `pom.xml` o `build.gradle`

Básicamente, recuerda mantener el archivo de dependencias correspondiente a tu entorno de ejecución (*runtime*) seleccionado.

---

## 2. Comprimiendo los archivos (.zip)

El Dashboard acepta la carga de proyectos en formato `.zip`. Para garantizar que el archivo se genere correctamente:

1. Selecciona **todos los archivos** de la raíz de tu proyecto (incluyendo el `squarecloud.app`, tu archivo principal y los archivos de dependencias).
2. Haz clic derecho y selecciona la opción de comprimir o zipear.
3. **Atención:** Comprime los archivos, **no** la carpeta que los contiene. Si abres el `.zip`, debes ver el código inmediatamente, y no una única carpeta raíz.
4. **Qué NO incluir en el .zip:** Evita enviar carpetas pesadas de dependencias generadas localmente, como `node_modules` (Node.js), `venv` (Python) o archivos ocultos pesados como la carpeta `.git`. Square Cloud instalará las dependencias automáticamente durante el despliegue.

---

## 3. Realizando la carga en el Dashboard

Con tu archivo `.zip` listo, es hora de enviar el proyecto a la plataforma.

1. Accede al [**Dashboard de Square Cloud**](https://squarecloud.app/dashboard) e inicia sesión.
2. En la pantalla inicial, localiza el botón **"New Application"** (Nueva Aplicación) o el área de carga.
3. Haz clic para seleccionar el archivo en tu computadora o simplemente **arrastra y suelta** tu archivo `.zip` en el área indicada.
4. Espera a que la barra de progreso se complete. El tiempo varía según el tamaño de tu proyecto y tu conexión a internet.

---

## 4. Siguiendo el Build y los Logs

Tan pronto como se complete la carga, Square Cloud iniciará automáticamente el proceso de *build* (construcción) de tu entorno.

1. Serás redirigido a la página de gestión de tu aplicación.
2. Accede a la pestaña **"Logs"** (o Terminal).
3. Sigue los mensajes en pantalla. Verás cómo la plataforma descarga tus dependencias (ej: ejecutando `npm install` o `pip install`) y, luego, inicia tu archivo principal.
4. Si tu código se ejecuta sin errores, verás el mensaje de éxito en la terminal, indicando que la aplicación está **Online**.

---

**¿Surgió algún error?**

La gran mayoría de los errores en el primer despliegue están relacionados con la ausencia del archivo `squarecloud.app`, errores de sintaxis dentro de este, o con que el `.zip` se haya comprimido de forma incorrecta (comprimiendo la carpeta en lugar de los archivos). Revisa los pasos anteriores o consulta la [Documentación Oficial](https://docs.squarecloud.app) para obtener más detalles sobre tu lenguaje de programación específico.