Documentação

Guia de publicação

Um guia prático para publicar sites estáticos, preparar builds de frameworks, conectar domínios e atualizar projetos no DeployPages.

Publicar ReactExportar Next.jsConsulta DNSVerificar SSLGerador de meta tags

Primeiros passos

Publicar um site significa transformar os arquivos locais em uma URL que qualquer pessoa consiga abrir. O DeployPages foi feito para saída estática, então a primeira publicação pode começar com uma pasta, sem configurar servidor.

Opção 1: publicação arrastando arquivos

O caminho mais rápido para projetos estáticos. Se o site já está em HTML, CSS, JavaScript ou em uma pasta de build pronta, envie essa pasta diretamente.

Funciona bem para

Landing pages, sites pessoais, currículos online, protótipos, documentação estática e outros frontends que o navegador abre sem backend.
  • 1
    Prepare a pasta do projeto

    A pasta publicável deve ter um arquivo index.html na raiz, além dos estilos, scripts e imagens usados pela página.

    Estrutura de pasta exemplo
    meu-site/├── index.html├── styles.css├── script.js└── images/    ├── logo.png    └── hero.jpg

    Erro comum

    Se o index.html estiver faltando ou dentro de uma subpasta, o site não vai abrir corretamente depois do envio.
  • 2
    Abra a área de envio

    Use a área de envio do DeployPages. Você pode publicar um projeto temporário primeiro e entrar na conta depois, se quiser manter o site.

  • 3
    Envie a pasta

    Arraste a pasta inteira para a área de envio ou escolha pelo seletor de arquivos. Em frameworks, envie a pasta de build, não a árvore de código-fonte.

  • 4
    Abra a URL gerada

    Quando o envio terminar, o DeployPages retorna uma URL pública que você pode usar na hora para testar ou compartilhar.

Opção 2: fluxo por CLI

Útil quando o mesmo build é publicado várias vezes e o deploy precisa entrar em um script, job de CI ou checklist de publicação.

Use quando o processo já for repetível

Arrastar arquivos é melhor para prévias pontuais. Um fluxo por CLI faz sentido quando a equipe precisa publicar a mesma pasta de saída sempre do mesmo jeito.

Instale a CLI

Use o gerenciador de pacotes de sua preferência para instalar a CLI globalmente.

npm install -g @deploypages/cli

Faça login

Rode o comando de login e conclua a autorização no navegador.

deploypages login

Publique a pasta atual

Rode o comando de deploy dentro da pasta de saída do build.

deploypages deploy

Guia de build para frameworks

Frameworks modernos precisam de uma etapa de build antes do envio. O objetivo é sempre o mesmo: gerar arquivos estáticos em HTML, CSS, JavaScript e assets que o navegador consiga abrir diretamente.

O que significa build

O build converte o código do framework em arquivos publicáveis: HTML, CSS, JavaScript e assets.

React / Vue / Vite

Command:npm run build
Output:dist/

Envie a pasta dist, não a raiz do projeto.

Exportação estática do Next.js

Command:npm run build
Output:out/

Defina output: 'export' no next.config.js antes do build.

HTML puro

Command:Nenhum build é necessário
Output:Sua pasta atual

Mantenha o index.html na raiz.

Hugo / Hexo

Command:hugo ou hexo generate
Output:public/

Envie a pasta public gerada.

Exemplo de exportação no Next.js

next.config.js
/** @type {import('next').NextConfig} */const nextConfig = {  output: 'export',  images: { unoptimized: true },};
module.exports = nextConfig;

Limites da exportação estática

Recursos renderizados no servidor, como API routes, server-side props e middleware, não ficam disponíveis em um build exportado como estático.

Domínios personalizados

Depois da primeira publicação, o DeployPages pode conectar seu próprio domínio para tirar o projeto da URL do sistema e colocá-lo em um endereço com a sua marca.

O que conta como domínio?

Qualquer domínio administrado por você em um registrador pode funcionar, desde que você consiga editar os registros DNS.

Passo 1: adicione o domínio no console

Entre nas configurações do projeto, abra a aba de domínios e adicione o hostname que deseja conectar.

Passo 2: configure o DNS

O DeployPages mostra os destinos DNS necessários para verificar propriedade e direcionar o tráfego.

Passo 3: aguarde a verificação

Quando a propagação DNS terminar, o status do domínio fica saudável e o certificado SSL pode ser emitido para HTTPS automático.

TipoHostValorFinalidade
CNAMEwwwcname.deploypages.siteDirecionar o tráfego para a plataforma
TXT_deploypages-challengedeploypages-verify=...Verificar a propriedade do domínio

Como escolher o registro de host

  • Use www ao conectar www.example.com.
  • Use @ ao conectar o domínio raiz example.com.
  • Use um rótulo de subdomínio, como blog, ao conectar blog.example.com.

Atualizar um site

Mesmo processo, nova versão

Atualizar um projeto segue a mesma lógica da primeira publicação: gere a saída mais recente, envie a pasta e deixe a plataforma trocar a versão no ar.
  • 1
    Edite os arquivos de origem

    Altere textos, estilos, mídia ou assets localmente.

  • 2
    Gere um novo build quando necessário

    Se o projeto usa framework, primeiro gere uma pasta de saída atualizada.

  • 3
    Abra o console do projeto

    Volte para a página do projeto no DeployPages.

  • 4
    Envie a nova versão

    Substitua o build anterior pela pasta mais recente. O histórico de publicações mantém a nova versão rastreável.

Assim que o envio termina, o novo build entra no ar e as versões anteriores continuam disponíveis para restaurar versão anterior.

Perguntas frequentes

Quem não é desenvolvedor consegue usar o DeployPages?
Sim. Se o site já foi exportado como arquivos estáticos, publicar arrastando a pasta é suficiente.
Por que aparece 404 depois da publicação?
O motivo mais comum é um index.html ausente ou no lugar errado. O arquivo de entrada precisa ficar na raiz da pasta enviada.
E se rotas de React ou Vue quebrarem ao atualizar a página?
O DeployPages aceita comportamento de fallback para SPA em setups comuns de frontend estático, mas o build ainda precisa ser exportado corretamente.
Posso enviar vídeos ou assets maiores?
Sim, mas a performance costuma ser melhor quando mídias muito grandes são otimizadas ou servidas pelo canal especializado certo.
Posso proteger um site com senha?
Sim, nos planos que incluem proteção por senha. Use para prévias, documentação interna ou lançamentos em estágio de revisão.
Ir para Explorar