From d74c79e851ae4606a783e8933acb6702da348b51 Mon Sep 17 00:00:00 2001
From: "Ricardo Q. Bazan" <raquirozbazan@gmail.com>
Date: Sun, 18 Oct 2026 11:15:32 -0500
Subject: [PATCH] ci: build the docsite on every pull request

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017sXwJhk5oRMrzxnA1zWxER
---
 .github/workflows/docsite.yml | 36 ++++++++++++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/docsite.yml b/.github/workflows/docsite.yml
index 5cfbae2..17e3679 100644
--- a/.github/workflows/docsite.yml
+++ b/.github/workflows/docsite.yml
@@ -1,7 +1,11 @@
 name: Docsite
 
 on:
-  # Manual only until the slow Lighthouse audit is reworked.
+  # Pull requests only build the site; Workers Builds deploys main.
+  pull_request:
+    branches:
+      - main
+  # The SEO audit is slow, so it runs by hand until the Lighthouse audit is reworked.
   workflow_dispatch:
 
 concurrency:
@@ -11,9 +15,39 @@ concurrency:
 permissions: {}
 
 jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    if: ${{ github.event_name == 'pull_request' }}
+    permissions:
+      contents: read
+    timeout-minutes: 10
+    env:
+      MISE_EXPERIMENTAL: "1"
+    steps:
+      - name: ⬇️ Checkout repo
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: 🛠️ Setup mise
+        uses: jdx/mise-action@c2a87611a18de5b3828c5652fe268e992400cb5c # v4.3.0
+        with:
+          install: true
+          cache: true
+          experimental: true
+
+      - name: 📦 Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      # `vite build` only writes dist/; it never runs `wrangler deploy`.
+      - name: 🔨 Build docsite
+        run: pnpm --filter docsite build
+
   seo:
     name: Audit SEO
     runs-on: ubuntu-latest
+    if: ${{ github.event_name == 'workflow_dispatch' }}
     permissions:
       contents: read
     timeout-minutes: 15