Sites Estáticos

↓ Baixar .md

Sites Estáticos

Hospede sites estáticos e SPAs (Single Page Applications) com nginx, CDN e SSL automático.

O que São Sites Estáticos

Sites estáticos são aplicações que rodam inteiramente no browser — HTML, CSS, JavaScript e assets. Exemplos:

  • Landing pages
  • Documentação (como esta que você está lendo!)
  • SPAs com React, Vue, Svelte, etc.
  • Sites gerados por SSG (Next.js, Astro, VitePress, etc.)

Criando um Site Estático

  1. Acesse sua stack e clique em New App
  2. Selecione App como tipo
  3. Escolha Static como fonte
  4. Defina um nome pro app
  5. Clique em Create

Fazendo Upload

Após criar o app, você pode fazer upload dos arquivos de duas formas:

Upload de ZIP

  1. Na tela de edição do app, vá na seção Static Deploys
  2. Clique em Upload ZIP
  3. Selecione o arquivo ZIP contendo seus arquivos estáticos
  4. O PodCubo extrai e serve automaticamente

Dica: O ZIP deve conter o index.html na raiz ou dentro de uma única pasta (ex: dist/). O PodCubo detecta e ajusta automaticamente.

Deploy pelo GitHub

Você também pode conectar um repositório GitHub e fazer deploy estático via CI/CD. Basta buildar seu projeto e fazer upload do ZIP gerado.

Como Funciona

O PodCubo serve seus arquivos estáticos com nginx, configurado com:

  • SPA routing — requisições pra rotas que não existem como arquivo são redirecionadas pro index.html
  • Cache agressivo — assets (JS, CSS, imagens, fontes) recebem cache de 1 ano com header immutable
  • Gzip — compressão automática pra textos, CSS, JS e SVGs
  • CDN — todo o tráfego passa pelo Cloudflare com cache e proteção DDoS

Versionamento

Cada upload cria uma nova versão do deploy. Você pode:

  • Ver o histórico de deploys na seção Static Deploys
  • Ativar uma versão anterior com um clique (rollback instantâneo)

Domínio

Seu site estático recebe automaticamente um subdomínio *.podcubo.com. Você também pode configurar um domínio customizado na seção Basics do app.