> ## 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 fazer seu primeiro deploy pelo Dashboard

## Pré-requisitos

Antes de iniciar o processo na Dashboard, certifique-se de que você possui:
* Uma conta ativa e validada na Square Cloud.
* Um plano com recursos suficientes (RAM/CPU) para a sua aplicação.
* O código da sua aplicação finalizado e testado localmente.

---

## 1. Preparando o seu projeto

Para que a Square Cloud entenda e execute o seu projeto corretamente, você precisa garantir que a estrutura dos arquivos está adequada.

### O Arquivo de Configuração (`squarecloud.app`)
Este é o passo mais importante. Todo projeto **precisa** ter um arquivo chamado `squarecloud.app` na pasta raiz. Ele dita como a infraestrutura deve lidar com o seu código. 

> Embora nossa plataforma conte com um sistema inteligente de criação automática de configurações via dashboard, nada impede que você exerça seu lado 'power user'. Se preferir se antecipar e configurar os arquivos manualmente, sinta-se à vontade: nós apreciamos, e incentivamos esse nível de capricho técnico! 😉

Exemplo básico de um `squarecloud.app` para Node.js:
```ini
DISPLAY_NAME=Meu Primeiro App
DESCRIPTION=Uma aplicação incrível rodando na Square Cloud
MAIN=index.js
MEMORY=512
VERSION=recommended
```

### Arquivos de Dependências
Certifique-se de que o arquivo que lista as bibliotecas do seu projeto está na raiz:
* **Node.js:** `package.json`
* **Python:** `requirements.txt`
* **Java:** `pom.xml` ou `build.gradle`

Basicamente lembre-se de manter o arquivo de dependências correspondente a seu runtime selecionado.

---

## 2. Compactando os arquivos (.zip)

O Dashboard aceita o upload de projetos no formato `.zip`. Para garantir que o arquivo seja gerado corretamente:

1. Selecione **todos os arquivos** da raiz do seu projeto (incluindo o `squarecloud.app`, seu arquivo principal e os arquivos de dependência).
2. Clique com o botão direito e selecione a opção de compactar/zipar.
3. **Atenção:** Compacte os arquivos, **não** a pasta que os contém. Se você abrir o `.zip`, deve ver o código imediatamente, e não uma única pasta raiz.
4. **O que NÃO incluir no .zip:** Evite enviar pastas pesadas de dependências geradas localmente, como `node_modules` (Node.js), `venv` (Python) ou arquivos ocultos pesados como a pasta `.git`. A Square Cloud instalará as dependências automaticamente durante o deploy.

---

## 3. Realizando o Upload no Dashboard

Com o seu arquivo `.zip` pronto, é hora de enviar o projeto para a plataforma.

1. Acesse o [**Dashboard da Square Cloud**](https://squarecloud.app/dashboard) e faça o login.
2. Na tela inicial, localize o botão **"New Application"** (Nova Aplicação) ou a área de upload.
3. Clique para selecionar o arquivo no seu computador ou simplesmente **arraste e solte** o seu arquivo `.zip` na área indicada.
4. Aguarde a barra de progresso ser concluída. O tempo varia de acordo com o tamanho do seu projeto e a sua conexão com a internet.

---

## 4. Acompanhando o Build e os Logs

Assim que o upload for concluído, a Square Cloud iniciará automaticamente o processo de *build* (construção) do seu ambiente.

1. Você será redirecionado para a página de gerenciamento da sua aplicação.
2. Acesse a aba **"Logs"** (ou Terminal).
3. Acompanhe as mensagens na tela. Você verá a plataforma baixando suas dependências (ex: executando `npm install` ou `pip install`) e, em seguida, iniciando o seu arquivo principal.
4. Se o seu código rodar sem erros, você verá a mensagem de sucesso no terminal, indicando que a aplicação está **Online**.

---

**Deu algum erro?**

A grande maioria dos erros no primeiro deploy está relacionada à ausência do arquivo `squarecloud.app`, erros de digitação dentro dele, ou ao `.zip` ter sido compactado de forma errada (zipando a pasta ao invés dos arquivos). Revise os passos acima ou consulte a [Documentação Oficial](https://docs.squarecloud.app) para mais detalhes sobre a sua linguagem de programação específica.