Disclaimer: This is not an officially supported Google product.

Three-Live

AI-First Native 3D & AR: On-device JIT compiler turning live, AI-generated Three.js into native Android Filament, iOS RealityKit, and WebXR.

LLMs excel at generating Three.js code. Three-Live compiles it on-device in a sandbox and renders natively with Google Filament and Scene Viewer on Android, Apple RealityKit and Quick Look on iOS, and WebGL2 and WebXR on Web.

Live interactive playgrounds (no build required):

• Playground hub — Launch either studio in your desktop, mobile, or headset browser.
• <three-live> 3D and AR studio — Procedural Three.js editor, PBR inspector, and 1-tap USDZ, GLB, and AR export (< 72 KB gz).
• <xr-live> spatial computing studio — 6DoF WebXR, spatial HTML <div slot="spatial"> cards, depth physics, hand tracking, 14 spatial plugins, and 5 simulation plugins (< 83 KB gz core, < 175 KB gz full).

---

Why Three-Live and XR-Live

Interactive AR and XR that works on iOS, Android, and headsets

In practice, browser WebXR (navigator.xr) only covers part of the device landscape:

• iOS Safari, iOS WKWebView, and Android System WebView don't support WebXR. A WebXR-only app can't enter AR in Safari on iPhone or iPad, and can't run WebXR inside an embedded WebView or WKWebView in a native mobile app.
• Static OS handoffs (AR Quick Look and Scene Viewer) strip interactivity. Exporting a static .usdz or .glb file to the OS previewer works for viewing a model, but drops JavaScript animate() loops, custom state, and interactive plugins.
• Browser WebXR doesn't use native spatial compositors. In Chrome on Android, WebXR renders WebGL2 in the browser process rather than using Google Filament or Jetpack XR SceneCore's HomeSpace shared space. On visionOS, browser WebXR runs in an isolated fullscreen VR session without camera passthrough or SwiftUI Shared Space integration.

Three-Live solves this by compiling the same Three.js script on-device and running it natively on each platform's own engine. The following table shows what you get in each environment:

Target environment	What happens with browser WebXR or static AR handoff	What you can do with Three-Live and XR-Live
iPhone and iPad (native SwiftUI app)	WKWebView has no WebXR; AR Quick Look only shows static .usdz files	Run live Three.js scenes, animate() loops, KHR_interactivity, and spatial plugins natively in ARKit and RealityKit (ARView and RealityView).
Android phones and tablets (native Compose or View app)	android.webkit.WebView has no WebXR; Scene Viewer only shows static .glb files	Compile Three.js over JNI and render natively in Google Filament and ARCore (XRLiveRuntimeSession) inside your app UI.
Android XR and Apple Vision Pro headsets	Browser WebXR is isolated in a fullscreen WebGL session	Attach native Jetpack XR SceneCore (GltfEntity, MovableComponent, Anchor) or RealityKit entities that live in the system shared space alongside native panels.
Mobile and headset web browsers	Standard WebXR works on Android Chrome and headsets; iOS Safari has no WebXR	Run 6DoF WebXR where supported, with automatic Stereo SBS, gyroscope, and in-memory .usdz and .glb AR handoff on iOS Safari.

Small core bundles with optional plugins for advanced features

Three-Live keeps its web footprint small so you can drop 3D or XR into a page without shipping unused code. Every bundle and plugin works on both prebuilt .glb, .usdz, and .spz assets and live <script type="text/three"> scenes:

