WebXR mode — Vision Pro / Quest galaxy walk

> **Skills:** WebXR API · @react-three/xr · immersive-UX design · Vision Pro / Quest device testing
> **Time:** ~30 hours
> **Good for:** XR engineers · Vision Pro / Quest 3 owners · brave souls
> **Difficulty:** Advanced

---

## Context

The galaxy view is a 3D scene built in R3F. With minimal additional
infrastructure it can run as room-scale WebXR on Vision Pro and Quest 3 — turning
the galaxy into something you walk around inside.

## Goal

A WebXR mode toggle: enter VR/AR, the galaxy expands to room-scale, planets
become floating reachable nodes, gaze + pinch (Vision Pro) or controller
trigger (Quest) selects entities, hand-tracking surfaces the Datapad as a
floating panel.

## Where to start

- R3F supports WebXR via `@react-three/xr`. Add the package.
- Detect WebXR session support: navigator.xr → render an "Enter immersive"
button on the galaxy view's HUD
- Inside an XR session: orbit controls disabled, planets sized appropriately
for arm-length interaction, holograms scale up
- Selection + cross-pivot still works; HUD becomes a floating panel

## Acceptance criteria

- Enter WebXR session on Vision Pro / Quest 3 / Pico
- Reach out + pinch / trigger selects a planet
- Datapad floats next to selected entity
- Audio cues continue working
- Exiting returns to the desktop view

## Reference

https://immersiveweb.dev/
https://www.npmjs.com/package/@react-three/xr