diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index a32f3e8..8bf2137 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -19,3 +19,17 @@ jobs:
       - run: pnpm build
       - run: pnpm typecheck
       - run: pnpm test
+
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      # vitepress build fails on dead internal links (config ignores only
+      # localhost), so this doubles as a link check on every PR.
+      - run: pnpm --filter @gemstack/docs docs:build