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 una aplicación Qwik City en Square Cloud, haz el build con un adaptador: el adaptador estático (recomendado, servido por el runtime estático, sin proceso Node.js) o el adaptador Express para SSR.

1. Añadiendo el adaptador estático

Sin un adaptador, el build falla con "Missing an integration". En la raíz de tu proyecto local, añade el adaptador estático:

npm run qwik add static

2. Generando el build de producción

npm run build

Este comando escribe en dist/ un HTML por página y un 404.html.

3. Configurando el runtime estático

Crea un archivo squarecloud⁠.app dentro de dist/ (consulta el archivo de configuración):

MAIN=index.html
MEMORY=512
VERSION=recommended
DISPLAY_NAME=Mi sitio Qwik
SUBDOMAIN=mi-sitio-qwik

No renombres el index.html: las rutas desconocidas pasan a servir tu 404.html. No hace falta comando de inicio ni configuración de puerto; Square Cloud sirve los archivos por ti.

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

Comprime el contenido de dist/ (no la carpeta en sí), incluido el archivo squarecloud⁠.app. El runtime estático no necesita package.json ni node_modules.

5. Qwik con SSR (opcional)

Si necesitas SSR, usa el adaptador Express:

1. Añade el adaptador: npm run qwik add express.
2. Saca dos dependencias de devDependencies, que no se instalan en Square Cloud: npm install --save-prod undici dotenv.
3. Ejecuta npm run build. En el squarecloud⁠.app, usa MAIN=server/entry.express.js, además de MEMORY, VERSION=recommended, DISPLAY_NAME y SUBDOMAIN.
4. Comprime dist/, server/, package.json y squarecloud⁠.app. El servidor lee el PORT=80 definido por la plataforma.

Actualizado el: 04/10/2026