AVP

Author: marwie

documentation/how-to-guides/xr/index.md

@@ -87,6 +87,24 @@ Needle Engine provides full WebXR support on iPhone and iPad through [App Clip t
 
 For USDZ/QuickLook-based iOS AR experiences, see [Everywhere Actions](/docs/how-to-guides/everywhere-actions/). This approach uses Apple's native 3D format and supports a subset of functionality including spatial audio, animations, and interactions.
 
+### <logo-header logo="/imgs/apple-logo.webp" alt="Apple">Apple Vision Pro</logo-header>
+
+**Immersive VR via WebXR — fully supported**
+
+Needle Engine works on Apple Vision Pro out of the box. Safari on visionOS 2+ ships WebXR enabled by default — no flags, no setup. The same scene you build for Meta Quest runs on Vision Pro.
+
+**Features:**
+- Immersive VR sessions via WebXR
+- Hand tracking
+- Transient pointer input (eye + pinch)
+- Picking, manipulating, physics, networking, multiplayer — same as on Quest
+
+**Interactive passthrough on Vision Pro**
+
+WebXR `immersive-ar` (passthrough) is not currently exposed by Apple on visionOS — this is a platform limitation that affects every WebXR engine, not Needle Engine specifically. For interactive passthrough content on Vision Pro today, use [Everywhere Actions](/docs/how-to-guides/everywhere-actions/). Needle Engine generates interactive USDZ files dynamically that play back in QuickLook on visionOS, with animations, material changes, spatial audio, and tap interactions — covering the most common passthrough use cases.
+
+For a cross-platform Quest + Vision Pro app: use WebXR for shared VR, and add an Everywhere Actions path for Vision Pro passthrough from the same scene.
+
 ### Supported Devices & Browsers
 
 The following devices and browsers have been verified to work with Needle Engine. When new devices with WebXR support are released, they will work with your apps out of the box.
@@ -107,7 +125,7 @@ The following devices and browsers have been verified to work with Needle Engine
 
 | Device | Browser | Features |
 | --- | --- | --- |
-| <logo-header logo="/imgs/apple-logo.webp" alt="Apple">Apple Vision Pro</logo-header> | ✔️ Safari | hand tracking, transient pointer support |
+| <logo-header logo="/imgs/apple-logo.webp" alt="Apple">Apple Vision Pro</logo-header> | ✔️ Safari (visionOS 2+) | Immersive VR via WebXR with hand tracking and transient pointer (eye + pinch). For interactive passthrough on Vision Pro, use [Everywhere Actions](/docs/how-to-guides/everywhere-actions/) — WebXR `immersive-ar` is not currently exposed by Apple on visionOS. |
 | <logo-header logo="/imgs/meta-logo.webp" alt="Meta">Meta Quest 3</logo-header> | ✔️ Meta Browser | hand tracking, sessiongranted<sup>1</sup>, passthrough, depth sensing, mesh tracking |
 | <logo-header logo="/imgs/meta-logo.webp" alt="Meta">Meta Quest 3S</logo-header> | ✔️ Meta Browser | hand tracking, sessiongranted<sup>1</sup>, passthrough, depth sensing, mesh tracking |
 | <logo-header logo="/imgs/meta-logo.webp" alt="Meta">Meta Quest 2</logo-header> | ✔️ Meta Browser | hand tracking, sessiongranted<sup>1</sup>, passthrough (black and white) |

documentation/reference/faq.md

@@ -746,6 +746,24 @@ For tips on detecting mobile devices in your scripts, see [Detect Mobile Devices
 
 To enable VR, simply add the `WebXR` component to your scene. See the [VR & AR (WebXR) guide](/docs/how-to-guides/xr/) for details.
 
+## Does it work on Apple Vision Pro?
+
+**Yes!** Apple Vision Pro is fully supported for **immersive VR** via WebXR, including hand tracking and eye+pinch input. The same scene you build for Meta Quest runs on Vision Pro — no separate codebase, no app store.
+
+For **interactive passthrough (AR)** on Vision Pro, use [Everywhere Actions](/docs/how-to-guides/everywhere-actions/) — Needle Engine generates interactive USDZ files dynamically that play back in QuickLook on visionOS. WebXR `immersive-ar` is not available on visionOS at the moment — this is a platform limitation set by Apple, and affects every WebXR engine. Needle Engine's Everywhere Actions fill that gap with animations, material changes, spatial audio, and tap interactions in passthrough.
+
+**What works today on Vision Pro:**
+- **Immersive VR via WebXR** — works in Safari on visionOS 2+ out of the box (no flags needed). Add the `WebXR` component to your scene and the VR button appears.
+- **Hand tracking** and **transient pointer** input (eye+pinch) are supported natively.
+- **Interactive passthrough via [Everywhere Actions](/docs/how-to-guides/everywhere-actions/)** — animations, material changes, spatial audio, and tap interactions all play back in QuickLook on visionOS.
+- Picking up and manipulating virtual objects, physics, networking, and the rest of the engine feature set all work the same way they do on Quest in VR mode.
+
+**Recommended approach for a cross-platform Quest + Vision Pro app:**
+- For shared VR experiences (full immersion, hand tracking, multiplayer), build once with Needle Engine and ship to **both Quest and Vision Pro** via WebXR — same scene, same code.
+- If your app needs passthrough on Vision Pro, use [Everywhere Actions](/docs/how-to-guides/everywhere-actions/) for the Vision Pro path and WebXR passthrough for the Quest path. The same scene can target both.
+
+See [WebXR device support](/docs/how-to-guides/xr/#vr-headsets) for the full feature matrix.
+
 ## Does it work on iOS?
 
 **Yes!** Needle Engine works on iOS in two ways: