From 80778c61e9d42e3acd87f2e8766e3aeaea8eb330 Mon Sep 17 00:00:00 2001
From: Andres J <andresdavid@outlook.com>
Date: Sat, 7 Feb 2026 09:01:27 -0600
Subject: [PATCH 1/4] ci(docs): add docs workflow with Nx affected gating,
 English messages, and iconized step names

---
 .github/workflows/docs.yml | 77 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 .github/workflows/docs.yml

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
index 00000000..77e9714d
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,77 @@
+name: 📚 Docs
+
+on:
+  push:
+    branches:
+      - master
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: 📥 Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: 📦 Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10.14.0
+
+      - name: 🏗️ Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "pnpm"
+
+      - name: 📦 Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: 🏗️ Build Docs (Nx affected)
+        id: affected_build
+        run: |
+          set -eu
+          BASE="${{ github.event.before }}"
+          HEAD="${{ github.sha }}"
+          if [ -z "${BASE}" ] || [ "${BASE}" = "0000000000000000000000000000000000000000" ]; then
+            BASE="$(git rev-parse HEAD^ || echo "")"
+          fi
+          echo "Running nx affected build for @effectify/docs between ${BASE}..${HEAD}"
+          pnpm nx affected -t build --base="${BASE}" --head="${HEAD}" --projects="@effectify/docs" || true
+          if [ -d apps/docs/dist ]; then
+            echo "should_deploy=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "should_deploy=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: ⚙️ Configure Pages
+        if: steps.affected_build.outputs.should_deploy == 'true'
+        uses: actions/configure-pages@v5
+
+      - name: 📦 Upload Pages Artifact
+        if: steps.affected_build.outputs.should_deploy == 'true'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: apps/docs/dist
+
+      - name: 🚀 Deploy to GitHub Pages
+        if: steps.affected_build.outputs.should_deploy == 'true'
+        id: deployment
+        uses: actions/deploy-pages@v4
+
+      - name: ⏭️ Skip deploy (docs not affected)
+        if: steps.affected_build.outputs.should_deploy != 'true'
+        run: echo "Skipping deploy: @effectify/docs is not affected in this push."

From cb3841b9049b49847f7f6e340ad3edb656560f9b Mon Sep 17 00:00:00 2001
From: Andres David Jimenez <andresdavid@outlook.com>
Date: Sat, 7 Feb 2026 09:07:34 -0600
Subject: [PATCH 2/4] Update .github/workflows/docs.yml

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 .github/workflows/docs.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 77e9714d..c2503c57 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -74,4 +74,5 @@ jobs:
 
       - name: ⏭️ Skip deploy (docs not affected)
         if: steps.affected_build.outputs.should_deploy != 'true'
-        run: echo "Skipping deploy: @effectify/docs is not affected in this push."
+        run: |
+          echo "Skipping deploy - `@effectify/docs` is not affected in this push."

From 803bcac60351490c043244b130f3fd5df23d55ba Mon Sep 17 00:00:00 2001
From: Andres David Jimenez <andresdavid@outlook.com>
Date: Sat, 7 Feb 2026 09:08:44 -0600
Subject: [PATCH 3/4] Update .github/workflows/docs.yml

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 .github/workflows/docs.yml | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index c2503c57..8a0eadb6 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -49,8 +49,13 @@ jobs:
           if [ -z "${BASE}" ] || [ "${BASE}" = "0000000000000000000000000000000000000000" ]; then
             BASE="$(git rev-parse HEAD^ || echo "")"
           fi
-          echo "Running nx affected build for @effectify/docs between ${BASE}..${HEAD}"
-          pnpm nx affected -t build --base="${BASE}" --head="${HEAD}" --projects="@effectify/docs" || true
+          if [ -z "${BASE}" ]; then
+            echo "No valid BASE commit found, building unconditionally"
+            pnpm nx build `@effectify/docs`
+          else
+            echo "Running nx affected build for `@effectify/docs` between ${BASE}..${HEAD}"
+            pnpm nx affected -t build --base="${BASE}" --head="${HEAD}" --projects="@effectify/docs"
+          fi
           if [ -d apps/docs/dist ]; then
             echo "should_deploy=true" >> "$GITHUB_OUTPUT"
           else

From a24ce9e4ddb3c9fea2a9673384f13204e253855b Mon Sep 17 00:00:00 2001
From: Andres David Jimenez <andresdavid@outlook.com>
Date: Sat, 7 Feb 2026 09:14:27 -0600
Subject: [PATCH 4/4] Update .github/workflows/docs.yml

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
---
 .github/workflows/docs.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 8a0eadb6..bd85c4d5 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -51,7 +51,7 @@ jobs:
           fi
           if [ -z "${BASE}" ]; then
             echo "No valid BASE commit found, building unconditionally"
-            pnpm nx build `@effectify/docs`
+            pnpm nx build "@effectify/docs"
           else
             echo "Running nx affected build for `@effectify/docs` between ${BASE}..${HEAD}"
             pnpm nx affected -t build --base="${BASE}" --head="${HEAD}" --projects="@effectify/docs"