> ## 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 alojar una aplicación SolidJS

# Cómo alojar aplicaciones SolidJS en Square Cloud

Alojar SolidJS en Square Cloud es simple y extremadamente eficiente. Dependiendo de la arquitectura de tu proyecto, seguirás el camino del deploy estático o el del servidor de alto rendimiento Vinxi.

---

## 1. Build

Si utilizas el SolidJS estándar gestionado por Vite, tu aplicación genera archivos estáticos que necesitan ser "servidos" por un proceso Node.js ligero.

### Paso 1: Build de producción
En tu terminal local, ejecuta:
```bash
npm run build
```
Esto generará la carpeta **`dist/`** en la raíz de tu proyecto.

## 2. Configurando el puerto y el comando de inicio

Square Cloud pone a disposición el **puerto 80** para que tu aplicación lo utilice y reciba peticiones. Si estás usando **SolidStart**, este utiliza **Vinxi** como motor de infraestructura.
En ese caso, la aplicación ejecuta un servidor real que permite renderizado del lado del servidor (SSR).

### Comando de inicio
Generalmente, SolidStart genera un script que utiliza la CLI de Vinxi:
```bash
npx vinxi start --port 80
```
*(Verifica que tu script de `start` en el package.json ya apunte a la ejecución correcta en el puerto 80).*

---

## 3. Preparando el deploy (.zip)

Para garantizar que el deploy sea rápido y sin errores, tu archivo `.zip` debe contener solo lo esencial:

*   **Para Vite:** Mira [aquí](https://help.squarecloud.app/es/article/como-desplegar-un-sitio-estatico-html-react-vite-en-square-cloud-1ix99kk/).
*   **Para SolidStart/Vinxi:** Carpeta `.output/` (o `dist/`), `package.json` y `package-lock.json`.

> **Consejo:** Nunca envíes la carpeta `node_modules`. Square Cloud hará la instalación limpia de las dependencias en el servidor.

---

## 4. Variables de entorno (ENV)

Si tu app SolidJS consume APIs o tiene claves privadas:
1.  Ve al **Dashboard de Square Cloud**.
2.  En la pestaña de tu aplicación, accede a **Variables de Entorno**.
3.  Configura claves como `API_URL` o `DB_AUTH` allí. En SolidJS, recuerda que las variables expuestas al cliente en Vite deben empezar con `VITE_`.

---

## 5. Consejos de rendimiento

*   **Hydration:** Si usas SSR con SolidStart, monitorea el uso de memoria. SolidJS es muy eficiente, pero el proceso de hidratación en el servidor consume recursos durante picos de tráfico.
*   **Caché:** Usa el almacenamiento en caché de Square Cloud para assets estáticos (imágenes, CSS) para disminuir el tiempo de carga inicial (LCP).