Skip to content

FAQ

Jump to bottom
Alex Coulombe edited this page Apr 30, 2026 · 1 revision

FAQ

Does the audience need to install an app?

No. It runs entirely in the phone's web browser — Chrome, Safari, Firefox, Edge. Scan the QR code, tap the link, wait 5–10 seconds for the 3D scene to load.

Does WebXR work on iPhone?

Partially. iOS Safari supports inline 3D (the full walk-around experience) but does not support the immersive-vr session mode needed for the "Enter VR" button. iPhone users get the full joystick + look-around experience, just not head-tracked VR. The demo still works well.

Does it work on Meta Quest?

Yes. Open the URL in the Quest Browser, wait for the scene to load, then tap "Enter VR" (top right). You get the immersive VR experience with hand tracking.

Can I add my own venue?

Yes. See Adding a Scene for the step-by-step. You'll need:

  1. A GLB model file (≤8 MB after Draco compression)
  2. A TypeScript scene module (copy four-seasons.ts as your template)
  3. A row registered in src/main.ts

Where do I get models?

See Models and Licenses for the full source list. Short version:

  • Polyhaven — CC0 props (no attribution required)
  • Sketchfab — search with the "downloadable + CC" filter for interiors
  • Luma AI Explore — Gaussian splats of real spaces (CC-BY)

What license are the models?

Each model has its own license. See LICENSES.md. CC0 = public domain (Polyhaven). CC-BY 4.0 = attribution required (most Sketchfab models). The source code (not models) is private — internal AgileLens / BPI.

The scene loads but the joystick doesn't respond on my phone.

On touch devices, the joystick activates on first touch — try pressing and holding it. If nothing happens after that, check that your browser isn't blocking JavaScript (rare with default settings).

The "Enter VR" button is greyed out / hidden.

Your device or browser doesn't support immersive-vr WebXR. This is expected on iPhone Safari and most desktop browsers. The inline 3D experience still works — you don't need the VR button to walk around the scene.

How large is the initial download?

The JavaScript bundle is ≈3–4 MB (Babylon.js tree-shaken). Scene models add 1–8 MB per scene. On first load over a 10 Mbps connection, expect 5–15 seconds. Subsequent loads hit the browser cache instantly.

Is this a real holodeck?

No. It's a walk-around viewer. Each audience member has their own local WebXR session — nobody is "in the room together" in real-time. The name refers to the design workflow: one engine renders any venue with any design options, deployed over a QR code.

Clone this wiki locally