Build e publicação
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.
