> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como hospedar uma aplicação SolidJS

# 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:
```bash
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:
```bash
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](https://help.squarecloud.app/pt-br/article/como-fazer-deploy-de-um-site-estatico-html-react-vite-142t186).
*   **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).