docs: quick guide to build webxr client

Author: jiwenc-nv

deps/cloudxr/webxr_client/package.json

@@ -20,7 +20,7 @@
     "clean": "rimraf dist"
   },
   "dependencies": {
-    "@nvidia/cloudxr": "dev",
+    "@nvidia/cloudxr": "file:../nvidia-cloudxr-6.1.0.tgz",
     "@preact/signals-react": "^2.2.0",
     "@react-three/drei": "^10.6.1",
     "@react-three/fiber": "^9.3.0",

…ce/getting_started/build_from_source.rst …ting_started/build_from_source/index.rstdocs/source/getting_started/build_from_source.rst renamed to docs/source/getting_started/build_from_source/index.rst docs/source/getting_started/build_from_source.rst renamed to docs/source/getting_started/build_from_source/index.rst

@@ -12,6 +12,10 @@ examples. The instructions align with the project's CMake configuration and the
    :local:
    :depth: 1
 
+.. admonition:: Next Steps
+
+   - To build and serve the **WebXR client** locally, see :doc:`webxr`.
+
 Prerequisites
 -------------
 
@@ -269,6 +273,11 @@ based on the Python version.  Note that ``pip`` and ``uv pip`` has slightly diff
    # Pass --reinstall to replace an existing install.
    uv pip install isaacteleop[retargeters,cloudxr,ui] --find-links=./install/wheels/ --reinstall
 
+.. toctree::
+   :hidden:
+
+   webxr
+
 ..
    References
 .. _`uv`: https://docs.astral.sh/uv/

docs/source/getting_started/build_from_source/webxr.rst

@@ -0,0 +1,82 @@
+.. SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+.. SPDX-License-Identifier: Apache-2.0
+
+Build WebXR Client
+==================
+
+.. tip::
+
+   A prebuilt CloudXR web client is available at https://nvidia.github.io/IsaacTeleop/client/.
+   You only need to build from source if you want to customize the client.
+
+The Isaac Teleop WebXR client is built with React, Three.js, and WebXR. It streams VR/AR content
+from a CloudXR Runtime server to the browser.  For more details about CloudXR.js SDK and its advanced features, see the
+`CloudXR.js documentation`_.
+
+The source is located at :code-file:`deps/cloudxr/webxr_client/ <deps/cloudxr/webxr_client/>`.
+
+.. contents:: Steps
+   :local:
+   :depth: 1
+
+Prerequisites
+-------------
+
+- Node.js (v20 or higher)
+
+1. Download CloudXR.js SDK
+--------------------------
+
+From the project root:
+
+.. code-block:: bash
+
+   source deps/cloudxr/webxr_client/scripts/setup_cloudxr_env.sh
+   deps/cloudxr/webxr_client/scripts/download_cloudxr_sdk.sh
+
+This will automatically download the CloudXR.js SDK and place it in ``deps/cloudxr/nvidia-cloudxr-6.1.0.tgz``.  The
+`package.json` is configured to install the SDK from this local file.
+
+2. Install dependencies
+-----------------------
+
+From the ``deps/cloudxr/webxr_client/`` directory:
+
+.. code-block:: bash
+
+   npm install ../nvidia-cloudxr-6.1.0.tgz
+
+3. Build & Run
+--------------
+
+Development build (one-shot)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Outputs to ``./build/`` with source maps for debugging:
+
+.. code-block:: bash
+
+   npm run dev
+
+Development server (with hot reload)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starts a webpack dev server on ``http://localhost:8080`` with hot module replacement:
+
+.. code-block:: bash
+
+   npm run dev-server
+
+For **HTTPS** (required by WebXR on most browsers):
+
+.. code-block:: bash
+
+   npm run dev-server:https
+
+This starts the dev server with a self-signed certificate on ``https://localhost:8080``.  You can follow the same
+instructions to use the WebXR client as documented in the :ref:`Quick Start Guide <connect-quest-pico>`.
+
+
+..
+   References
+.. _`CloudXR.js documentation`: https://docs.nvidia.com/cloudxr-sdk/latest/usr_guide/cloudxr_js/index.html

docs/source/getting_started/quick_start.rst

@@ -36,7 +36,7 @@ In a new terminal, install the package from PyPI (or from a local wheel if you b
    pip install 'isaacteleop[cloudxr,retargeters]~=1.0.0' --extra-index-url https://pypi.nvidia.com
 
 Instead of installing the package from PyPI, you can build from source and install the local wheel.
-See :doc:`build_from_source` for more details.
+See :doc:`build_from_source/index` for more details.
 
 .. _run-cloudxr-server:
 
@@ -228,9 +228,8 @@ running the CloudXR runtime and wss proxy in containerized environment; or using
       For advanced usage and troubleshooting of CloudXR, see the `CloudXR documentation`_ for more
       details.
 
-   The source code for the web client is in the :code-dir:`deps/cloudxr/webxr_client/` directory.
-   Follow the instructions in the official `CloudXR.js documentation`_ for more details if you want to
-   run the web client from source.
+   The source code for the web client is in the :code-dir:`deps/cloudxr/webxr_client/` directory.  To build the web
+   client from source, see :doc:`build_from_source/webxr`.
 
 .. _connect-apple-vision-pro:
 
@@ -344,14 +343,13 @@ More Information
 
 - :doc:`teleop_session` — learn how ``TeleopSession`` works and how to build
   custom retargeting pipelines
-- :doc:`build_from_source` — build the C++ core, Python bindings, and plugins
+- :doc:`build_from_source/index` — build the C++ core, Python bindings, and plugins
   from source
 
 ..
    References
 .. _`nvidia.github.io/IsaacTeleop/client`: https://nvidia.github.io/IsaacTeleop/client
 .. _`CloudXR documentation`: https://docs.nvidia.com/cloudxr-sdk/latest/index.html
-.. _`CloudXR.js documentation`: https://docs.nvidia.com/cloudxr-sdk/latest/usr_guide/cloudxr_js/index.html
 .. _`Isaac XR Teleop Sample Client for Apple Vision Pro`: https://github.com/isaac-sim/isaac-xr-teleop-sample-client-apple
 .. _`Isaac Lab Quick Start`: https://isaac-sim.github.io/IsaacLab/develop/source/setup/quickstart.html
 .. _`Teleoperation and Imitation Learning with Isaac Lab Mimic`: https://isaac-sim.github.io/IsaacLab/develop/source/overview/imitation-learning/teleop_imitation.html#teleoperation-imitation-learning

docs/source/index.rst

@@ -47,7 +47,7 @@ Table of Contents
    :caption: Getting Started
 
    getting_started/quick_start
-   getting_started/build_from_source
+   getting_started/build_from_source/index
    getting_started/teleop_session
    getting_started/teleop_control_state_machine
    getting_started/contributing