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:

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:

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í.
• 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).

Actualizado el: 13/06/2026