Como hospedar aplicações Qwik na Square Cloud

O Qwik reconstrói a experiência do usuário no navegador sem o peso do JavaScript inicial. Para hospedar uma aplicação Qwik City na Square Cloud, faça o build com um adaptador: o adaptador estático (recomendado, servido pelo runtime estático, sem processo Node.js) ou o adaptador Express para SSR.

1. Adicionando o adaptador estático

Sem um adaptador, o build falha com "Missing an integration". Na raiz do seu projeto local, adicione o adaptador estático:

npm run qwik add static

2. Gerando o build de produção

npm run build

Este comando grava em dist/ um HTML por página e um 404.html.

3. Configurando o runtime estático

Crie um arquivo squarecloud⁠.app dentro de dist/ (veja o arquivo de configuração):

MAIN=index.html
MEMORY=512
VERSION=recommended
DISPLAY_NAME=Meu site Qwik
SUBDOMAIN=meu-site-qwik

Não renomeie o index.html: rotas desconhecidas passam a servir o seu 404.html. Não é preciso comando de início nem configuração de porta; a Square Cloud serve os arquivos para você.

4. O que incluir no arquivo .zip?

Compacte o conteúdo de dist/ (não a pasta em si), incluindo o arquivo squarecloud⁠.app. O runtime estático não precisa de package.json nem de node_modules.

5. Qwik com SSR (opcional)

Se você precisa de SSR, use o adaptador Express:

1. Adicione o adaptador: npm run qwik add express.
2. Tire duas dependências de devDependencies, que não são instaladas na Square Cloud: npm install --save-prod undici dotenv.
3. Rode npm run build. No squarecloud⁠.app, use MAIN=server/entry.express.js, além de MEMORY, VERSION=recommended, DISPLAY_NAME e SUBDOMAIN.
4. Compacte dist/, server/, package.json e squarecloud⁠.app. O servidor lê a PORT=80 definida pela plataforma.

Atualizado em: 04/10/2026