O que Astro faz?
Visão Geral
Astro é um framework web para construção de sites focados em conteúdo, que envia zero JavaScript por padrão. Sua arquitetura de ilhas hidrata apenas componentes interativos, alcançando excelentes pontuações no Lighthouse enquanto suporta React, Vue, Svelte ou qualquer framework de UI onde interatividade é necessária.
Instruções
- Ao criar páginas, use roteamento baseado em arquivos em
src/pages/com arquivos.astro,.mdou.mdx, e organize a estrutura compartilhada emsrc/layouts/. - Ao adicionar interatividade, use diretivas client em componentes de framework: prefira
client:visibleouclient:idleem vez declient:load, pois a maioria dos componentes não precisa de hidratação imediata. - Ao gerenciar conteúdo, defina Content Collections em
src/content/com esquemas Zod estritos usandodefineCollection(), e consulte comgetCollection()egetEntry(). - Ao escolher modos de renderização, use o padrão estático (SSG) para páginas de marketing e conteúdo, use
output: "server"para páginas dinâmicas, ou use renderização híbrida comexport const prerender = falsepor página. - Ao otimizar imagens, use o componente
<Image>deastro:assetspara conversão automática de formato (WebP/AVIF), redimensionamento e carregamento preguiçoso em vez de tags<img>cruas. - Ao adicionar transições de página, ative as View Transitions com
<ViewTransitions />para navegação SPA sem enviar um roteador do lado do cliente. - Ao integrar frameworks de UI, instale a integração apropriada (
@astrojs/react,@astrojs/vue,@astrojs/svelte) e use componentes Astro para conteúdo estático, recorrendo a componentes de framework apenas quando a interatividade for necessária.
Exemplos
Exemplo 1: Construir um blog com Content Collections
Solicitação do usuário: "Criar um blog Astro com conteúdo Markdown tipado"
Ações:
- Defina um blog Content Collection com esquema Zod para frontmatter (título, data, tags, autor)
- Crie uma rota dinâmica
src/pages/blog/[slug].astrocomgetStaticPaths() - Construa a página inicial do blog consultando
getCollection("blog")com ordenação - Adicione layout com meta tags SEO, navegação e View Transitions
Saída: Um blog gerado estaticamente com conteúdo validado, URLs limpas e transições de página suaves.
Exemplo 2: Adicionar componentes interativos a um site estático
Solicitação do usuário: "Adicionar um componente de busca React ao meu site de documentação Astro"
Ações:
- Instale a integração
@astrojs/react - Crie o componente de busca React com estado e manipulação de eventos
- Adicione o componente à página com a diretiva
client:idle - Passe dados estáticos como props do frontmatter da página Astro
Saída: Um site de documentação que é totalmente estático, exceto pela ilha de busca interativa.
Diretrizes
- Use componentes Astro (
.astro) para conteúdo estático; use React/Vue/Svelte apenas quando for necessária interatividade. - Prefira
client:visibleouclient:idleem vez declient:loadpara diretivas de hidratação. - Defina Content Collections com esquemas Zod estritos para capturar erros de conteúdo em tempo de build.
- Use
<Image>deastro:assetsem vez de tags<img>cruas para otimização automática. - Mantenha layouts enxutos com
<head>compartilhado, navegação e rodapé; coloque conteúdo específico da página nas páginas. - Use renderização híbrida: estática para páginas de marketing, SSR apenas para páginas personalizadas ou dinâmicas.
- Ative View Transitions para navegação SPA sem enviar um roteador.