Framework
Astro 5
Astro é o framework do site. Ele cuida das rotas, da composição de páginas, da geração estática e do modelo de layout compartilhado usado por cada página de projeto.
Stack principal
As peças centrais que sustentam este site de documentação.
Modelo de renderização
Saída estática
O site é construído como arquivos HTML estáticos, sem runtime de servidor. Isso simplifica o deploy e mantém o projeto rápido e leve.
Estrutura de conteúdo
Metadados compartilhados em um arquivo
Títulos, resumos, suporte a idiomas, caminhos e textos de interface compartilhados ficam juntos em src/data/ai-projects.ts. As páginas iniciais e as de detalhe leem dessa fonte única de verdade.
Estilo
CSS global
O sistema visual está centralizado principalmente em src/styles/global.css. Tokens de layout, estilos de cards, estilos de hero e regras responsivas vivem todos lá.
Localização
Rotas em inglês e português
O projeto entrega páginas localizadas nos dois idiomas. Inglês é o site padrão; o português usa rotas dedicadas em src/pages/pt/ e uma home localizada.
Forma de deploy
Deploy estático na Vercel
Este repositório está configurado como site Astro estático, com deploy direto na Vercel, sem lógica de backend custom. A complexidade de runtime fica no passo de build, não em servidores de produção.
Como roda
Dos arquivos-fonte até as páginas estáticas finais.
1
Astro lê as entradas de página
Cada página de projeto é um arquivo Astro em src/pages/, com equivalentes em português em src/pages/pt/.
2
Dados compartilhados alimentam navegação e cards
A lista de projetos em src/data/ai-projects.ts alimenta os cards da home, os menus, a troca de idioma e o conteúdo do hero.
3
Componentes reaproveitáveis compõem cada página
Layout.astro, AIProjectHero.astro e os componentes de header/footer mantêm a estrutura consistente em todas as rotas.
4
O CSS global aplica o sistema visual compartilhado
Uma única folha global cuida de tipografia, espaçamento, cards de projeto, seções de hero, tabelas, fluxos numerados e comportamento responsivo.
5
Astro gera a saída em arquivos
O npm run build emite as páginas estáticas finais com rotas baseadas em arquivos, incluindo pt.html para a home em português.
Mapa da arquitetura
O repositório é pequeno, mas as responsabilidades estão divididas com clareza.
Pastas principais
src/pages/Rotas em inglês para a home e para as páginas de projeto.
src/pages/pt/Rotas em português espelhando as páginas localizadas.
src/components/Blocos de UI compartilhados como header, footer, cards e hero.
src/data/Metadados compartilhados, helpers de localidade e textos bilíngues.
public/Assets estáticos como screenshots de projeto, favicon e o script de menu.
Análise da Arquitetura
package.json astro.config.mjs src/data/projects.ts src/layouts/BaseLayout.astro src/components/ src/pages/ src/styles/global.css
O projeto é propositalmente direto: páginas de conteúdo, metadados compartilhados, componentes de apresentação reaproveitáveis e um passo de build estático.
Comandos para rodar
O fluxo local segue o ciclo padrão de um site estático em Astro.
Scripts
npm install npm run dev npm run build npm run preview
Nenhum banco de dados, worker em segundo plano ou processo de servidor custom é necessário para o fluxo local documentado.
O que ele precisa
Ambiente esperado
Node.js e npm.
Dependências do Astro definidas em package.json.
Assets estáticos disponíveis em public/.
Nenhum banco em runtime nem segredos de servidor para o site principal.
Resumo final
Tech Stacks é um site estático bilíngue em Astro feito para documentar outros projetos com metadados compartilhados, componentes reaproveitáveis, rotas localizadas e um modelo de deploy simples baseado em arquivos.