feat: migrate docs to Astro framework

[jonathanperis]

Summary

Migrates the GitHub Pages documentation site from static HTML to the Astro framework.

Changes

• Framework: Replaced static HTML with Astro components
• Design: 100% preserved - cyber/futuristic dark theme with cyan accents (#00d4ff)
• Features maintained:
  • Grid background pattern
  • Three-layer architecture diagram
  • Stats grid with hover effects
  • Technology stack cards
  • Responsive design
• SEO: Full metadata (Open Graph, Twitter Cards, JSON-LD structured data)
• Build: Static export to docs/out/ directory
• CI/CD: Updated GitHub Actions workflow for Astro build process

File Structure

docs/
├── astro.config.mjs       # Static output config
├── package.json           # Dependencies: astro, @astrojs/sitemap
├── src/
│   ├── layouts/BaseLayout.astro
│   ├── components/home/
│   │   ├── Navbar.astro
│   │   ├── HeroContent.astro
│   │   ├── ArchDiagram.astro
│   │   ├── Stats.astro
│   │   ├── TechStack.astro
│   │   └── Footer.astro
│   ├── pages/index.astro
│   └── styles/globals.css
└── public/
    ├── docs/              # Preserved documentation
    ├── robots.txt
    └── sitemap.xml

Testing

• ✅ Local build successful (npm run build)
• ✅ Static files generated in docs/out/
• ✅ All original CSS preserved
• ✅ Responsive breakpoints maintained

Deployment

After merge, the site will automatically deploy via GitHub Actions on push to main.