• Compact core (< 28 KB to < 71 KB gz): The 3D viewer (three-live-viewer.min.js) is < 28 KB gz (< 59 KB gz with the live Three.js compiler in three-live.min.js), and the WebXR viewer (xr-live-viewer.min.js) is < 50 KB gz (< 71 KB gz with the live Three.js compiler in xr-live.min.js).
• Core 3D, CAD, and animation plugins (<three-live>, 13 plugins): Optional domain bundles (three-live-studio.min.js at < 22 KB gz, three-live-cad.min.js at < 9 KB gz, and three-live-animation.min.js at < 8 KB gz, or < 91 KB gz combined in three-live-full.min.js) add KHR_interactivity behavior graphs, PBR Next materials, KHR_materials_variants, EXT_meshopt_compression, HDRI and spherical-harmonics lighting, contact shadows, 3D hotspots, post-processing (bloom and outline), 2D Shape/ExtrudeGeometry, 3D CSG Booleans, 3D vector TextGeometry, 64-joint GPU skeletal skinning, morph targets, keyframe cross-fading, and two-bone / FABRIK inverse kinematics (ik).
• Hardware XR sensors (xr-live-sensors.min.js, < 10 KB gz): Adds hardware WebXR depth occlusion (XRDepthManager), analytical heightfield physics (XRHeightfieldPhysics), 25-joint hand gesture classification (XRHandGestureClassifier), the desktop 6DoF keyboard/mouse simulator (XRDesktopSimulator), HRTF spatial audio earcons, and WebMCP agent tools.
• Spatial computing plugins (xr-live-spatial.min.js, 14 plugins, < 56 KB gz): Each advanced spatial capability in xr-live-spatial.min.js is a standalone, zero-dependency plugin (~2 to 5 KB gz each) with a matching native implementation in the Android and iOS SDKs.
• Simulation and scenario plugins (xr-live-sim.min.js, 5 plugins, < 22 KB gz): Five plugins for games, training drills, and safety walkthroughs add a controllable character, autonomous steering agents, integrity and trigger zones, checklist objectives with scoring and timers, and procedural audio cues across Web, Android, and iOS.

Core 3D, CAD, and animation plugins (<three-live>)

The following table lists the thirteen modular 3D, CAD, and animation plugins included in three-live-studio.min.js, three-live-cad.min.js, three-live-animation.min.js, and three-live-full.min.js:

Plugin	Attribute or API	What it adds
interactivity	userData.interactivity, KHR_interactivity	Compiles and executes glTF KHR_interactivity behavior graphs (onSelect, onHoverIn, onStart, toggleTransform, interpolate, cycleMaterialColor, and sendEvent) with step and tween budgets.
materials	MeshPhysicalMaterial, variant-name	PBR Next material properties (clearcoat, transmission, ior, thickness, attenuationColor, sheen, iridescence, and anisotropy).
variants	variant-name, userData.variants	KHR_materials_variants multi-colorway configurators and USDZ VariantSet export.
meshopt	EXT_meshopt_compression	Zero-WASM decoder and encoder for EXT_meshopt_compression vertex, index, and animation buffers (OCTAHEDRAL, QUATERNION, EXPONENTIAL).
envmap	environment-image, skybox-image, exposure	Procedural studio environment lighting, HDRI skyboxes, and 9-band spherical-harmonics diffuse irradiance.
shadows	shadow-intensity, shadow-softness	Soft ground-plane contact shadows and dynamic shadow-map updates matching scene bounds.
hotspots	slot="hotspot-*", data-position, data-normal	3D surface-anchored HTML annotations with normal-facing visibility culling and SVG leader lines.
webxr	ar, ar-modes, ar-scale, ar-placement	Zero-server runtime .glb and .usdz packaging for 1-tap mobile AR handoff across WebXR, Android Scene Viewer, and iOS Quick Look.
postprocessing	bloom, outline, tone-mapping, xr.bloom, xr.outline	Dual-Kawase mipmap bloom, selection/hover silhouette outlines, and neutral, aces, agx, reinhard, and none tone mapping.
cad	THREE.Shape, THREE.ExtrudeGeometry, THREE.CSG, THREE.TextGeometry	2D Path/Shape with earcut hole triangulation, ExtrudeGeometry with beveling, 3D BSP CSG Booleans (union, subtract, intersect), and Hershey TextGeometry.
skinning	animation-name, autoplay	64-joint GPU vertex skinning and skeletal hierarchy evaluation.
morph	morphTargetInfluences	GPU morph-target vertex displacement and weight blending.
keyframes	animationCrossfadeDuration	Linear, step, and cubic-spline (CUBICSPLINE) TRS keyframe interpolation with smooth clip cross-fading.
ik	THREE.IKSolver, xr.ik	Analytic two-bone (arm/leg with pole vector) and multi-joint FABRIK inverse kinematics chains.

