Temas e templates para Astro
Os temas desta galeria são os templates oficiais do Astro, com capturas feitas rodando cada um deles. Você cria um projeto a partir de qualquer tema com um único npm create astro.
Blog, template oficial do Astro
Comece um blog com o template oficial do Astro: posts em Markdown e MDX numa Content Collection, feed RSS, sitemap e tags de Open Graph já configurados.

O template Blog é o ponto de partida que o projeto Astro mantém para blogs. Você recebe um blog funcionando, com posts de exemplo, a listagem em /blog/ e o layout de leitura de cada artigo.
O que já vem configurado
Os posts ficam em src/content/blog/ como arquivos Markdown ou MDX. O template já declara a coleção, então o frontmatter de cada post é validado no build. A listagem em /blog/ lê essa coleção e mostra capa, título e data.
O package.json traz as integrações @astrojs/mdx, @astrojs/rss e @astrojs/sitemap. O feed sai em rss.xml. O sitemap é gerado a cada build. O README lista ainda URLs canônicas e tags de Open Graph em todas as páginas.
Crie o projeto
npm create astro@latest -- --template blogDepois de criar, edite o cabeçalho em src/components/Header.astro, o rodapé em src/components/Footer.astro e o layout do post em src/layouts/BlogPost.astro. Esses são os três arquivos que o próprio template indica para personalizar primeiro.
Quando usar
O template traz um visual mínimo e intencional. Use quando você quer o blog funcionando já no primeiro build e prefere desenhar o visual por cima. Entre os templates oficiais, é a base mais próxima de um site com artigos em Markdown no repositório, como o da Promovaweb.
Portfolio, template oficial do Astro
Monte a sua página pessoal com o template Portfolio do Astro: apresentação com foto, trabalhos numa Content Collection, página Sobre e tema escuro.

O template Portfolio monta uma página pessoal de desenvolvedor, com apresentação, lista de trabalhos e uma página Sobre. A única dependência do package.json é o próprio Astro, então você recebe o projeto sem nenhuma integração para manter.
Onde ficam os trabalhos
Os trabalhos ficam em src/content/work/, um arquivo por projeto. A página /work/ lista essa coleção. Cada trabalho ganha a própria página. A página inicial abre com nome, uma frase de apresentação, as funções em destaque e uma foto. No cabeçalho, um seletor troca entre o tema claro e o escuro.
Crie o projeto
npm create astro@latest -- --template portfolioTroque o nome, a foto e os links das redes antes de publicar. A foto e o nome da captura são fictícios e fazem parte do exemplo.
Quando usar
Use quando você precisa de uma página para apresentar trabalhos a clientes ou recrutadores e quer partir de um visual já resolvido, com gradientes e cartões prontos.
Starlog, template de changelog
Publique as notas de versão do seu produto com o Starlog, template de changelog dos exemplos oficiais do Astro, feito com Sass e com tema claro e escuro.

O Starlog é um template para publicar as notas de versão de um produto. Cada versão ganha um bloco que mostra o número e a data à esquerda, com o texto ao lado. Os estilos são escritos em Sass, com modo claro e escuro.
Onde ficam as versões
As notas ficam em src/content/releases/, um arquivo Markdown por versão. Para publicar uma versão nova, você cria o arquivo com o número e a data no frontmatter e escreve o que mudou. A página monta a linha do tempo em ordem.
Crie o projeto
npm create astro@latest -- --template starlogO package.json traz o Sass como dependência, então os estilos ficam em arquivos .scss.
Quando usar
Use quando o seu produto precisa de um changelog público fora da documentação, com uma página própria e visual de lançamento.
Template Nanostores
O template Nanostores do Astro demonstra um carrinho com estado compartilhado entre ilhas Preact e uma página de produto. Veja os componentes e arquivos.

