reflex-dev · adhami3310 · Apr 8, 2026 · Apr 7, 2026 · Apr 7, 2026 · Apr 7, 2026
diff --git a/.github/workflows/deploy_docs.yml b/.github/workflows/deploy_docs.yml
diff --git a/.github/workflows/integration_tests.yml b/.github/workflows/integration_tests.yml
@@ -103,7 +103,7 @@ jobs:
           npm -v
           uv run bash scripts/integration.sh ./reflex-examples/nba-proxy dev
 
-  reflex-web:
+  reflex-docs:
     strategy:
       fail-fast: false
       matrix:
@@ -164,17 +164,9 @@ jobs:
       - name: Install Dependencies (scanned by Socket.dev)
         run: sfw uv sync
 
-      - name: Clone Reflex Website Repo
-        uses: actions/checkout@v4
-        with:
-          repository: reflex-dev/reflex-web
-          ref: main
-          path: reflex-web
-          submodules: recursive
-
       # TODO: revisit when https://github.com/SocketDev/sfw-free/issues/30 is resolved.
-      - name: Pre-install reflex-web git dependencies (outside sfw)
-        working-directory: ./reflex-web
+      - name: Pre-install reflex-docs git dependencies (outside sfw)
+        working-directory: ./docs/app
         run: |
           # Replace reflex-dev/reflex git deps with plain package names (PR version is pre-installed)
           sed -i -E 's|"([a-zA-Z0-9_-]+)\s*@\s*git\+https://github\.com/reflex-dev/reflex@[^"]*"|"\1"|g' pyproject.toml
@@ -186,8 +178,8 @@ jobs:
             cat git-requirements.txt
             uv pip install --no-deps -r git-requirements.txt
           fi
-      - name: Compile and install reflex-web requirements (scanned by Socket.dev)
-        working-directory: ./reflex-web
+      - name: Compile and install reflex-docs requirements (scanned by Socket.dev)
+        working-directory: ./docs/app
         run: |
           sfw uv pip compile pyproject.toml --no-annotate --no-header --no-deps --output-file requirements.txt
           uv pip list --format=json | jq -r '"^" + .[].name + "[ =]"' > installed_patterns.txt
@@ -203,20 +195,20 @@ jobs:
           echo "Expected checkout SHA: $expected_sha"
           echo "Installed reflex version: $installed_version"
           [[ "$installed_version" == *"+$expected_sha" ]]
-      - name: Init Website for reflex-web
-        working-directory: ./reflex-web
+      - name: Init Website for reflex-docs
+        working-directory: ./docs/app
         run: uv run --active --no-sync reflex init
       - name: Run Website and Check for errors
         run: |
           # Verify sfw wrappers are on PATH
           which npm && npm -v
-          uv run --active --no-sync bash scripts/integration.sh ./reflex-web prod
+          uv run --active --no-sync bash scripts/integration.sh ./docs/app prod
 
       - name: Upload Socket.dev Firewall report
         if: always()
         uses: actions/upload-artifact@v4
         with:
-          name: sfw-report-reflex-web-py${{ matrix.python-version }}
+          name: sfw-report-reflex-docs-py${{ matrix.python-version }}
           path: ${{ env.SFW_JSON_REPORT_PATH }}
           if-no-files-found: warn
 
@@ -251,7 +243,7 @@ jobs:
           npm -v
           uv run bash scripts/integration.sh ./rx-shout-from-template prod
 
-  reflex-web-macos:
+  reflex-docs-macos:
     if: github.event_name == 'push' && github.ref == 'refs/heads/main'
     strategy:
       fail-fast: false
@@ -269,28 +261,21 @@ jobs:
           python-version: ${{ matrix.python-version }}
           run-uv-sync: true
 
-      - name: Clone Reflex Website Repo
-        uses: actions/checkout@v4
-        with:
-          repository: reflex-dev/reflex-web
-          ref: main
-          path: reflex-web
-          submodules: recursive
-      - name: Compile pyproject.toml into requirements.txt
-        working-directory: ./reflex-web
+      - name: Install reflex-docs dependencies
+        working-directory: ./docs/app
         run: |
           uv pip compile pyproject.toml --no-annotate --no-header --no-deps --output-file requirements.txt
           uv pip list --format=json | jq -r '"^" + .[].name + "[ =]"' > installed_patterns.txt
           grep -ivf installed_patterns.txt requirements.txt > requirements.txt.tmp && mv requirements.txt.tmp requirements.txt
           rm installed_patterns.txt
-      - name: Install Requirements for reflex-web
-        working-directory: ./reflex-web
+      - name: Install Requirements for reflex-docs
+        working-directory: ./docs/app
         run: uv pip install -r requirements.txt
