ci(docs): run docs/app tests in CI and guard Upload from being evaluated

.github/actions/setup_build_env/action.yml

@@ -18,6 +18,10 @@ inputs:
     description: "Whether to run uv sync on current dir"
     required: false
     default: false
+  working-directory:
+    description: "Directory to run uv sync from. Defaults to the repo root."
+    required: false
+    default: "."
   create-venv-at-path:
     description: "Path to venv (if uv sync is enabled)"
     required: false
@@ -34,6 +38,7 @@ runs:
         prune-cache: false
         activate-environment: true
         cache-dependency-glob: "uv.lock"
+        working-directory: ${{ inputs.working-directory }}
     - name: Setup Node
       uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
       with:
@@ -42,3 +47,4 @@ runs:
       if: inputs.run-uv-sync == 'true'
       run: uv sync
       shell: bash
+      working-directory: ${{ inputs.working-directory }}

.github/workflows/docs_tests.yml

@@ -0,0 +1,41 @@
+name: docs tests
+
+on:
+  pull_request:
+    branches: ["main"]
+    paths:
+      - 'docs/**'
+      - 'packages/reflex-components-core/src/reflex_components_core/core/upload.py'
+      - '.github/workflows/docs_tests.yml'
+  push:
+    branches: ["main"]
+    paths:
+      - 'docs/**'
+      - 'packages/reflex-components-core/src/reflex_components_core/core/upload.py'
+      - '.github/workflows/docs_tests.yml'
+
+permissions:
+  contents: read
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  docs-tests:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-tags: true
+          fetch-depth: 0
+          persist-credentials: false
+      - uses: ./.github/actions/setup_build_env
+        with:
+          python-version: "3.12"
+          run-uv-sync: true
+          working-directory: ./docs/app
+      - name: Run docs app tests
+        working-directory: ./docs/app
+        run: uv run --no-sync pytest tests/ -v

.github/workflows/integration_tests.yml

@@ -161,6 +161,10 @@ jobs:
           which npm && npm -v
           uv run --active --no-sync bash scripts/integration.sh ./docs/app prod
 
+      - name: Validate /docs links against generated sitemap
+        working-directory: ./docs/app
+        run: uv run --active --no-sync pytest --runxfail tests/test_doc_links.py -v
+
       - name: Upload Socket.dev Firewall report
         if: always()
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1