Como hospedar aplicações SolidJS na Square Cloud

Hospedar SolidJS na Square Cloud é simples e extremamente eficiente. Dependendo da arquitetura do seu projeto, você seguirá pelo caminho do deploy estático ou pelo servidor de alta performance Vinxi.

1. Build

Se você utiliza o SolidJS padrão gerenciado pelo Vite, sua aplicação gera arquivos estáticos que precisam ser "servidos" por um processo Node.js leve.

Passo 1: Build de Produção

No seu terminal local, execute:

npm run build

Isso gerará a pasta dist/ na raiz do seu projeto.

2. Configurando a Porta e o Comando de Início

A Square Cloud disponibiliza a porta 80 para sua aplicação utilizar e receber requisições. Se você está usando o SolidStart, ele utiliza o Vinxi como motor de infraestrutura.

Nesse caso, a aplicação roda um servidor real que permite renderização no lado do servidor (SSR).

Comando de Inicialização

Geralmente, o SolidStart gera um output que pode ser iniciado via Node.js ou pelo próprio CLI do Vinxi:

npx vinxi start --port 80

(Verifique se o seu script de start no package.json já aponta para a execução correta na porta 80).

3. Preparando o Deploy (.zip)

Para garantir que o deploy seja rápido e sem erros, seu arquivo .zip deve conter apenas o essencial:

• Para Vite: Veja aqui.
• Para SolidStart/Vinxi: Pasta .output/ (ou dist/), package.json e package-lock.json.

Dica: Nunca envie a pasta node_modules. A Square Cloud fará a instalação limpa das dependências no servidor.

4. Variáveis de Ambiente (ENV)

Se o seu app SolidJS consome APIs ou possui chaves privadas:

1. Vá até o Dashboard da Square Cloud.
2. Na aba da sua aplicação, acesse Variáveis de Ambiente.
3. Configure chaves como API_URL ou DB_AUTH ali. No SolidJS, lembre-se que variáveis expostas ao cliente no Vite devem começar com VITE_.

5. Dicas de Performance

• Hydration: Se estiver usando SSR com SolidStart, monitore o uso de memória. O SolidJS é muito eficiente, mas o processo de hidratação no servidor consome recursos durante picos de tráfego.
• Cache: Use o armazenamento em cache da Square Cloud para assets estáticos (imagens, CSS) para diminuir o tempo de carregamento inicial (LCP).

Atualizado em: 14/05/2026