-      - name: Init Website for reflex-web
-        working-directory: ./reflex-web
+      - name: Init Website for reflex-docs
+        working-directory: ./docs/app
         run: uv run --active --no-sync reflex init
       - name: Run Website and Check for errors
         run: |
           # Check that npm is home
           npm -v
-          uv run --active --no-sync bash scripts/integration.sh ./reflex-web prod
+          uv run --active --no-sync bash scripts/integration.sh ./docs/app prod
diff --git a/.github/workflows/pre-commit.yml b/.github/workflows/pre-commit.yml
@@ -34,3 +34,5 @@ jobs:
           fetch-tags: true
           fetch-depth: 0
       - run: uv run pre-commit run --all-files --show-diff-on-failure
+      - name: Run docs app pre-commit
+        run: uv run pre-commit run --all-files --show-diff-on-failure --config docs/app/.pre-commit-config.yaml
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -0,0 +1,53 @@
+fail_fast: true
+repos:
+- hooks:
+  - args:
+    - reflex
+    - tests
+    exclude: ^docs/
+    id: ruff-format
+  - args:
+    - --fix
+    - --exit-non-zero-on-fix
+    exclude: ^(integration/benchmarks/|docs/)
+    id: ruff-check
+  repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.15.6
+- hooks:
+  - additional_dependencies:
+    - tomli
+    args:
+    - reflex
+    id: codespell
+  repo: https://github.com/codespell-project/codespell
+  rev: v2.4.1
+- hooks:
+  - always_run: true
+    description: Update pyi files as needed
+    entry: python3 scripts/make_pyi.py
+    id: update-pyi-files
+    language: system
+    name: update-pyi-files
+    require_serial: true
+  repo: local
+- hooks:
+  - args:
+    - reflex
+    - tests
+    exclude: ^docs/
+    id: pyright
+    language: system
+  repo: https://github.com/RobertCraigie/pyright-python
+  rev: v1.1.408
+- hooks:
+  - additional_dependencies:
+    - '@biomejs/biome@2.4.8'
+    args:
+    - --indent-width
+    - '2'
+    - --indent-style
+    - space
+    exclude: ^docs/
+    id: biome-format
+  repo: https://github.com/biomejs/pre-commit
+  rev: v0.6.1
diff --git a/...ocs/advanced_onboarding/code_structure.md → docs/advanced_onboarding/code_structure.md b/...ocs/advanced_onboarding/code_structure.md → docs/advanced_onboarding/code_structure.md
diff --git a/...docs/advanced_onboarding/configuration.md → docs/advanced_onboarding/configuration.md b/...docs/advanced_onboarding/configuration.md → docs/advanced_onboarding/configuration.md
diff --git a/...s/advanced_onboarding/how-reflex-works.md → docs/advanced_onboarding/how-reflex-works.md b/...s/advanced_onboarding/how-reflex-works.md → docs/advanced_onboarding/how-reflex-works.md
diff --git a/reflex/docs/ai_builder/apis.md → docs/ai_builder/apis.md b/reflex/docs/ai_builder/apis.md → docs/ai_builder/apis.md
diff --git a/...docs/ai_builder/app_lifecycle/copy_app.md → docs/ai_builder/app_lifecycle/copy_app.md b/...docs/ai_builder/app_lifecycle/copy_app.md → docs/ai_builder/app_lifecycle/copy_app.md
diff --git a/...cs/ai_builder/app_lifecycle/deploy_app.md → docs/ai_builder/app_lifecycle/deploy_app.md b/...cs/ai_builder/app_lifecycle/deploy_app.md → docs/ai_builder/app_lifecycle/deploy_app.md
diff --git a/.../ai_builder/app_lifecycle/download_app.md → .../ai_builder/app_lifecycle/download_app.md b/.../ai_builder/app_lifecycle/download_app.md → .../ai_builder/app_lifecycle/download_app.md
diff --git a/...docs/ai_builder/app_lifecycle/fork_app.md → docs/ai_builder/app_lifecycle/fork_app.md b/...docs/ai_builder/app_lifecycle/fork_app.md → docs/ai_builder/app_lifecycle/fork_app.md
diff --git a/.../docs/ai_builder/app_lifecycle/general.md → docs/ai_builder/app_lifecycle/general.md b/.../docs/ai_builder/app_lifecycle/general.md → docs/ai_builder/app_lifecycle/general.md
diff --git a/...ocs/ai_builder/app_lifecycle/share_app.md → docs/ai_builder/app_lifecycle/share_app.md b/...ocs/ai_builder/app_lifecycle/share_app.md → docs/ai_builder/app_lifecycle/share_app.md
diff --git a/.../ai_builder/features/automated_testing.md → .../ai_builder/features/automated_testing.md b/.../ai_builder/features/automated_testing.md → .../ai_builder/features/automated_testing.md
diff --git a/.../ai_builder/features/connect_to_github.md → .../ai_builder/features/connect_to_github.md b/.../ai_builder/features/connect_to_github.md → .../ai_builder/features/connect_to_github.md
diff --git a/...docs/ai_builder/features/customization.md → docs/ai_builder/features/customization.md b/...docs/ai_builder/features/customization.md → docs/ai_builder/features/customization.md
diff --git a/.../docs/ai_builder/features/editor_modes.md → docs/ai_builder/features/editor_modes.md b/.../docs/ai_builder/features/editor_modes.md → docs/ai_builder/features/editor_modes.md
diff --git a/reflex/docs/ai_builder/features/file_tree.md → docs/ai_builder/features/file_tree.md b/reflex/docs/ai_builder/features/file_tree.md → docs/ai_builder/features/file_tree.md
diff --git a/reflex/docs/ai_builder/features/ide.md → docs/ai_builder/features/ide.md b/reflex/docs/ai_builder/features/ide.md → docs/ai_builder/features/ide.md
diff --git a/...cs/ai_builder/features/image_as_prompt.md → docs/ai_builder/features/image_as_prompt.md b/...cs/ai_builder/features/image_as_prompt.md → docs/ai_builder/features/image_as_prompt.md
diff --git a/.../features/installing_external_packages.md → .../features/installing_external_packages.md b/.../features/installing_external_packages.md → .../features/installing_external_packages.md
diff --git a/..._builder/features/integration_shortcut.md → ..._builder/features/integration_shortcut.md b/..._builder/features/integration_shortcut.md → ..._builder/features/integration_shortcut.md
diff --git a/reflex/docs/ai_builder/features/knowledge.md → docs/ai_builder/features/knowledge.md b/reflex/docs/ai_builder/features/knowledge.md → docs/ai_builder/features/knowledge.md
diff --git a/...ai_builder/features/restore_checkpoint.md → ...ai_builder/features/restore_checkpoint.md b/...ai_builder/features/restore_checkpoint.md → ...ai_builder/features/restore_checkpoint.md
diff --git a/reflex/docs/ai_builder/features/secrets.md → docs/ai_builder/features/secrets.md b/reflex/docs/ai_builder/features/secrets.md → docs/ai_builder/features/secrets.md
diff --git a/reflex/docs/ai_builder/figma.md → docs/ai_builder/figma.md b/reflex/docs/ai_builder/figma.md → docs/ai_builder/figma.md
diff --git a/reflex/docs/ai_builder/files.md → docs/ai_builder/files.md b/reflex/docs/ai_builder/files.md → docs/ai_builder/files.md
diff --git a/reflex/docs/ai_builder/images.md → docs/ai_builder/images.md b/reflex/docs/ai_builder/images.md → docs/ai_builder/images.md
diff --git a/..._builder/integrations/mcp_installation.md → ..._builder/integrations/mcp_installation.md b/..._builder/integrations/mcp_installation.md → ..._builder/integrations/mcp_installation.md
diff --git a/...s/ai_builder/integrations/mcp_overview.md → docs/ai_builder/integrations/mcp_overview.md b/...s/ai_builder/integrations/mcp_overview.md → docs/ai_builder/integrations/mcp_overview.md
diff --git a/docs/ai_builder/integrations/overview.md b/docs/ai_builder/integrations/overview.md
@@ -0,0 +1,7 @@
+```python exec
+from reflex_docs.pages.integrations.integration import integration_page
+```
+
+```python eval
+integration_page()
+```
diff --git a/...ocs/ai_builder/overview/best_practices.md → docs/ai_builder/overview/best_practices.md b/...ocs/ai_builder/overview/best_practices.md → docs/ai_builder/overview/best_practices.md
diff --git a/reflex/docs/ai_builder/overview/templates.md → docs/ai_builder/overview/templates.md b/reflex/docs/ai_builder/overview/templates.md → docs/ai_builder/overview/templates.md
diff --git a/reflex/docs/ai_builder/overview/tutorial.md → docs/ai_builder/overview/tutorial.md b/reflex/docs/ai_builder/overview/tutorial.md → docs/ai_builder/overview/tutorial.md
diff --git a/..._builder/overview/what_is_reflex_build.md → ..._builder/overview/what_is_reflex_build.md b/..._builder/overview/what_is_reflex_build.md → ..._builder/overview/what_is_reflex_build.md
diff --git a/reflex/docs/ai_builder/python_libraries.md → docs/ai_builder/python_libraries.md b/reflex/docs/ai_builder/python_libraries.md → docs/ai_builder/python_libraries.md
diff --git a/reflex/docs/ai_builder/urls.md → docs/ai_builder/urls.md b/reflex/docs/ai_builder/urls.md → docs/ai_builder/urls.md
diff --git a/reflex/docs/ai_builder/webhooks.md → docs/ai_builder/webhooks.md b/reflex/docs/ai_builder/webhooks.md → docs/ai_builder/webhooks.md
diff --git a/.../docs/api-reference/browser_javascript.md → docs/api-reference/browser_javascript.md b/.../docs/api-reference/browser_javascript.md → docs/api-reference/browser_javascript.md
diff --git a/reflex/docs/api-reference/browser_storage.md → docs/api-reference/browser_storage.md b/reflex/docs/api-reference/browser_storage.md → docs/api-reference/browser_storage.md
diff --git a/reflex/docs/api-reference/cli.md → docs/api-reference/cli.md b/reflex/docs/api-reference/cli.md → docs/api-reference/cli.md
diff --git a/reflex/docs/api-reference/event_triggers.md → docs/api-reference/event_triggers.md b/reflex/docs/api-reference/event_triggers.md → docs/api-reference/event_triggers.md
diff --git a/reflex/docs/api-reference/plugins.md → docs/api-reference/plugins.md b/reflex/docs/api-reference/plugins.md → docs/api-reference/plugins.md
diff --git a/reflex/docs/api-reference/special_events.md → docs/api-reference/special_events.md b/reflex/docs/api-reference/special_events.md → docs/api-reference/special_events.md
diff --git a/reflex/docs/api-reference/utils.md → docs/api-reference/utils.md b/reflex/docs/api-reference/utils.md → docs/api-reference/utils.md
diff --git a/reflex/docs/api-reference/var_system.md → docs/api-reference/var_system.md b/reflex/docs/api-reference/var_system.md → docs/api-reference/var_system.md
diff --git a/reflex/docs/api-routes/overview.md → docs/api-routes/overview.md b/reflex/docs/api-routes/overview.md → docs/api-routes/overview.md
diff --git a/docs/app/.github/workflows/codespell.yml b/docs/app/.github/workflows/codespell.yml
@@ -0,0 +1,20 @@
+name: codespell
+
+on:
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  codespell:
+    name: Check for spelling errors
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+      - name: Codespell
+        uses: codespell-project/actions-codespell@v2
+        with:
+          skip: data/*
diff --git a/docs/app/.github/workflows/integration_tests.yml b/docs/app/.github/workflows/integration_tests.yml
@@ -0,0 +1,65 @@
+name: integration-tests
+
+env:
+  TELEMETRY_ENABLED: false
+  NODE_OPTIONS: "--max_old_space_size=8192"
+  REFLEX_DEP: "git+https://github.com/reflex-dev/reflex@main"
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+  workflow_dispatch:
+    inputs:
+      reflex_dep:
+        description: "Reflex dependency (full specifier)"
+
+permissions:
+  contents: read
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  reflex-web:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          submodules: recursive
+
+      - name: Install the latest version of uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.11"
+          activate-environment: true
+
+      - name: Install the project with latest reflex from main
+        run: |
+          uv sync --all-extras --dev \
+            --upgrade-package reflex \
+            --upgrade-package reflex-core \
+            --upgrade-package reflex-docgen \
+            --upgrade-package reflex-components-code \
+            --upgrade-package reflex-components-core \
+            --upgrade-package reflex-components-dataeditor \
+            --upgrade-package reflex-components-gridjs \
+            --upgrade-package reflex-components-lucide \
+            --upgrade-package reflex-components-markdown \
+            --upgrade-package reflex-components-moment \
+            --upgrade-package reflex-components-plotly \
+            --upgrade-package reflex-components-radix \
+            --upgrade-package reflex-components-react-player \
+            --upgrade-package reflex-components-recharts \
+            --upgrade-package reflex-components-sonner
+
+      - name: Install custom reflex version (if specified)
+        if: github.event.inputs.reflex_dep
+        run: uv pip install '${{ github.event.inputs.reflex_dep }}'
+
+      - name: Init Website for reflex-web
+        run: reflex init
+
+      - name: Export the website
+        run: reflex export
diff --git a/docs/app/.github/workflows/pre-commit.yml b/docs/app/.github/workflows/pre-commit.yml
@@ -0,0 +1,28 @@
+name: pre-commit
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+
+permissions:
+  contents: read
+
+jobs:
+  pre-commit:
+    name: Pre-commit
+    timeout-minutes: 30
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Install UV
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+          activate-environment: true
+
+      - name: Install Requirements
+        run: uv sync
+
+      - run: pre-commit run --all-files --show-diff-on-failure --color=always