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 sua aplicação Qwik (gerada via Qwik City no modo estático) na Square Cloud, o processo consiste em buildar o projeto e serví-lo através da biblioteca serve na porta obrigatória da plataforma.

1. Executando o Build de Produção

Antes de tudo, precisamos gerar os arquivos otimizados que serão entregues aos clientes. Na raiz do seu projeto local, execute o comando de compilação:

npm run build

Este comando processará seus componentes e gerará a pasta dist/ na raiz do projeto. É neste diretório que estão todos os arquivos HTML estruturados e os pequenos fragmentos de código prontos para a resumabilidade.

3. Ajustando a Porta 80 e o Comando de Inicialização

A Square Cloud utiliza a porta 80 para direcionar o tráfego. Configure o seu comando de início (seja no Dashboard ou no arquivo de configuração squarecloud.app) para apontar o servidor para a pasta de build usando os parâmetros corretos.

Comando de Início (Start Command):

npx serve -s dist -p 80

• -s (Single Page Application): Garante que o roteamento baseado em arquivos do Qwik City funcione perfeitamente, redirecionando requisições de rotas internas para o arquivo principal e evitando erros 404 ao atualizar a página.
• dist: Indica a pasta alvo que contém os arquivos compilados.
• -p 80: Define a porta de escuta obrigatória do ambiente Square Cloud.

4. O que enviar no arquivo .zip?

Para realizar um deploy limpo e ágil, compacte apenas os arquivos necessários para a execução em produção:

• A pasta dist/ completa.
• O arquivo package.json.
• O arquivo package-lock.json ou yarn.lock.

Lembrete: Deixe a pasta node_modules e a pasta src de fora do arquivo .zip. A Square Cloud se encarrega de instalar as dependências de forma limpa no servidor assim que o upload for concluído.

5. Qwik com SSR (Opcional)

Se em vez de gerar um site estático você estiver utilizando o Qwik City com um adaptador para SSR (como o adaptador para Node.js), a estrutura muda levemente:

1. O build gerará uma pasta de servidor (geralmente server/).
2. O comando de início passará a ser a execução do arquivo de entrada do servidor (ex: node server/entry.mjs).

Atualizado em: 18/05/2026