> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Como hospedar um site estático na Vertra Cloud

> Faça deploy de um site estático (HTML, CSS, JavaScript ou build de framework) na Vertra Cloud, com index.html como ponto de entrada e SSL automático.

## Requisitos

* Arquivos HTML, CSS e JavaScript
* Conta na [Vertra Cloud](https://vertracloud.app)

## Estrutura do projeto

```
my-site/
├── index.html
├── css/
│   └── style.css
├── js/
│   └── app.js
├── images/
│   └── logo.png
└── vertracloud.config  (optional)
```

## Configuração

### vertracloud.config

```ini theme={null}
MAIN=index.html
SUBDOMAIN=my-site
```

## Exemplo: página de apresentação

### index.html

```html theme={null}
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>My Site</title>
  <link rel="stylesheet" href="css/style.css">
</head>
<body>
  <header>
    <h1>Welcome to My Site</h1>
    <p>Hosted on Vertra Cloud</p>
  </header>
  <script src="js/app.js"></script>
</body>
</html>
```

## Deploy

**Painel**

1. Compacte o projeto em um `.zip` (pastas como `node_modules`, `venv` e `target` são removidas automaticamente) ou envie para o GitHub.
2. No painel, clique em **Novo Projeto** e envie o `.zip` ou cole a URL do repositório.
3. Em **Build**, confira o runtime (**Static**), o arquivo principal (`index.html`) e a memória. Os comandos de start e de build ficam em **Configurações Avançadas**.
4. Adicione suas variáveis de ambiente em **Ambiente**.
5. Em **Rede**, ative a **publicação web** para que a aplicação receba um endereço `*.vertraweb.app` (plano Pro ou superior, 512 MB de memória). A aplicação precisa escutar na porta 80.
6. Revise e faça o deploy. Acompanhe a saída na aba **Logs**.

**CLI**

```bash theme={null}
vertra upload
vertra logs -f
```

Veja [CLI](https://docs.vertracloud.app/pt-br/cli.md) para instalação e login.

**VS Code**

Abra a pasta com a extensão da Vertra Cloud instalada e execute **Fazer deploy do projeto atual**. Veja [Extensão do VS Code](https://docs.vertracloud.app/pt-br/vscode-extension.md).

O passo a passo completo está em [Primeiro deploy](https://docs.vertracloud.app/pt-br/how-to-host.md).

## Frameworks de frontend compilados

Para projetos React, Vue, Svelte ou Angular, faça o build localmente e envie somente a pasta de saída:

**React (Vite)**

```bash theme={null}
npm run build
# Compacte o conteúdo da pasta dist/
```

**Vue**

```bash theme={null}
npm run build
# Compacte o conteúdo da pasta dist/
```

**Svelte**

```bash theme={null}
npm run build
# Compacte o conteúdo da pasta build/
```

**Angular**

```bash theme={null}
ng build
# Compacte o conteúdo da pasta dist/project-name/
```

> [!WARNING]
>
> Envie somente o conteúdo da pasta de build (arquivos compilados), e não o código-fonte inteiro. O arquivo `index.html` precisa estar na raiz do ZIP.

## Observações

* Sites estáticos não precisam de servidor de backend
* Todas as rotas são servidas pelo servidor interno da plataforma
* **SSL automático** (HTTPS) em todos os domínios
* **CDN** e cache automático para os arquivos estáticos
* Não há suporte a reescrita de rotas (SPAs com roteamento no cliente precisam de configuração especial)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.