feat(ci): add PR preview deployments

- Add pr-preview.yml workflow using rossjrw/pr-preview-action
- Update astro.config.mjs to support dynamic base path via ASTRO_BASE env
- Previews deploy to /pr-preview/pr-<number>/ on gh-pages branch
- Auto-cleanup when PR is closed

Author: aaronpowell

.github/workflows/pr-preview.yml

@@ -0,0 +1,68 @@
+# PR Preview deployment workflow
+# Deploys a preview of pull requests to GitHub Pages subdirectory
+
+name: Deploy PR Preview
+
+on:
+  pull_request:
+    types: [opened, reopened, synchronize, closed]
+    paths:
+      - 'website/**'
+      - 'agents/**'
+      - 'prompts/**'
+      - 'instructions/**'
+      - 'skills/**'
+      - 'collections/**'
+      - 'cookbook/**'
+      - 'eng/generate-website-data.mjs'
+
+concurrency:
+  group: pr-preview-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  deploy-preview:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        if: github.event.action != 'closed'
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install root dependencies
+        if: github.event.action != 'closed'
+        run: npm ci
+
+      - name: Install website dependencies
+        if: github.event.action != 'closed'
+        run: npm ci
+        working-directory: ./website
+
+      - name: Generate website data
+        if: github.event.action != 'closed'
+        run: npm run website:data
+
+      - name: Build Astro site
+        if: github.event.action != 'closed'
+        run: npm run build
+        working-directory: ./website
+        env:
+          # Set base path for PR preview subdirectory
+          ASTRO_BASE: /awesome-copilot/pr-preview/pr-${{ github.event.number }}
+
+      - name: Deploy PR preview
+        uses: rossjrw/pr-preview-action@v1
+        with:
+          source-dir: ./website/dist/
+          preview-branch: gh-pages
+          umbrella-dir: pr-preview
+          action: auto

website/astro.config.mjs

@@ -1,10 +1,13 @@
 import sitemap from "@astrojs/sitemap";
 import { defineConfig } from "astro/config";
 
+// Support dynamic base path for PR previews via ASTRO_BASE env var
+const base = process.env.ASTRO_BASE || "/";
+
 // https://astro.build/config
 export default defineConfig({
   site: "https://github.github.io",
-  base: "/",
+  base: base,
   output: "static",
   integrations: [sitemap()],
   build: {