ci: migrate docs to GitHub pages

Migrate away from Netlify after reading this story:

https://www.reddit.com/r/webdev/comments/1b14bty/netlify_just_sent_me_a_104k_bill_for_a_simple/

.github/workflows/main.yml

@@ -1,4 +1,4 @@
-name: Release
+name: release npm package
 
 on:
   push:
@@ -24,12 +24,13 @@ jobs:
         run: |
           pnpm install
           pnpm run build
-      #     pnpm run docs:build
-      # - name: Deploy Docs
-      #   uses: JamesIves/[email protected]
-      #   with:
-      #     branch: gh-pages
-      #     folder: docs/.vitepress/dist
+          pnpm run docs:build
+      - name: Deploy Docs
+        uses: JamesIves/[email protected]
+        with:
+          branch: gh-pages
+          folder: docs/.vitepress/dist
+          clean-exclude: pr-preview
       - name: Release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/preview.yml

@@ -0,0 +1,43 @@
+# https://github.com/rossjrw/pr-preview-action
+name: deploy docs
+
+on:
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - closed
+
+concurrency: preview-${{ github.ref }}
+
+jobs:
+  deploy-preview:
+    runs-on: ubuntu-20.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - run: corepack enable
+
+      - name: Setup Node
+        uses: actions/setup-node@v1
+        with:
+          node-version: 18
+          cache: pnpm
+
+      - name: Install & Build
+        if: github.event.action != 'closed' # You might want to skip the build if the PR has been closed
+        env: 
+          VITEPRESS_BASE: test
+        run: |
+          pnpm install
+          pnpm run build
+          pnpm run docs:build
+
+      - name: Deploy
+        uses: rossjrw/pr-preview-action@v1
+        with:
+          source-dir: ./docs/.vitepress/dist/

docs/.vitepress/config.ts

@@ -101,7 +101,7 @@ export default withPwa(
     },
     pwa: {
       mode: 'development',
-      base: '/',
+      base: `/${process.env.VITEPRESS_BASE ?? ''}`,
       scope: '/',
       registerType: 'autoUpdate',
       // injectRegister: 'inline',