Ir para o conteúdo
Promovaweb

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.

Listagem de posts do template Blog do Astro, com o post Markdown Style Guide em destaque e capa grande, seguido dos posts Using MDX e Third post.

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

Terminal
npm create astro@latest -- --template blog

Depois 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.

Página inicial do template Portfolio do Astro, com nome, apresentação, botões de função e foto da autora fictícia.

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

Terminal
npm create astro@latest -- --template portfolio

Troque 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.

Página do template Starlog com o título Changelog e a nota da versão 2.0 com imagem de capa.

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

Terminal
npm create astro@latest -- --template starlog

O 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.

Página Astronaut Figurine com descrição, imagem de astronauta e botões Add to cart e Cart.

Instalação

npm create astro@latest -- --template with-nanostores

O 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.

Vitrine Online Store com quatro cartões de alimentos, preços e ícone de carrinho no cabeçalho.

Instalação

npm create astro@latest -- --template ssr

O 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.

Página de boas-vindas do template Basics, com o logo do Astro, a indicação para abrir src/pages e os links da documentação e do Discord.

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

Terminal
npm create astro@latest -- --template basics

Depois 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.

Botões de incremento e decremento com o valor zero e títulos de React, Preact, Solid e Vue sobre fundo branco.

Instalação

npm create astro@latest -- --template framework-multiple

O 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.

Lista de notícias com pontuação e comentários sob um menu roxo com HN, New, Show, Ask e Jobs.

Instalação

npm create astro@latest -- --template hackernews

O 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.

Página Hello world! com título vermelho, nomes dos autores, botões de incremento e decremento e bloco de código.

Instalação

npm create astro@latest -- --template with-mdx

O 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.

Página branca do template Minimal com o título Astro no canto superior esquerdo.

Instalação

npm create astro@latest -- --template minimal

O 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.

Botão roxo Tailwind Button in Astro! centralizado sobre um link para a página Markdown.

Instalação

npm create astro@latest -- --template with-tailwindcss

O 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.

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.