Instalação
npm create astro@latest -- --template with-nanostoresO template Nanostores monta uma página de produto com um carrinho compartilhado entre componentes Preact. Ele serve para examinar como ilhas interativas acessam o mesmo estado numa página Astro.
Página do astronauta
O arquivo src/pages/index.astro define o item de exemplo e importa AddToCartForm com client:load. A descrição vem de src/components/FigurineDescription.astro. O layout em src/layouts/Layout.astro reúne o cabeçalho e os componentes do carrinho.
Estado compartilhado com Nanostores
A configuração registra @astrojs/preact. Os componentes usam @nanostores/preact para acompanhar as alterações das stores em src/cartStore.ts. O arquivo define um atom para a abertura do painel e um map para os itens. Adicionar novamente um item aumenta sua quantidade no carrinho.
Substitua o astronauta
Troque o identificador, o nome e o caminho da imagem em src/pages/index.astro. Edite a descrição em FigurineDescription.astro para acompanhar o novo item. As stores do exemplo mantêm o estado em memória no navegador, sem gravação persistente configurada, então você precisa implementar essa gravação para preservar o carrinho após recarregar a página.
Template SSR
O template SSR do Astro demonstra uma loja com páginas de produtos, carrinho em memória e componentes Svelte no servidor Node.js. Confira os arquivos.

Instalação
npm create astro@latest -- --template ssrO template SSR monta uma loja demonstrativa com uma vitrine de alimentos e páginas individuais de produtos. Ele serve para examinar a renderização no servidor do Astro junto de componentes Svelte e rotas de API.
Vitrine e carrinho
A página src/pages/index.astro consulta a lista de produtos. A rota src/pages/products/[id].astro abre cada item e inclui o componente AddToCart.svelte com client:idle. As rotas em src/pages/api/ retornam os produtos e os itens do carrinho.
Servidor Node e componentes Svelte
O arquivo astro.config.mjs define output: 'server', registra o adaptador @astrojs/node no modo standalone e carrega @astrojs/svelte. O comando npm run server executa o arquivo dist/server/entry.mjs gerado pelo build.
Substitua os exemplos da loja
O catálogo está em src/models/db.json. Você pode trocar as imagens e os preços ali. O login demonstrativo grava um cookie com identificador fixo, sem conferir a senha. O carrinho fica num Map em src/models/session.ts, então os itens não persistem após o encerramento do processo. Para usar a base numa loja, implemente a autenticação e o armazenamento do carrinho.
Basics, template inicial do Astro
O template Basics do Astro cria um projeto com uma página, um layout e um componente de boas-vindas, sem integração instalada. Veja o comando de criação.

O Basics cria um projeto com uma página, um layout e um componente de boas-vindas. Na tela aparecem o logo do Astro e os links para a documentação e o Discord.
O que vem no projeto
A página src/pages/index.astro usa o layout src/layouts/Layout.astro e mostra o componente src/components/Welcome.astro. A imagem do logo fica em src/assets/. O package.json tem só o Astro como dependência.
Crie o projeto
npm create astro@latest -- --template basicsDepois de criar o projeto, apague o componente de boas-vindas e escreva a sua página.
Quando usar
Use quando você quer entender cada arquivo do projeto antes de acrescentar integrações. Para um blog pronto, o template Blog economiza a montagem da coleção e do feed.
Template Framework Multiple
O template Framework Multiple do Astro reúne componentes de React, Preact, Solid, Vue e Svelte numa página com ilhas interativas. Confira a configuração.

Instalação
npm create astro@latest -- --template framework-multipleO template Framework Multiple reúne cinco frameworks de interface na mesma página Astro. Ele serve para comparar componentes interativos equivalentes ou experimentar a combinação de frameworks num projeto.
Componentes por framework
A página src/pages/index.astro importa os exemplos de src/components/, separados nas pastas react, preact, solid, svelte e vue. Cada componente exibe botões de incremento e decremento com um título que identifica o framework. A captura mostra os quatro primeiros exemplos visíveis no enquadramento.
Cinco integrações no Astro
O arquivo astro.config.mjs registra as integrações de Preact, React, Solid, Svelte e Vue. As três integrações que processam JSX usam filtros include para selecionar os componentes de suas respectivas pastas. A página aplica client:visible aos cinco exemplos para carregar a interatividade quando cada ilha estiver visível.
Escolha os componentes do site
Você pode substituir os exemplos em src/components/ e editar a composição em src/pages/index.astro. Os estilos compartilhados ficam em src/styles/global.css. Ao remover um framework do projeto, retire sua integração de astro.config.mjs e suas dependências do package.json, junto dos componentes correspondentes.
Template Hackernews
O template Hackernews do Astro reúne notícias paginadas, comentários e perfis com renderização no servidor Node.js. Conheça as páginas e a configuração.

