docs: add VitePress docs site and GitHub Pages deploy

Author: AndyElessar

.github/workflows/docs.yml

@@ -0,0 +1,55 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - docs/**
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: docs/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+        working-directory: docs
+
+      - name: Build VitePress site
+        run: npm run docs:build
+        working-directory: docs
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/.vitepress/dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

docs/.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+.vitepress/cache
+.vitepress/dist

docs/.vitepress/config.ts

@@ -0,0 +1,47 @@
+import { defineConfig } from 'vitepress';
+
+export default defineConfig({
+  title: 'SourceGen',
+  description: 'A collection of C# Source Generators for compile-time code generation',
+  base: '/SourceGen/',
+  themeConfig: {
+    nav: [
+      { text: 'Guide', link: '/Ioc/01_Overview' },
+      { text: 'GitHub', link: 'https://github.com/AndyElessar/SourceGen' }
+    ],
+    sidebar: [
+      {
+        text: 'Guide',
+        items: [
+          { text: 'Overview', link: '/Ioc/01_Overview' },
+          { text: 'Basic Usage', link: '/Ioc/02_Basic' },
+          { text: 'Default Settings', link: '/Ioc/03_Defaults' },
+          {
+            text: 'Field, Property & Method Injection',
+            link: '/Ioc/04_Field_Property_Method_Injection'
+          },
+          { text: 'Keyed Services', link: '/Ioc/05_Keyed' },
+          { text: 'Decorators', link: '/Ioc/06_Decorator' },
+          { text: 'Tags', link: '/Ioc/07_Tags' },
+          { text: 'Factory & Instance', link: '/Ioc/08_Factory_Instance' },
+          { text: 'Open Generic Types', link: '/Ioc/09_OpenGeneric' },
+          { text: 'Wrapper Types', link: '/Ioc/10_Wrapper' },
+          { text: 'CLI Tool', link: '/Ioc/11_CliTool' },
+          { text: 'Container Generation', link: '/Ioc/12_Container' },
+          { text: 'MSBuild Configuration', link: '/Ioc/13_MSBuild_Configuration' },
+          { text: 'Best Practices', link: '/Ioc/14_Best_Practices' }
+        ]
+      }
+    ],
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/AndyElessar/SourceGen' }
+    ],
+    search: {
+      provider: 'local'
+    },
+    footer: {
+      message: 'Released under the MIT License.',
+      copyright: 'Copyright © 2026 AndyElessar'
+    }
+  }
+});

docs/index.md

@@ -0,0 +1,24 @@
+---
+layout: home
+hero:
+  name: SourceGen
+  text: C# Source Generators
+  tagline: Compile-time code generation for .NET — Zero reflection, full AOT support
+  actions:
+    - theme: brand
+      text: Get Started
+      link: /Ioc/01_Overview
+    - theme: alt
+      text: View on GitHub
+      link: https://github.com/AndyElessar/SourceGen
+features:
+  - icon: ⚡
+    title: Compile-Time Generation
+    details: All code is generated at compile time with zero runtime reflection overhead
+  - icon: 🎯
+    title: Native AOT Compatible
+    details: Fully compatible with .NET Native AOT publishing — no trimming warnings
+  - icon: 🔧
+    title: IoC / Dependency Injection
+    details: Source-generated service registration replacing Microsoft.Extensions.DependencyInjection patterns
+---