Spatial perception, splat, and multimodal AI plugins (<xr-live>)

The following table lists the seven perception, rendering, and AI plugins in xr-live-spatial.min.js:

Plugin	Attribute or userData.xr trait	What it adds across WebXR, Android Filament, and iOS RealityKit
head-follow	xr.follow, xr.orbit	Lazy HUD head or hand follow with an angular deadzone and critically damped spring, plus 3D satellite orbits.
manipulation-handles	xr.handles	Four top-corner uniform scale handles and a bottom pedestal yaw-rotation bar that emit xr-handles-change events.
world-understanding	world-understanding="planes reticle"	Real-world plane and mesh tracking, surface-normal gaze reticle, XRTapeMeasure, and 2D-to-3D bounding-box unprojection (detectObjects).
gemini-live	connectGeminiLive(), xr.holdToAsk	Real-time bidirectional WebSocket vision and 16/24 kHz PCM voice streaming, barge-in cancellation, live transcription, and press-and-hold mesh queries.
spatial-paint	spatial-paint="#38bdf8"	Pinch-to-paint 3D Catmull-Rom spline strokes extruded as twist-free parallel-transport tubes with undo() and clear().
depth-particles	xr.particles	GPU-friendly rain, snow, sparks, and confetti emitters (up to 2,000 particles per emitter) that collide with floors and real-world depth maps.
splat-loader	xr.splatUrl, allow-remote-splats	Streams .splat and .spz (v2 and v3) 3D Gaussian Splats (up to 1,000,000 splats) with per-frame 16-bit counting sort.

CAD review, spatial layout, locomotion, and co-presence plugins (<xr-live>)

The following table lists the seven CAD, layout, locomotion, and multi-user plugins in xr-live-spatial.min.js:

Plugin	Attribute or userData.xr trait	What it adds across WebXR, Android Filament, and iOS RealityKit
spatial-measure	spatial-measure="bounds|tape|all", xr.dimensions	Live W × H × D bounding-box dimension callout bars with 3D vector-glyph labels (m, cm, mm, in, and ft-in) and point-to-point AR tape measure.
magnetic-snap	magnetic-snap, xr.snapTo, xr.snapSocket	Magnetic socket snapping with 1.25× breakaway hysteresis and pulsing preview rings, plus Cartesian grid, yaw angle, and surface snapping.
gaze-dwell	gaze-dwell, xr.gaze	Hands-free eye and head gaze raycasting with EMA smoothing, 1.5° micro-saccade grace cone, and radial dwell progress ring (select or ask).
exploded-view	explode="0..1", section-plane, xr.explode	Multi-part CAD assembly explosion with staggered layers, dashed leader lines, two-hand spread gesture, and GPU cross-section slicer.
persistent-anchors	persistent-anchors, persist-url-hash, xr.anchor.persist	Three-tier pose persistence across reloads and sessions via shareable #xr-state=<base64url> URLs, localStorage, and native anchors.
spatial-locomotion	locomotion="teleport snap-turn", xr.navigable	Ballistic parabolic teleport arc with walkable and blocked surface validation, thumbstick snap-turn or smooth glide, and a 120ms FOV comfort vignette.
shared-room	shared-room="<id>|wss://...", xr.sync	Zero-dependency multi-user co-presence (20 Hz quantized avatars and laser rays, optimistic grab locks with deterministic tie-breaking, and synced explode and paint).

Interactive simulation, agent, and scenario plugins (xr-live-sim)

