Sceneview

SceneView

The AI-first 3D & AR SDK for Jetpack Compose, SwiftUI and the web.

Declarative 3D and AR for app developers who want a model on screen, or in the room, without a game engine: Filament + ARCore on Android, RealityKit + ARKit on Apple, Filament.js + WebXR in the browser — with Flutter, React Native and Compose Multiplatform bridges on top. Open source, Apache 2.0.

AI-first means one thing here: an assistant that reads llms.txt or the MCP server writes SceneView code that works on the first try. When it doesn't, the API or the doc gets fixed.

---

Try it

The demo apps are built from samples/. Any demo opens straight from a link: https://sceneview.github.io/open?demo= . Start with Cosmos, the galaxy the catalogue opens on, or 3D Scan, a space scanned with ARCore and rebuilt in 3D.

A living room scanned in 3D Scan on a Pixel 9, then rebuilt as a model (sped up).

Help test the demos

Install the Android demo, record your screen while you use a demo, and tell us what breaks or confuses you: open an issue with the recording attached, or send it from the app (any demo, Settings, then Send feedback). Your first report unlocks SceneView Labs, early access to the experimental demos, straight away.

---

Quick start

One minimal, working example per platform. The full reference for each is in llms.txt.

Android

// build.gradle.kts

implementation("io.github.sceneview:sceneview:4.66.0")

The app module needs compileSdk = 37, minSdk 24 or higher, AGP 9.4.0+, Kotlin 2.4 and JVM target 21 for both Java and Kotlin: SceneView ships Java 21 bytecode with public inline functions. The quickstart requirements give the Gradle snippet and the reason for each.

@Composable

fun ModelScreen() { SceneView(modifier = Modifier.fillMaxSize()) { // orbit camera + default lighting rememberModelInstance(modelLoader, "models/helmet.glb")?.let { instance -> ModelNode(modelInstance = instance, scaleToUnits = 1.0f, autoAnimate = true) } } }

models/helmet.glb lives in src/main/assets/. rememberModelInstance returns null until the model is loaded, then recomposes. Never call modelLoader.createModel* from a background coroutine: Filament calls must run on the main thread, and rememberModelInstance handles that.

AR (Android)

// build.gradle.kts

implementation("io.github.sceneview:arsceneview:4.66.0") // includes the 3D module

@Composable

fun ARScreen() { var anchor by remember { mutableStateOf (null) }

ARSceneView( modifier = Modifier.fillMaxSize(), planeRenderer = true, onSessionUpdated = { _, frame -> if (anchor == null) { anchor = frame.getUpdatedPlanes() .firstOrNull { it.type == Plane.Type.HORIZONTAL_UPWARD_FACING } ?.let { it.createAnchorOrNull(it.centerPose) } } } ) { val helmet = rememberModelInstance(modelLoader, "models/helmet.glb") anchor?.let { a -> AnchorNode(anchor = a) { helmet?.let { ModelNode(modelInstance = it, scaleToUnits = 0.5f) } } } } }

Plane detected → anchor set → Compose recomposes → the model appears. AR state is just Kotlin state. For placement without a tap, grounded and gesture-ready, start from AutoPlacementScene (see llms.txt).

arsceneview already declares the CAMERA permission and marks ARCore as optional. An AR Optional app declares android.hardware.camera.ar and android.hardware.camera as ; an AR Required app overrides the ARCore value with tools:replace="android:value". Both snippets are in the AR manifest section.

iOS / macOS / visionOS (SwiftUI)

Swift Package Manager: https://github.com/sceneview/sceneview.git, from 4.63.0.

import SwiftUI

import SceneViewSwift

struct ModelScreen: View { @State private var model: ModelNode?

var body: some View { SceneView { root in if let model { root.addChild(model.entity) } } .contentID(model != nil) // re-run the builder once the model has loaded .environment(.studio) .cameraControls(.orbit) .task { model = try? await ModelNode.load("helmet.usdz") } } }

The content closure runs once unless its .contentID(_:) changes: without that line, a model that finishes loading after the scene appears is never added.

Web

<canvas id="viewer" style="width: 100%; height: 480px"></canvas>

Compose Multiplatform (Android · iOS · desktop)

// commonMain dependencies

implementation("io.github.sceneview:sceneview-compose:4.66.0")

SceneViewer(model = ModelSource.Asset("models/helmet.glb"), modifier = Modifier.fillMaxSize())

A viewer by design — load, orbit, light, tap; no AR. Scope and the one-time iOS setup: sceneview-compose/.

Flutter

// pubspec.yaml → flutter_sceneview: ^4.66.0

final controller = SceneViewController();

SceneView( controller: controller, onViewCreated: () => controller.loadModel( const ModelNode(modelPath: 'models/helmet.glb'), ), )

React Native

// npm install @sceneview-sdk/react-native

import { SceneView } from '@sceneview-sdk/react-native';

Flutter and React Native bridge a subset of the native API — see flutter/ and react-native/ for what is covered.

Your AI assistant

claude mcp add sceneview -- npx -y sceneview-mcp   # Claude Code

codex mcp add sceneview -- npx -y sceneview-mcp # Codex

Then ask: *"Add a 3D model viewer to my Compose screen."* Every other client is in Use with AI.

---

Runs on

Each row is a published package plus an app or page you can open today, backed by a real capture of it.

*Shipped* means released and publicly reachable; the second word is the API maturity. The other platforms in the table below join this section once a capture backs them.

---

Platforms

Install

| Apple (SPM) | `https://github.com/sceneview/