Astro 7.4.0

Resumo

O Astro 7.4.0 acrescenta a flag --timings ao astro build, a renderização paralela de páginas estáticas em modo experimental e serviços de imagem separados para build e runtime. A versão também permite substituir o HTML de redirecionamento dos builds estáticos e cria o handler notFound() para astro/fetch e astro/hono. O Node.js mínimo sobe para 22.22.0. A versão final reúne as betas 7.4.0-beta.0 e 7.4.0-beta.1.

Novidades

• Astro 7.4.0 — Diagnóstico do build: astro build --timings imprime, ao final, quanto tempo cada etapa consumiu. O resumo separa integrações, plugins de Markdown, processamento de imagens e realce de sintaxe.
• Astro 7.4.0 — Renderização paralela: a flag experimental.parallelPrerender renderiza as páginas estáticas em vários núcleos da CPU. Por padrão, o Astro usa todos os núcleos menos um. O campo workers limita esse número quando o build consome memória demais. O recurso não vale para adapters com renderização própria, caso do @astrojs/cloudflare.
• Astro 7.4.0 — Imagens: image.service aceita um serviço build e outro runtime. O primeiro otimiza as imagens das páginas pré-renderizadas e atende o servidor de desenvolvimento. O segundo cuida das páginas renderizadas sob demanda e do endpoint de imagens do site publicado.
• Astro 7.4.0 — Página de redirecionamento: a flag experimental.redirectPage permite criar src/pages/3xx.astro para substituir a página que o Astro gera em cada redirecionamento de um build estático. A página recebe from, to, status e delay como props e precisa conter a tag <meta http-equiv="refresh"> apontando para to.
• Astro 7.4.0 — Handlers compostos: o handler notFound() de astro/fetch e astro/hono renderiza a página 404 personalizada quando nenhuma rota corresponde. Ele atende entrypoints que não passam por App.render, como um app Hono usado diretamente como worker da Cloudflare.
• Astro 7.4.0 — Provedores de fontes: o callback opcional getFontProperties() informa os pesos, estilos, subconjuntos e formatos que uma família oferece. O Astro usa essa resposta para avisar sobre valores que o provedor não entrega. A função init() recebe fetch(), que repete requisições após falhas transitórias.
• Astro 7.4.0 — Integrações: as integrações controlam onde o Astro grava a saída de cliente, servidor e pré-renderização. Renderizadores personalizados leem esses caminhos em outputDirectories e informam as imagens usadas nas páginas pré-renderizadas.
• Astro 7.4.0 — Cloudflare: astro add @astrojs/cloudflare@beta instala o cf, cria o cloudflare.config.ts e gera os tipos com o cf.

Melhorias

• Astro 7.4.0 — Dependências internas: o pacote find-proc dá lugar ao tinyps. O astro help corrige a descrição do comando sync, que citava apenas as content collections.

Correções

• Astro 7.4.0 — Erros de pré-renderização: com src/fetch.ts personalizado e um adapter que pré-renderiza no próprio runtime, como o @astrojs/cloudflare, uma página que lançava erro virava um HTML vazio e o build terminava com sucesso. O build agora falha e mostra o erro original.
• Astro 7.4.0 — Content collections: o loader glob() deixa de engolir erros de renderização durante a sincronização. Um plugin remark ou rehype que lança erro faz o astro build terminar com código diferente de zero.
• Astro 7.4.0 — Imagens originais: o build descarta a imagem original quando o código lê apenas width ou height.
• Astro 7.4.0 — Adapters de deploy: as integrações de deploy voltam a ler os manifestos do Vite ao preparar a saída do build.

Breaking changes

• Astro 7.4.0 — Node.js: o Astro exige o Node.js 22.22.0 ou superior. Ambientes de build e servidores com uma versão anterior do Node.js 22 precisam ser atualizados antes de instalar a 7.4.0.

Ponto de Atenção

Builds que antes terminavam com sucesso podem falhar na 7.4.0, porque erros de pré-renderização e de plugins remark ou rehype interrompem o build. Integrações que leem config.image.service precisam tratar o caso com build e runtime, quando entrypoint e config chegam como undefined. Renderizadores que retornam um array simples em getStaticPaths() ou um Response simples em render() continuam funcionando, mas as imagens dessas páginas não são geradas. Provedores de fontes personalizados precisarão implementar getFontProperties() no Astro 8. Teste sugerido: rode node --version no ambiente de build, execute astro build --timings e confira se o build termina sem erro.

Notas da versão

As mudanças estão nas notas oficiais do Astro 7.4.0, publicadas em 15/10/2026. A beta 7.4.0-beta.0 saiu em 01/10/2026 e a beta 7.4.0-beta.1 em 02/10/2026. A versão atualiza @astrojs/internal-helpers para 0.13.0, @astrojs/markdown-satteri para 0.4.4 e @astrojs/telemetry para 3.4.0.