The following table lists the five simulation plugins in xr-live-sim.min.js (see Simulation plugins for full details):

Plugin	Attribute or userData.xr trait	What it adds across Web, Android Filament, and iOS RealityKit
character-controller	character-controller, xr.character	Capsule kinematics with floor and slope stepping, jump with coyote time, keyboard, gamepad, and touch-joystick input, and third-person, first-person, top-down, or fixed-camera rig follow.
steering-agents	steering-agents, xr.agent	Autonomous kinematic agents (patrol, chase, flee, follow, and wander) with vision-cone target acquisition, obstacle avoidance, and agentstatechange and agentreach events.
hit-zones	hit-zones, xr.integrity, xr.zone, xr.spawner	Part and target integrity with world-space bars, hit flashes, projectile, hitscan, and contact interactions, burst fragments, colored trigger zone volumes, and timed template spawner pooling.
objectives	objectives, scenario-timer, target-score, attempts, xr.objective	Ordered or unordered checklist objectives (reach, clear, collect, activate, and hold), score, attempt counter, countdown timer, HUD overlay (sim-hud), and scenario-reset-key resets.
synth-audio	synth-audio, synth-volume, xr.audioCues	Zero-asset procedural audio synthesis (beep, chime, buzz, thud, sweep, click, alarm, and whoosh) bound to simulation events via Web Audio, Android AudioTrack, and iOS AVAudioEngine.

Safe execution for live, AI-generated Three.js

Because LLMs already know Three.js, an agent or backend can generate a complete interactive 3D or XR scene in 15 to 30 lines of JavaScript without external binary assets. Three-Live executes client scripts inside a dedicated Web Worker or an opaque-origin <iframe sandbox="allow-scripts"> (connect-src 'none') on the web, and inside a sandboxed Rust Boa VM on Android and iOS—with network and storage globals removed, Object.prototype frozen, CPU instruction fuel limits, and scene geometry memory quotas.

---

Compare <three-live> and <xr-live>

The following table compares <three-live> with <xr-live>:

Capability	<three-live>	<xr-live> (extends <three-live>)
Primary use case	3D product viewers, procedural scenes, and 1-tap AR handoff	Interactive 6DoF WebXR, native mobile XR, spatial UI cards, depth physics, and hand tracking
Procedural <script type="text/three">	Yes (sandboxed Web Worker or <iframe> JIT compiler)	Yes (inherits three-author JIT compiler plus userData.xr traits)
Mobile AR and XR	Universal AR handoff (AR Quick Look, Scene Viewer, WebXR)	Native Android (Filament and SceneCore), native iOS and visionOS (RealityKit), and WebXR
Spatial interaction	Orbit controls, mesh picking, 3D surface hotspots, KHR_interactivity	Declarative userData.xr traits (grab, scale, billboard, anchor, handles, snapTo, gaze, explode, navigable, sync), 14 spatial plugins, 5 xr-live-sim simulation plugins, 25-joint hands, and KHR_interactivity
Spatial HTML UI	2D screen-space overlay hotspots (slot="hotspot-*")	3D textured and raycastable HTML cards (<div slot="spatial">)
Default bundle budget	< 28 KB gz (viewer), < 72 KB gz (three-live.min.js)	< 50 KB gz (viewer), < 83 KB gz (xr-live.min.js), < 175 KB gz (xr-live-full.min.js)

---

Quickstarts

Render a procedural 3D scene with <three-live>

<script type="module" src="/dist/three-live.min.js"></script>

<three-live allow-client-scripts camera-controls ar auto-rotate style="width: 100%; height: 480px; display: block;">
  <script type="text/three">
    const mesh = new THREE.Mesh(
      new THREE.TorusKnotGeometry(0.4, 0.14, 64, 16),
      new THREE.MeshStandardMaterial({ color: 0x4285f4, metalness: 0.6, roughness: 0.2 })
    );
    scene.add(mesh);
  </script>
</three-live>

Build a spatial scene with <xr-live>

