docs: deploy via GitHub Action + wrangler

Author: geng-haoran

.github/workflows/deploy-docs.yml

@@ -0,0 +1,46 @@
+name: Deploy docs to Cloudflare Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'scripts/docs/**'
+      - 'roboverse_pack/tasks/**'
+      - '.github/workflows/deploy-docs.yml'
+  workflow_dispatch:
+
+concurrency:
+  group: deploy-docs
+  cancel-in-progress: true
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: pip
+          cache-dependency-path: docs/requirements.txt
+
+      - name: Install docs dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r docs/requirements.txt
+
+      - name: Build roboverse.wiki
+        run: bash scripts/docs/build_roboverse_wiki.sh public
+        env:
+          METASIM_REF: main
+
+      - name: Deploy to Cloudflare Pages
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy public --project-name=roboverse-release --branch=main

docs/README.md

@@ -27,12 +27,31 @@ This is due to some files are automatically generated in `source/dataset_benchma
 
 ## Cloudflare Pages deployment
 
-Cloudflare Pages should build the static docs without installing the RoboVerse Python package. Set the Pages build variable `SKIP_DEPENDENCY_INSTALL=1` so Cloudflare skips the automatic `pip install .` phase, which otherwise downloads simulator/runtime packages such as `torch`.
+The site is deployed via the `.github/workflows/deploy-docs.yml` GitHub
+Action, which builds in CI and uploads the static `public/` directory to
+the Cloudflare Pages project `roboverse-release` with
+`wrangler pages deploy`. Cloudflare itself is **not** asked to build —
+this avoids its framework auto-detection running `pip install .` against
+the repository's `pyproject.toml`, which would otherwise pull in `torch`,
+`metasim` (with all of its sim/runtime deps), and friends.
 
-Use this build command:
+Required GitHub repository secrets:
+
+- `CLOUDFLARE_API_TOKEN` — token with `Account → Cloudflare Pages → Edit`
+- `CLOUDFLARE_ACCOUNT_ID` — the Cloudflare account ID hosting the Pages project
+
+In the Cloudflare Pages dashboard for `roboverse-release`, disable the
+git integration's build (or set Build command + Build output directory
+to empty) so Cloudflare doesn't shadow-build on every push. The project
+should be set to receive deployments via Direct Upload only.
+
+The workflow triggers on `push` to `main` when `docs/`, `scripts/docs/`,
+or `roboverse_pack/tasks/` changes, plus manual `workflow_dispatch`.
+
+To reproduce the build locally:
 
 ```bash
-python -m pip install --upgrade pip && python -m pip install -r docs/requirements.txt && bash scripts/docs/build_roboverse_wiki.sh public
+python -m pip install --upgrade pip
+python -m pip install -r docs/requirements.txt
+bash scripts/docs/build_roboverse_wiki.sh public
 ```
-
-Set the build output directory to `public`.