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 - industrial/rust theme with orange accents (#ce4a00)
• Features maintained:
  • Animated rotating cogs background
  • Floating particle effects
  • Stats dashboard with hover effects
  • Responsive design
  • Google Analytics tracking
• 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
│   │   ├── Hero.astro
│   │   ├── Dashboard.astro
│   │   └── Footer.astro
│   ├── pages/index.astro
│   └── styles/globals.css
└── public/
    ├── docs/              # Preserved documentation
    ├── images/            # Screenshots and assets
    ├── robots.txt
    └── sitemap.xml

Testing

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

Deployment

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