<script type="module" src="/dist/xr-live-full.min.js"></script>

<xr-live
  allow-client-scripts
  xr-mode="inline-ar"
  xr-depth="occlusion-physics"
  xr-hands="gestures"
  world-understanding="planes reticle"
  spatial-paint="#38bdf8"
  camera-controls
  style="width: 100%; height: 560px; display: block;">
  <xr-anchor name="chair" src="/models/chair.glb" position="0 0 -1.2" data-xr-traits="grab scale anchor"></xr-anchor>

  <div slot="spatial" data-position="0.45 0.9 -1.1" data-xr-traits="grab billboard">
    <div style="padding: 14px; background: #0f172a; color: #fff; border-radius: 12px;">
      <h4>Spatial product card</h4>
      <button>Pinch to interact</button>
    </div>
  </div>
</xr-live>

Register optional plugins for advanced features

If you use a bundler and only need specific spatial plugins on top of the < 83 KB gz <xr-live> core, import and register just those plugins:

import { XRLiveElement } from 'three-live/xr-live';
import { spatialMeasurePlugin } from 'xr-live/src/plugins/spatial-measure';
import { magneticSnapPlugin } from 'xr-live/src/plugins/magnetic-snap';

XRLiveElement.registerPlugin(spatialMeasurePlugin);
XRLiveElement.registerPlugin(magneticSnapPlugin);

Run natively on Android with Google Filament and Jetpack XR SceneCore

import com.google.threelive.FilamentHelper
import com.google.threelive.XRLiveRuntimeSession
import com.google.threelive.XRLiveSceneCoreHelper

// Compile a Three.js script to a zero-copy GLB buffer and render in Google Filament
val holder = FilamentHelper.loadModelZeroCopy(script) { buffer ->
    assetLoader.createAssetFromBinary(buffer)
}

// Drive live KHR_interactivity graphs, head-follow springs, orbits, and spatial features on each frame
val runtime = XRLiveRuntimeSession.fromGlb(holder.byteBuffer)
runtime.step(dtSeconds = 1.0 / 60.0)

// Or hydrate interactive spatial traits (grab, scale, billboard, anchor) in Android XR SceneCore
XRLiveSceneCoreHelper.attachTraitsFromGlb(xrSession, entity, holder.byteBuffer)

Run natively on iOS and visionOS with Apple RealityKit

import ThreeLiveCompiler
import RealityKit

@MainActor
func loadSpatialScene(from script: String, into arView: ARView) async throws -> XRLiveRealityKitSession? {
    let glb = try ThreeCompiler.compileToGLB(script: script)
    let entity = try await RealityKitHelper.loadEntity(fromGLB: glb)
    XRLiveRealityKit.installTraits(on: entity, in: arView)

    // Bind live KHR_interactivity and spatial traits to RealityKit SceneEvents.Update
    let session = XRLiveRealityKitSession(glbData: glb, root: entity)
    session?.installInputTargets()
    session?.start()
    return session
}

Compile scenes from the command line (three-live-cli)

$ three-live-cli convert scene.js -o output.glb

---

Project status

Three-Live is in Developer Preview (Alpha). It is an experimental open-source library exploring AI-driven procedural 3D and spatial computing across Web, Android, and Apple platforms.

• Prebuilt distributions: Standalone web JavaScript bundles (three-live-web-dist.zip), the Apple XCFramework (ThreeLiveCompiler.xcframework.zip), the Android release AAR (three-live-compiler-release.aar), and native three-live-cli binaries for macOS, Linux, and Windows are published on GitHub Releases.
• Package registries: Direct consumption through Swift Package Manager, GitHub Releases, and the GitHub Pages CDN works today (see Install packages and bundles). Publishing to public package registries (npm, Crates.io, and Maven) is planned for a future release.
• Release notes: See CHANGELOG.md for release history and architectural notes.

---

Install packages and bundles

Package installation