Instalação
npm create astro@latest -- --template hackernewsO template Hackernews monta uma interface de consulta ao Hacker News com listas de notícias, comentários e perfis. Ele serve como exemplo de site que consulta APIs externas para renderizar páginas no servidor.
Listas e páginas de comentários
A rota src/pages/[...stories].astro seleciona a lista conforme o endereço e lê o parâmetro page para paginar. As páginas de cada notícia ficam em src/pages/stories/[id].astro. Os perfis usam src/pages/users/[id].astro e exibem o karma junto da descrição disponível.
Consultas no servidor
O arquivo astro.config.mjs usa output: 'server' com @astrojs/node no modo standalone. As consultas ficam em src/lib/api.ts, que acessa a API do Hacker News no Firebase para os perfis e o serviço node-hnapi.herokuapp.com para as notícias. O funcionamento das páginas depende das respostas desses serviços.
Ajuste a navegação
Edite os links em src/components/Nav.astro e a estrutura compartilhada em src/layouts/Layout.astro. Para adaptar o exemplo a outra fonte de notícias, você precisa alterar as consultas de src/lib/api.ts e os campos usados pelos componentes de notícias e comentários.
Template MDX
O template MDX do Astro combina texto Markdown com componentes Astro e Preact, incluindo botões interativos e destaque de sintaxe. Explore a configuração.

Instalação
npm create astro@latest -- --template with-mdxO template MDX monta uma página que combina texto Markdown com componentes Astro e Preact. Ele serve para páginas de conteúdo que precisam incorporar elementos interativos ao texto.
Conteúdo em MDX
A página src/pages/index.mdx importa Title.astro e Counter.jsx de src/components/. O título principal usa o componente Astro por meio da exportação components. A página também formata os nomes dos autores e a data com expressões JavaScript.
Integrações de MDX e Preact
O arquivo astro.config.mjs registra @astrojs/mdx e @astrojs/preact. O componente Preact recebe client:idle para carregar a interatividade no navegador. Um bloco de código Astro demonstra o destaque de sintaxe na mesma página.
Troque o texto e os componentes
Você pode editar a abertura e os autores em src/pages/index.mdx. Para mudar a aparência do título, altere src/components/Title.astro. Os botões de incremento e decremento ficam em src/components/Counter.jsx, que também recebe o texto em Markdown colocado entre suas tags.
Template Minimal
O template Minimal do Astro traz uma página inicial com HTML e o próprio Astro como dependência. Veja os arquivos disponíveis e personalize a sua página.

Instalação
npm create astro@latest -- --template minimalO template Minimal monta uma página HTML com o título Astro e uma configuração sem integrações. Ele serve para sites nos quais você quer definir a estrutura das páginas e os estilos a partir dessa base.
A página inicial
O arquivo src/pages/index.astro reúne o documento HTML, as metatags e o título visível. Os favicons ficam em public/, pasta que também recebe imagens e outros arquivos estáticos do site.
Configuração sem integrações
A única dependência do package.json é o Astro. O arquivo astro.config.mjs chama defineConfig({}) sem opções adicionais, então você pode adicionar integrações conforme o site precisar delas.
Personalize o HTML
Edite o título da aba e o conteúdo de src/pages/index.astro. Troque o atributo lang para pt-BR ao escrever a página em português. Você pode criar os componentes reutilizáveis em src/components/, pasta sugerida pelo README para separar trechos como o cabeçalho e o rodapé.
Template Tailwind CSS
O template Tailwind CSS do Astro usa o plugin do Vite para estilizar páginas Astro e Markdown, com um botão que dispara confetes. Confira a configuração.

Instalação
npm create astro@latest -- --template with-tailwindcssO template Tailwind CSS monta uma página Astro com um botão estilizado por classes utilitárias e um link para uma página Markdown. Ele serve para sites que usam o Tailwind CSS na composição visual dos componentes e do conteúdo.
Duas páginas de exemplo
A página src/pages/index.astro importa o componente Button.astro. A rota /markdown-page vem de src/pages/markdown-page.md, que aplica classes do Tailwind dentro do conteúdo e usa src/layouts/main.astro como layout.
Tailwind pelo Vite
O arquivo astro.config.mjs registra @tailwindcss/vite na lista de plugins do Vite. A folha src/styles/global.css importa tailwindcss. O package.json inclui @astrojs/mdx, mas a configuração consultada registra somente o plugin do Tailwind.
Altere o botão e os estilos
As classes do botão ficam em src/components/Button.astro. Um script nesse componente usa canvas-confetti para disparar confetes ao clicar. Você pode trocar as classes e o texto desse botão ou remover o script caso o efeito não faça parte do visual do site.