> ## 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 Remix (Node.js)

# Como hospedar aplicações Remix na Square Cloud

O Remix foi desenhado para carregar páginas instantaneamente através de buscas paralelas de dados. Para rodar sua aplicação na Square Cloud, o fluxo padrão envolve compilar o projeto para produção e utilizar a ferramenta nativa `remix-serve` para gerenciar as requisições na porta correta.

---

## 1. O Processo de Build

Antes de enviar sua aplicação para o ambiente de produção, você precisa compilar o código fonte. Esse processo otimiza suas rotas, componentes React e compila os arquivos do servidor.

No terminal do seu projeto local, execute:
```bash
npm run build
```

Por padrão (especialmente em versões modernas baseadas no Vite), o Remix gerará a pasta **`build/`** contendo o servidor compilado e os assets do cliente.

---

## 2. Configurando o Comando de Início (remix-serve)

Diferente de servidores Node customizados, o Remix fornece um pacote pronto chamado `remix-serve` para rodar a aplicação construída na pasta de build.

Seu comando de inicialização (definido no Dashboard ou no seu arquivo de configuração `squarecloud.app`) deve invocar esse utilitário:

```bash
npx remix-serve ./build/server/index.js
```
*(Nota: Certifique-se de validar o caminho exato do arquivo `index.js` gerado na sua pasta build, que pode variar levemente dependendo da sua versão do Remix ou arquivo de configuração do Vite).*

---

## 3. O que incluir no pacote de envio (.zip)?

Para garantir um deploy rápido, limpo e sem problemas de armazenamento, crie um arquivo `.zip` contendo apenas os artefatos de produção:

*   A pasta **`build/`** (Gerada pelo comando de build).
*   A pasta **`public/`** (Contém seus assets estáticos, como imagens e favicon).
*   O arquivo **`package.json`**.
*   O arquivo **`package-lock.json`** ou `yarn.lock`.

> **Atenção:** Nunca inclua a pasta `node_modules` no seu arquivo compactado. A Square Cloud fará uma instalação isolada e limpa das dependências diretamente no servidor após o upload.

---

## 4. Dicas de Produção

*   **Vite Versão:** Se você migrou recentemente o seu projeto Remix para o compilador do Vite, certifique-se de que seu arquivo `vite.config.ts` está configurado corretamente para produção.
*   **Variáveis do Lado do Servidor:** Lembre-se de que chaves de API secretas e strings de conexão com bancos de dados nunca devem ficar expostas no código. Adicione-as todas na aba de **Variáveis de Ambiente** no painel da Square Cloud. O Remix as acessará nativamente através de `process.env`.