> ## 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).

# Deploy de site estático (HTML, React, Vite)

## 1. Pré-requisitos
Antes de subir seu site, verifique se você possui:
* **Conta na Square Cloud:** Crie sua conta via [Página de Registro](https://squarecloud.app/pt-br/signup) (E-mail ou GitHub).
* **Plano Ativo:** É necessário um plano pago para realizar a hospedagem. Confira os [preços aqui](https://squarecloud.app/pt-br/pricing).

---

> **Nota:** A Square Cloud possui suporte nativo para sites estáticos com CDN premium incluso, garantindo que seu site carregue rápido em qualquer lugar do mundo.

## 2. Estrutura de arquivos obrigatórios
Certifique-se de que seu projeto possui ao menos o arquivo principal na raiz:

* `index.html`: O arquivo principal do seu site. Ou `vite.html`, caso utilize o framework Vite.
* `404.html`: (Opcional) Página personalizada para erros de "Not Found".

---

## 3. Preparando o projeto
Antes de enviar, verifique se todos os links para arquivos CSS e imagens estão funcionando localmente. 

> **Aviso importante:** Se você for fazer o upload diretamente pelo painel (website), não precisa se preocupar com arquivos de configuração agora, pois o sistema criará o arquivo `squarecloud.app` automaticamente para você se enviar via dashboard.

---

## 4. Como hospedar (Upload)
Com os arquivos prontos, você tem dois caminhos principais para colocar o site no ar:

### Opção A: Via dashboard (Mais fácil)
1. Acesse o painel da Square Cloud.
2. Clique em **Enviar Aplicação**.
3. Selecione a pasta do seu projeto ou arraste o arquivo `.zip`.
4. Informe **nome da aplicação**, aponte seu **arquivo principal** e marque **publicação na web** para definir seu subdomínio squareweb.app.

> **Dica:** Projetos estáticos não precisam de um "servidor" rodando (como Node.js ou Python), a própria Square Cloud já configura um servidor nginx para você.

### Opção B: Via CLI 

1. Instale a CLI:
```
npm i -g @squarecloud/cli
```
2. Autenticar na CLI: Pegue seu token de API na página de **Minha Conta**, indo na seção [**Autenticação**](https://squarecloud.app/pt-br/account/security) e solicitando a chave API; Em sequência, se autentique na CLI com o comando a seguir.
```
squarecloud auth login
```
3. Crie seu arquivo de configuração: o [arquivo de configuração](https://docs.squarecloud.app/pt-br/getting-started/config-file), `squarecloud.config` ou `squarecloud.app`, deve estar presente no seu projeto
4. Faça o upload:
```
squarecloud upload
```
* Ou se criou o zip:
```
squarecloud upload --file <caminho/para/zip>
```