• Web (CDN, prebuilt release, or source):

  • Hosted ES module (<script>):

    <script type="module" src="https://google.github.io/three-live/dist/three-live.min.js"></script>

  • Prebuilt bundle archive: Download three-live-web-dist.zip from GitHub Releases.

  • From source: Run git clone https://github.com/google/three-live.git && cd three-live && npm install && npm run build.

• iOS, macOS, and visionOS (Swift Package Manager):

  .package(url: "https://github.com/google/three-live.git", from: "1.0.0")

  Swift Package Manager automatically resolves the prebuilt, checksum-pinned ThreeLiveCompiler.xcframework.zip archive from GitHub Releases—no local Rust or Node.js toolchain is required.

• Android (prebuilt release AAR or source):

  • Prebuilt AAR: Download three-live-compiler-release.aar (includes arm64-v8a, armeabi-v7a, and x86_64 JNI .so libraries) from GitHub Releases into app/libs/ and add implementation(files("libs/three-live-compiler-release.aar")).
  • From source: Run make android (or bash scripts/build_android_aar.sh).

• Rust CLI (three-live-cli) and crate:

  • Prebuilt binaries: Download standalone binaries for macOS (arm64 and x86_64), Linux (x86_64 and aarch64), and Windows (x86_64.exe) from GitHub Releases.
  • From source: Run make rust (npm run build && cargo build --manifest-path compiler/Cargo.toml --release --bin three-live-cli).

JavaScript bundles and enforced size budgets

Every bundle targets es2020, strips full license blocks (--legal-comments=none), and emits a single four-line SPDX header. The following table lists each bundle and its enforced gzipped budget:

Family	Bundle file	Enforced budget (.min.js.gz)	Included capabilities
three-live	three-live-viewer.min.js	< 28 KB gz	Lean .glb and .usdz WebGL2 PBR viewer, TRS animations, orbit controls, and AR packager.
	three-live.min.js	< 59 KB gz	Standard <three-live> + three-author (<script type="text/three">, InstancedMesh GPU instancing, KHR_interactivity compiler, 5 tone-mapping modes, contact shadows) + AR packager.
	three-live-studio.min.js	< 22 KB gz	Add-on plugin: PBR Next extensions, HDRI and SH irradiance, bloom/outline post-processing, KHR_materials_variants, EXT_meshopt_compression, KHR_interactivity VM, 3D hotspots, and WebXR AR.
	three-live-cad.min.js	< 9 KB gz	Add-on plugin: 2D Path/Shape with earcut hole triangulation, ExtrudeGeometry with beveling, 3D CSG BSP Booleans (union, subtract, intersect), and 3D Hershey TextGeometry.
	three-live-animation.min.js	< 8 KB gz	Add-on plugin: 64-joint GPU skeletal skinning, morph targets, animation cross-fading, and two-bone / FABRIK inverse kinematics (ik / THREE.IKSolver).
	three-live-full.min.js	< 91 KB gz	All-in-one 3D bundle (three-live + studio + cad + animation, all 13 plugins auto-registered).
xr-live	xr-live-viewer.min.js	< 50 KB gz	Lean .glb and .usdz WebXR viewer + spatial traits (grab, scale, billboard, anchor), <div slot="spatial">, and mobile AR bridge.
	xr-live.min.js	< 71 KB gz	Standard <xr-live> + three-author (<script type="text/three">) + runtime USDZ and GLB compiler.
	xr-live-sensors.min.js	< 10 KB gz	Add-on plugin: Hardware XR sensors (XRDepthManager, XRHeightfieldPhysics, 25-joint XRHandGestureClassifier), XRDesktopSimulator, Spatial Audio, Skybox, and WebMCP tools.
	xr-live-spatial.min.js	< 56 KB gz	Add-on plugin bundle registering all 14 spatial plugins (head-follow, manipulation-handles, world-understanding, gemini-live, spatial-paint, depth-particles, splat-loader, spatial-measure, magnetic-snap, gaze-dwell, exploded-view, persistent-anchors, spatial-locomotion, shared-room).
	xr-live-sim.min.js	< 22 KB gz	Add-on simulation plugin bundle registering all five simulation plugins (character-controller, steering-agents, hit-zones, objectives, synth-audio).
	xr-live-full.min.js	< 177 KB gz	All-in-one 3D, XR, and simulation bundle (three-live-full + xr-live + xr-live-sensors + all 14 spatial plugins + all 5 simulation plugins).

