Cómo alojar aplicaciones Qwik en Square Cloud

Qwik reconstruye la experiencia del usuario en el navegador sin el peso del JavaScript inicial. Para alojar tu aplicación Qwik (generada vía Qwik City en modo estático) en Square Cloud, el proceso consiste en hacer el build del proyecto y servirlo a través de la biblioteca serve en el puerto obligatorio de la plataforma.

1. Ejecutando el build de producción

Ante todo, necesitamos generar los archivos optimizados que se entregarán a los clientes. En la raíz de tu proyecto local, ejecuta el comando de compilación:

npm run build

Este comando procesará tus componentes y generará la carpeta dist/ en la raíz del proyecto. Es en este directorio donde están todos los archivos HTML estructurados y los pequeños fragmentos de código listos para la resumabilidad.

3. Ajustando el puerto 80 y el comando de inicio

Square Cloud utiliza el puerto 80 para dirigir el tráfico. Configura tu comando de inicio (ya sea en el Dashboard o en el archivo de configuración) usando los parámetros correctos.

Comando de inicio (Start Command):

npx serve -s dist -p 80

• -s (Single Page Application): Garantiza que el enrutamiento basado en archivos de Qwik City funcione perfectamente, redirigiendo las peticiones de rutas internas al archivo principal y evitando errores 404 al actualizar la página.
• dist: Indica la carpeta objetivo que contiene los archivos compilados.
• -p 80: Define el puerto de escucha obligatorio del entorno Square Cloud.

4. ¿Qué enviar en el archivo .zip?

Para realizar un deploy limpio y ágil, comprime solo los archivos necesarios para la ejecución en producción:

• La carpeta dist/ completa.
• El archivo package.json.
• El archivo package-lock.json o yarn.lock.

Recordatorio: Deja la carpeta node_modules y la carpeta src fuera del archivo .zip. Square Cloud se encarga de instalar las dependencias de forma limpia en el servidor en cuanto se complete el upload.

5. Qwik con SSR (Opcional)

Si en vez de generar un sitio estático estás utilizando Qwik City con un adaptador para SSR (como el adaptador para Node.js), la estructura cambia ligeramente:

1. El build generará una carpeta de servidor (generalmente server/).
2. El comando de inicio pasará a ser la ejecución del archivo de entrada del servidor (ej.: node server/entry.mjs).

Actualizado el: 13/06/2026