Ir para o conteúdo
Promovaweb
Guia independente da Promovaweb

Astro Seu site em HTML, com JavaScript só onde precisa.

O Astro é um framework web de código aberto que transforma componentes e Markdown em páginas HTML. O artigo do blog abre com o texto pronto, enquanto só o formulário de contato carrega o JavaScript do React.

Código aberto sob licença MIT, mantido pelo projeto Astro e colaboradores no GitHub.

O Astro separa o texto da página do JavaScript que ela precisa

Um framework para publicar conteúdo em HTML e carregar JavaScript nos componentes que precisam de interação.

O artigo chega ao navegador como HTML

Uma página de artigo precisa mostrar o texto e as imagens antes de oferecer interações. O Astro transforma componentes e conteúdo em HTML no servidor. A página pode ser gerada durante o build ou responder a cada acesso, conforme a configuração do projeto.

Os componentes interativos entram como ilhas. Você escolhe quais deles carregam JavaScript e quando isso acontece, enquanto o restante da página continua em HTML. Markdown, MDX e Content Collections organizam artigos e outras coleções no repositório, com esquemas para conferir os campos de cada entrada.

A página de leitura deixa de carregar um app inteiro no navegador

  • JavaScript numa página de leitura. Componentes Astro geram HTML por padrão. A interatividade de React, Vue ou outro framework fica nos componentes que recebem uma diretiva de cliente.
  • Cabeçalho repetido em cada página. Layouts e componentes compartilham a estrutura do site. Uma alteração no layout pode atender todas as páginas que o utilizam.
  • Artigos com campos diferentes. Content Collections permite declarar o esquema de títulos, datas e outros campos, apontando entradas incompatíveis durante a validação.
  • MDX ausente do projeto inicial. Integrações acrescentam suporte a MDX, sitemap e provedores de hospedagem conforme a necessidade do site.

O build junta conteúdo e layout antes de a página ir para o ar

O caminho abaixo representa uma página estática. A renderização sob demanda acrescenta um servidor e depende de um adapter compatível.

  1. ConteúdoO artigo fornece o texto e os campos usados pela página.
  2. ComponentesO layout reúne conteúdo, navegação e elementos compartilhados.
  3. BuildO projeto gera os arquivos para publicação.
  4. NavegadorRecebe HTML e os scripts necessários às interações declaradas.
Uma ilha só precisa de hidratação quando existe interação no navegador. Texto e imagens podem permanecer em HTML.
Entenda os conceitos do Astro

Site com mais leitura do que interação aproveita melhor as ilhas

  • Blogs e documentação. Você mantém várias páginas de leitura e quer compartilhar layouts, componentes e campos do conteúdo.
  • Portfólios e páginas comerciais. A maior parte da página apresenta conteúdo, com interações localizadas em formulários ou outros componentes.

Editor visual com estado em toda a tela fica melhor num framework de cliente

  • Aplicativo com estado compartilhado por toda a tela. Um editor visual ou painel com interações contínuas pode se beneficiar de uma aplicação centrada num framework de cliente. Compare a necessidade de estado antes de distribuir tudo em ilhas.

Imagem pesada e script externo ainda deixam a página lenta

  • Publicação e serviços. Hospedagem, domínio e integrações externas são escolhidos separadamente. Renderização sob demanda exige um ambiente compatível com o adapter.
  • Qualidade da página. Imagens grandes, scripts externos e estilos continuam afetando o carregamento. O framework não garante uma nota de desempenho.
Versão de referência
Astro 7.4 nos guias publicados deste portal.

Encontre o recurso para o seu site.

Integrações que entram com um astro add.

Todos os plugins
Oficial

@astrojs/cloudflare

Publique na Cloudflare as rotas que o Astro renderiza a cada requisição, com o adapter oficial, as sessões em Workers KV e o preview local do build.

Oficial

@astrojs/mdx

Escreva páginas e posts em .mdx e use componentes Astro ou React no meio do texto, com frontmatter e variáveis lidos no mesmo arquivo do projeto.

Oficial

@astrojs/react

Use componentes React em páginas Astro e carregue o JavaScript do React só nas ilhas com diretiva client, deixando o resto da página em HTML estático.

Oficial

@astrojs/sitemap

Gere o sitemap a cada build a partir das páginas do projeto, com a opção site preenchida e filtros para tirar do arquivo as páginas fora do índice.

Oficial

Starlight

Monte um site de documentação com o Starlight, o tema oficial do Astro, com navegação lateral, componentes prontos e páginas em Markdown ou em MDX.

Oficial

@astrojs/alpinejs

Adicione Alpine.js ao projeto Astro e use as diretivas do framework em qualquer componente, sem hidratação manual. Confira a opção entrypoint do projeto.

Changelog

Últimas versões do Astro

Ver o changelog completo
  1. Astro 7.4.12StableLer as notas
  2. Astro 7.4.11StableLer as notas
  3. Astro 7.4.10StableLer as notas
  4. Astro 7.4.9StableLer as notas
  5. Astro 7.4.8StableLer as notas
  6. Astro 7.4.7StableLer as notas
  7. Astro 7.4.6StableLer as notas
  8. Astro 7.4.5StableLer as notas
  9. Astro 7.4.4StableLer as notas
  10. Astro 7.4.3StableLer as notas

Portais relacionados

Sistemas ligados a este nas stacks e nos projetos, cada um com o próprio portal.

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.