---

Documentation guide

The following guides cover the web components, spatial plugins, native SDKs, and LLM authoring workflows:

Guide	Audience	Contents
docs/three-live.md	Web and mobile developers	Complete <three-live> reference: attributes, JavaScript viewer API, DOM events, KHR_interactivity authoring, 3D hotspots, PBR Next and HDRI, animations, and sandboxing.
docs/xr-live.md	Spatial and XR developers	Complete <xr-live> and plugins guide: why native bridges matter, optional plugin registration, canonical userData.xr traits, all 14 spatial plugins, the five xr-live-sim simulation plugins, <div slot="spatial"> cards, depth and physics, 25-joint hands, WebMCP, and native Android and iOS runtimes.
docs/cookbook.md	All developers	Copy-pasteable recipes for e-commerce configurators, precision manipulation handles, Gemini Live spatial assistants, 3D spatial paint, CAD exploded views and measurements, magnetic snapping and persistent anchors, multi-user co-presence, and interactive training and simulation drills (xr-live-sim).
docs/llm-guide.md	LLMs and agents	Copy-paste system prompt snippet, canonical userData.xr and userData.interactivity schemas, strict THREE.* allowlist, scene quotas, and few-shot templates.
AGENTS.md	Coding agents	Repository rules, three-target cross-platform parity contract, build and test commands, bundle budgets, and security invariants.
skills/	Agent skills	Progressive-disclosure SKILL.md skills for authoring scenes (three-live-authoring) and developing plugins (xr-live-plugin-dev).
llms.txt and llms-full.txt	LLM context feeds	Single-file concise index (llms.txt) and complete concatenated reference (llms-full.txt) for LLM context windows.
CHANGELOG.md	All users	Release notes and architectural summary for the Developer Preview release.

---

Build and run demos

Run make (or make help) from the repository root to build packages, run tests, or open the interactive studio demos:

$ make doctor        # Check installed toolchains (Node, Rust, Xcode, Android NDK)
$ make web           # Compile all <three-live> and <xr-live> JS bundles and embedded engine
$ make web-demo      # Launch web playgrounds at http://localhost:8888/three/ and /xr/
$ make test          # Run full web, Rust compiler, and mobile parity test suites
$ make ios-demo      # Build XCFramework, generate .xcodeproj, and open in Xcode (macOS)
$ make android-demo  # Build JNI .so slices and debug Compose APK, and open Android Studio

---

Repository structure

The repository is organized into the following directories:

three-live/
├── Makefile               # Unified web, Rust, iOS (Xcode), and Android Studio build targets
├── three-live/            # Core 3D and AR engine and <three-live> Web Component
├── xr-live/               # Spatial computing and Deep XR SDK, <xr-live>, 14 spatial plugins, and 5 sim plugins
├── mobile/                # Native Android (Kotlin, Filament, SceneCore) and iOS (Swift, RealityKit) SDKs
├── compiler/              # In-process Rust procedural Three.js to GLB and USDZ compiler and CLI
├── docs/                  # Reference documentation for <three-live>, <xr-live>, and LLMs
├── examples/              # Web and mobile example applications
└── scripts/               # Build and bundle verification scripts

---

Security and license

• Security: See SECURITY.md for instructions on reporting vulnerabilities. Eligibility for the Google Open Source Software Vulnerability Rewards Program is determined by the Google Open Source Software Vulnerability Reward Program Rules.
• License: Apache 2.0 (see LICENSE).