Ir para o conteúdo
Promovaweb

Build e publicação

Revisado em

A publicação de um site Astro usa a saída do build. Sites estáticos publicam os arquivos gerados, enquanto páginas renderizadas sob demanda exigem um adapter compatível com o provedor.

Comandos de build e preview

Comando Função
npm run build Executa o script de build definido no package.json
npx astro build Gera a saída de produção do Astro
npm run preview Executa o script de prévia definido no projeto
npx astro preview Abre a prévia local do último build
npx astro check Confere tipos e diagnósticos de arquivos .astro e TypeScript

A prévia usa o último build. Alterações posteriores exigem gerar outro build para aparecerem nela.

Configuração de publicação

Campo de astro.config.mjs Uso Padrão
site URL pública completa, usada como base para URLs canônicas e sitemap Sem valor definido
base Prefixo do caminho quando o site fica em uma subpasta /
outDir Diretório da saída de produção ./dist
output Modo de renderização padrão 'static'
adapter Integração com o ambiente de execução do provedor Sem adapter

Exemplo de domínio público configurado:

import { defineConfig } from 'astro/config'
export default defineConfig({
site: 'https://exemplo.com'
})

A opção site informa o endereço. A geração de sitemap exige configuração própria, como a integração correspondente.

Publicação estática e sob demanda

Forma de renderização Publicação
Todas as páginas geradas no build Hospedagem dos arquivos de dist/, sem adapter de servidor
Uma ou várias páginas sob demanda Adapter do provedor e ambiente de execução compatível
output: 'server' Renderização sob demanda por padrão

O comando astro build transpila TypeScript. A verificação de tipos usa astro check e pode integrar o script de build do projeto.

Cloudflare Workers

A documentação do Astro registra a recomendação da Cloudflare de usar Workers em projetos novos. A ficha Cloudflare para Astro reúne informações sobre a hospedagem.

Item Valor para site estático
Instalação do Wrangler npm install wrangler@latest --save-dev
Configuração wrangler.jsonc na raiz do projeto
Pasta de arquivos assets.directory: "./dist"
Prévia com Wrangler npx wrangler dev, após o build
Publicação npx wrangler deploy, após o build
Adapter para renderização sob demanda npx astro add cloudflare

Exemplo de wrangler.jsonc para saída estática:

{
"name": "site-astro",
"compatibility_date": "2026-11-06",
"assets": {
"directory": "./dist"
}
}

O campo compatibility_date define a data de compatibilidade do runtime do Workers. O guia do Astro indica preencher com a data do deploy. A configuração de renderização sob demanda usa também a entrada de servidor do adapter.

Netlify

Item Configuração
Origem Repositório Git conectado ao projeto
Comando de build npm run build
Diretório de publicação dist
Arquivo opcional netlify.toml na raiz
Adapter para renderização sob demanda npx astro add netlify

O site estático usa a configuração de build e diretório, sem adapter. O arquivo opcional registra esses valores no repositório:

[build]
command = "npm run build"
publish = "dist"

Conferência da publicação

Sintoma Conferência
Prévia mostra conteúdo antigo Gerar outro build
Provedor não localiza os arquivos Comparar o diretório publicado com outDir
Site em subpasta com caminhos incorretos Conferir base
Página sob demanda não funciona Conferir o adapter e o ambiente do provedor

PageSpeed Insights

Parte do relatório O que mostra
Mobile e desktop Análises com condições de teste diferentes
Diagnóstico de laboratório Análise do Lighthouse em ambiente simulado
Medições de acessos reais Experiência registrada no Chrome UX Report, quando disponível
Consulta da ferramenta Ficha do PageSpeed Insights

Depois da migração do site da Promovaweb para o Astro, a nota mobile no PageSpeed Insights ficou em 40. A correção posterior com o Claude levou o desktop a 100. A nota mobile final não foi registrada.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.