Add preview deployments

.github/workflows/deploy.yml

@@ -7,9 +7,7 @@ on:
   workflow_dispatch:
 
 permissions:
-  contents: read
-  pages: write
-  id-token: write
+  contents: write
 
 concurrency:
   group: pages
@@ -20,23 +18,17 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v6.0.2
-      - uses: actions/configure-pages@v6.0.0
       - uses: actions/setup-node@v6.3.0
         with:
           node-version-file: .nvmrc
       - uses: oven-sh/setup-bun@v2.2.0
       - run: bun install --frozen-lockfile
       - run: bun run build
-      - uses: actions/upload-pages-artifact@v4.0.0
+        env:
+          BASE_PATH: ${{ vars.BASE_PATH }}
+      - uses: JamesIves/github-pages-deploy-action@v4
         with:
-          path: ./dist
-
-  deploy:
-    runs-on: ubuntu-latest
-    needs: build
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    steps:
-      - id: deployment
-        uses: actions/deploy-pages@v4.0.5
+          folder: dist
+          clean: true
+          clean-exclude: |
+            pr-preview/

.github/workflows/preview.yml

@@ -0,0 +1,31 @@
+name: Preview
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, closed]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: preview-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  preview:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6.0.2
+      - uses: actions/setup-node@v6.3.0
+        with:
+          node-version-file: .nvmrc
+      - uses: oven-sh/setup-bun@v2.2.0
+      - run: bun install --frozen-lockfile
+      - if: github.event.action != 'closed'
+        run: bun run build
+        env:
+          BASE_PATH: ${{ vars.BASE_PATH }}/pr-preview/pr-${{ github.event.pull_request.number }}/
+      - uses: rossjrw/pr-preview-action@v1
+        with:
+          source-dir: dist

astro.config.ts

@@ -3,12 +3,14 @@ import starlight from "@astrojs/starlight";
 import starlightLlmsTxt from "starlight-llms-txt";
 
 const site = "https://agentic-engineering.swmansion.com/";
+const base = process.env.BASE_PATH || "/";
 const repo = `https://github.com/software-mansion/agentic-engineering/`;
 const defaultOgImage = `${site}og-default.png`;
 
 // https://astro.build/config
 export default defineConfig({
   site,
+  base,
   integrations: [
     starlight({
       title: "Software Mansion Agentic Engineering Guide",