From 603edf327d48a501b92bd447a4483fa613deab92 Mon Sep 17 00:00:00 2001
From: Suleiman Shahbari <suleiman@averotech.com>
Date: Wed, 1 Jul 2026 00:19:34 +0300
Subject: [PATCH] ci: build docs on PRs to catch dead links

vitepress build fails on dead internal links (the docs config ignores only
localhost links), so a docs job on every PR doubles as a link check.

Closes #59
---
 .github/workflows/ci.yml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

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