> ## 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 Qwik

# 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:

```bash
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):
```bash
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`).