sceneview
3D & AR SDK for Android (Jetpack Compose + Filament), Apple (SwiftUI + RealityKit), Web, Flutter and React Native. Opens glTF/GLB, 3MF, STL, OBJ and PLY on Android and USDZ on Apple, at real size in AR. Assistant-ready: in-repo MCP server, AGENTS.md and llms.txt — no assistant-specific setup.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/sceneview/sceneview with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/sceneview/sceneview'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/sceneview--sceneview)HTML
<a href="/listings/sceneview--sceneview"><img src="/api/listings/sceneview--sceneview/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
One minimal, working example per platform. The full reference for each is in [`llms.txt`](./llms.txt).
Android
// build.gradle.kts
implementation("io.github.sceneview:sceneview:4.52.0")@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.52.0") // includes the 3D module@Composable
fun ARScreen() {
var anchor by remember { mutableStateOf<Anchor?>(null) }
ARSceneView(
modifier = Modifier.fillMaxSize(),
planeRenderer = true,
onSessionUpdated = { _, frame ->
if (anchor == null) {
anchor = frame.getUpdatedPlanes()
.firstOrNull { it.type == Plane.Type.HORIZONTAL_UPWARD_FACING }
?.let { frame.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`](./llms.txt)).
iOS / macOS / visionOS (SwiftUI)
Swift Package Manager: `https://github.com/sceneview/sceneview.git`, from `4.39.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>
<script src="https://cdn.jsdelivr.net/gh/sceneview/sceneview@v4.52.0/website-static/js/filament/filament.js"></script>
<script src="https://cdn.jsdelivr.net/gh/sceneview/sceneview@v4.52.0/website-static/js/sceneview.js"></script>
<script> SceneView.modelViewer("viewer", "model.glb") </script>Compose Multiplatform (Android · iOS · desktop)
// commonMain dependencies
implementation("io.github.sceneview:sceneview-compose:4.52.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/`](sceneview-compose/README.md).
Flutter
// pubspec.yaml → flutter_sceneview: ^4.52.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';
<SceneView
style={{ flex: 1 }}
modelNodes={[{ src: 'models/helmet.glb', position: [0, 0, -2] }]}What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 635 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # SceneView
- > **The AI-first 3D & AR SDK for Jetpack Compose — 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, Filament.js + WebXR in the browser, and a Compose
- Multiplatform viewer. It is the
- maintained successor to Google Sceneform. Open source, Apache 2.0.
- | Building with | Add | Then write |
- |---|---|---|
- | Jetpack Compose — 3D | `io.github.sceneview:sceneview:4.69.7` | `SceneView { }` |
- | Jetpack Compose — AR | `io.github.sceneview:arsceneview:4.69.7` | `ARSceneView { }` or `PlacementScene` |
- | Android Views / XML | the same | `SceneView { }` inside a `ComposeView` |
- | Kotlin / Compose Multiplatform | `io.github.sceneview:sceneview-compose:4.69.7` | `SceneViewer(model = …)` in `commonMain` |
- | Web | `npm install sceneview-web` | `SceneView.modelViewer("canvas", "model.glb")` |
- Moving from Sceneform, or from SceneView 2.x code (`Scene(childNodes = …)`, `ARScene`)?
- [The mapping](https://sceneview.github.io/docs/sceneform-replacement/). Which artifact fits your app:
- [3D and AR library, per platform](https://sceneview.github.io/docs/3d-ar-library/).
- **Used in production.** More than 1,300 stars on GitHub, and over 500 public repositories declare
- SceneView as a dependency. It ships on Google Play in the Volkswagen, Audi, Porsche and CUPRA
- apps, Philips Hue, Medal and IKEA, is declared by the open-source apps Bitkey (Block) and Vocable
- (WillowTree), and is a dependency of the GeneXus Augmented Reality module and the TruVideo camera
- SDK. The Niantic Spatial SDK samples use it for AR. Lenskart ships
- [Sceneform Maintained](https://github.com/sceneview/sceneform-android), SceneView's predecessor, and Safie presented
- SceneView in [a public talk](https://speakerdeck.com/jeromecha/mobile-dev-japan-number-3-safie-viewer-android-and-sceneview).
- **AI-first** means one thing here: an assistant that reads [`llms.txt`](./llms.txt) or
- [the MCP server](./mcp/) writes SceneView code that works on the first try. When it doesn't, the
- API or the doc gets fixed.
- <!-- Platforms -->
- [](https://central.sonatype.com/artifact/io.github.sceneview/sceneview)
- [](https://central.sonatype.com/artifact/io.github.sceneview/arsceneview)
- [](https://github.com/sceneview/sceneview)
- [](https://www.npmjs.com/package/sceneview-web)
- [](https://pub.dev/packages/flutter_sceneview)
- [](https://www.npmjs.com/package/@sceneview-sdk/react-native)
- [](https://www.npmjs.com/package/sceneview-mcp)
- <!-- Status -->
- [](https://github.com/sceneview/sceneview/actions/workflows/ci.yml)
- [](https://github.com/sceneview/sceneview/blob/main/LICENSE)
- [](https://github.com/sceneview/sceneview)
- [](https://discord.gg/UbNDDBTNqb)
- [](https://opencollective.com/sceneview)
- ---
- ## Try it
- <p>
- <a href="https://play.google.com/store/apps/details?id=io.github.sceneview.demo"><img src="website-static/assets/brand/stores/google-play-badge-trimmed.png" alt="Get it on Google Play" height="56"></a>
- <a href="https://apps.apple.com/us/app/sceneview-demo-sdk-samples/id6761329763"><img src="website-static/assets/brand/stores/app-store.svg" alt="Download on the App Store" height="56"></a>
- <a href="https://sceneview.github.io/web-demo/"><img src="website-static/assets/brand/stores/web-demo.svg" alt="Open the web demo" height="56"></a>
- </p>
- The demo apps are built from [`samples/`](samples/). Any demo opens straight from a link:
- `https://sceneview.github.io/open?demo=<id>`. Start with
- [Cosmos](https://sceneview.github.io/open?demo=cosmos), the galaxy the catalogue opens on, or
- [3D Scan](https://sceneview.github.io/open?demo=ar-rerun), a space scanned with ARCore and rebuilt in 3D.
- <p align="center">
- <a href="https://sceneview.github.io/open?demo=ar-rerun"><img src="website-static/assets/demos/scan-room.webp" alt="3D Scan on a Pixel 9: a living room is scanned wall by wall, then rebuilt as a 3D model you can turn" width="300"></a>
- <br>
- <sub>A living room scanned in 3D Scan on a Pixel 9, then rebuilt as a model (sped up).</sub>
- </p>
- ### 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](https://github.com/sceneview/sceneview/issues/new?labels=user-feedback)
- with the recording attached, or send it from the app (any demo, Settings, then Send feedback).
- ---
- ## Quick start
- One minimal, working example per platform. The full reference for each is in
- [`llms.txt`](./llms.txt).
- ### Android
- ```kotlin
- // build.gradle.kts
- implementation("io.github.sceneview:sceneview:4.69.7")
- ```
- The app module needs `compileSdk = 37`, `minSdk` 24 or higher, AGP 9.4.0+, Kotlin 2.3 or newer and JVM
- target 21 for both Java and Kotlin: SceneView ships Java 21 bytecode with public `inline`
- functions. The [quickstart requirements](docs/docs/quickstart.md#requirements) give the Gradle
- snippet and the reason for each.
- Stuck on AGP 8 / compileSdk 36 / Kotlin 2.2? Use `4.18.0`, the newest release that builds there.
- ```kotlin
- import androidx.compose.foundation.layout.fillMaxSize
- import androidx.compose.runtime.Composable
- import androidx.compose.ui.Modifier
- import io.github.sceneview.SceneView
- import io.github.sceneview.rememberModelInstance
- @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)
- ```kotlin
- // build.gradle.kts
- implementation("io.github.sceneview:arsceneview:4.69.7") // includes the 3D module
- ```
- ```kotlin
- import androidx.compose.foundation.layout.fillMaxSize
- import androidx.compose.runtime.*
- import androidx.compose.ui.Modifier
- import com.google.ar.core.Anchor
- import com.google.ar.core.Plane
- import io.github.sceneview.ar.ARSceneView
- import io.github.sceneview.ar.arcore.createAnchorOrNull
- import io.github.sceneview.ar.arcore.getUpdatedPlanes
- import io.github.sceneview.rememberModelInstance
- @Composable
- fun ARScreen() {
- var anchor by remember { mutableStateOf<Anchor?>(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`](./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
- `<uses-feature … android:required="false" />`; an AR Required app overrides the ARCore value
- with `tools:replace="android:value"`. Both snippets are in the
- [AR manifest](docs/docs/quickstart.md#ar-manifest) section.
- ### Web
- ```html
- <canvas id="viewer" style="width: 100%; height: 480px"></canvas>
- <script src="https://cdn.jsdelivr.net/gh/sceneview/sceneview@v4.69.7/website-static/js/filament/filament.js"></script>
- <script src="https://cdn.jsdelivr.net/gh/sceneview/sceneview@v4.69.7/website-static/js/sceneview.js"></script>
- <script> SceneView.modelViewer("viewer", "model.glb") </script>
- ```
- ### Compose Multiplatform (Android · iOS · desktop)
- ```kotlin
- // commonMain dependencies
- implementation("io.github.sceneview:sceneview-compose:4.69.7")
- ```
- ```kotlin
- 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/`](sceneview-compose/README.md).
- ### iOS, Flutter and React Native
- SceneView for SwiftUI (`SceneViewSwift`), Flutter (`flutter_sceneview`) and React Native
- (`@sceneview-sdk/react-native`) is deprecated: 4.68.0 is their last release. Published versions stay
- installable and the source stays in this repository — [what that means and the timeline](DEPRECATION.md).
- ### Your AI assistant
- ```bash
- 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](#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.
- | Platform | Status | Install | Open it | Capture |
- |---|---|---|---|---|
- | **Android** | Shipped · Stable | [Maven Central](https://central.sonatype.com/artifact/io.github.sceneview/sceneview) | [Google Play](https://play.google.com/store/apps/details?id=io.github.sceneview.demo) | <img src="website-static/assets/demos/runs-on-android.jpg" alt="SceneView Android demo: Model Viewer rendering a helmet with Filament" height="160"> |
- | **iOS** | Shipped · Alpha | [Swift Package](SceneViewSwift/) | [App Store](https://apps.apple.com/us/app/sceneview-demo-sdk-samples/id6761329763) | <img src="website-static/assets/demos/runs-on-ios.jpg" alt="SceneView iOS demo: Model Viewer rendering a helmet with RealityKit" height="160"> |
- | **Web** | Shipped · Alpha | [npm `sceneview-web`](https://www.npmjs.com/package/sceneview-web) | [Live web demo](https://sceneview.github.io/web-demo/) | <img src="website-static/assets/demos/runs-on-web.jpg" alt="SceneView web demo: Toy Car rendered by Filament.js in a browser" height="100"> |
- *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
- | Platform | Renderer | Framework | Status |
- |---|---|---|---|
- | **Android** | Filament | Jetpack Compose | Stable |
- | **Android TV** | Filament | Compose TV | Alpha |
- | **iOS / macOS / visionOS** | RealityKit | SwiftUI | Deprecated — [4.68.0 is the last release](DEPRECATION.md) |
- | **Web** | Filament.js (WebGL2 / WASM) | JavaScript + Kotlin/JS | Alpha |
- | **Compose Multiplatform** | Filament (Android, desktop) · RealityKit (iOS) | `sceneview-compose` | Alpha — viewer subset |
- | **Desktop (JVM)** | Filament, via filament-kmp | Compose Desktop (`sceneview-compose`) | Alpha |
- | **Flutter** | Native per platform | PlatformView | Deprecated — [4.68.0 is the last release](DEPRECATION.md) |
- | **React Native** | Native per platform | Fabric | Deprecated — [4.68.0 is the last release](DEPRECATION.md) |
- | **AI assistants** | — | `llms.txt`, MCP server, skills | Stable |
- ## Install
- | Platform | Coordinate |
- |---|---|
- | Android 3D | `io.github.sceneview:sceneview:4.69.7` |
- | Android AR | `io.github.sceneview:arsceneview:4.69.7` |
- | Compose Multiplatform | `io.github.sceneview:sceneview-compose:4.69.7` |
- | KMP core only (math, collision, physics) | `io.github.sceneview:sceneview-core:4.69.7` |
- | Apple (SPM) — deprecated | `https://github.com/sceneview/sceneview.git`, exact `4.68.0` |
- | Web, script tag | the two `<script>` tags in [Web](#web) |
- | Web, bundler (Kotlin/JS) | `npm install sceneview-web` — see [SceneView Web](#sceneview-web) |
- | Flutter — deprecated | [`flutter_sceneview`](https://pub.dev/packages/flutter_sceneview) on pub.dev |
- | React Native — deprecated | [`@sceneview-sdk/react-native`](https://www.npmjs.com/package/@sceneview-sdk/react-native) on npm |
- | AI assistants | `npx -y sceneview-mcp` — see [Use with AI](#use-with-ai) |
- ---
- ## Use with AI
- Everything an assistant needs to write SceneView code ships with the SDK:
- - **[`llms.txt`](./llms.txt)** — the complete API reference in one file: composables, every node
- type, threading rules, recipes. Its Kotlin snippets are compiled in CI. Served at
- `https://sceneview.github.io/llms.txt` for tools without MCP support.
- - **Rules files** — `AGENTS.md` (Codex, Cursor, GitHub Copilot, Gemini in Android Studio and
- others), `CLAUDE.md` (Claude Code), `.github/copilot-instructions.md`, and `.cursorrules` for
- older Cursor versions.
- - **The [MCP server](./mcp/)** — free, no API key. The tools assistants reach for most:
- `validate_code` (checks a snippet for known pitfalls and unknown symbols before you run it; it does not check argument names),
- `get_node_reference` (the exact node signature, not an invented one), `list_samples` /
- `get_sample` (38 samples to start from), and `get_setup` / `get_ar_setup` (project wiring).
- ### MCP setup
- ```bash
- claude mcp add sceneview -- npx -y sceneview-mcp # Claude Code
- codex mcp add sceneview -- npx -y sceneview-mcp # Codex
- copilot mcp add sceneview -- npx -y sceneview-mcp # GitHub Copilot CLI
- ```
- ```json
- // Cursor (.cursor/mcp.json), Cline, JetBrains AI Assistant
- { "mcpServers": { "sceneview": { "command": "npx", "args": ["-y", "sceneview-mcp"] } } }
- // VS Code (.vscode/mcp.json) uses the "servers" key instead
- { "servers": { "sceneview": { "type": "stdio", "command": "npx", "args": ["-y", "sceneview-mcp"] } } }
- ```
- Clients that only speak HTTP (Gemini in Android Studio, ChatGPT) use the hosted endpoint
- `https://mcp.sceneview.dev/mcp`, or run their own with `npx sceneview-mcp --http`. Per-client
- snippets: [sceneview.github.io/#ai-setup](https://sceneview.github.io/#ai-setup). Listed on the
- [MCP Registry](https://registry.modelcontextprotocol.io).
- ### ChatGPT / Codex plugin
- This repository is also an OpenAI plugin: `.codex-plugin/plugin.json` points at the three
- skills under [`agents/`](agents/) (`sceneview`, `sceneview-ios`, `sceneview-web`). From a
- checkout:
- ```bash
- codex plugin marketplace add "$PWD" # absolute path — a relative one does not resolve
- codex plugin add sceneview@sceneview-local
- ```
- Codex also discovers the skills from `.agents/skills/` on its own. Over HTTP the MCP server
- carries an inline `view_3d_model` widget that renders a public GLB/glTF URL in the
- conversation. Listing copy and test prompts: [agents/OPENAI-PLUGIN.md](agents/OPENAI-PLUGIN.md).
- ### Claude Code plugin
- `/plugin marketplace add sceneview/claude-marketplace`, then `/plugin install sceneview@sceneview`,
- installs the same three skills as the Codex plugin together with the MCP server. The commands used
- to work on this repository are a separate plugin, `sceneview-contrib@sceneview` — see
- [sceneview/claude-marketplace](https://github.com/sceneview/claude-marketplace).
- Vertical MCP servers (Rerun AR debugging and others) are listed in the [MCP README](./mcp/README.md).
- ---
- ## Android in depth
- ### 3D scene
- `SceneView` is a composable that renders a Filament viewport. Nodes are composables inside it.
- ```kotlin
- val engine = rememberEngine()
- val modelLoader = rememberModelLoader(engine)
- val environmentLoader = rememberEnvironmentLoader(engine)
- SceneView(
- modifier = Modifier.fillMaxSize(),
- engine = engine,
- modelLoader = modelLoader,
- environment = rememberEnvironment(environmentLoader) {
- environmentLoader.createHDREnvironment("envs/studio.hdr")
- ?: createEnvironment(environmentLoader)
- },
- cameraManipulator = rememberCameraManipulator()
- ) {
- // Model — async loaded, appears when ready
- rememberModelInstance(modelLoader, "models/helmet.glb")?.let {
- ModelNode(modelInstance = it, scaleToUnits = 1.0f, autoAnimate = true)
- }
- // Geometry — procedural shapes
- CubeNode(size = Size(0.2f))
- SphereNode(radius = 0.1f, position = Position(x = 0.5f))
- // Nesting — same as Column { Row { } }
- Node(position = Position(y = 1.0f)) {
- LightNode(type = LightManager.Type.POINT, apply = { intensity(50_000f) })
- CubeNode(size = Size(0.05f))
- }
- }
- ```
- ### Node composables — 27 in 3D, 15 more in AR
- | Category | Nodes | What they do |
- |---|---|---|
- | **Models** | `ModelNode` | glTF/GLB with skeletal/morph animations. `isEditable = true` for gestures. |
- | **Primitives** | `CubeNode` · `SphereNode` · `CylinderNode` · `ConeNode` · `TorusNode` · `CapsuleNode` · `TubeNode` · `PlaneNode` | Procedural geometry, parametric size/segments |
- | **Curves & shapes** | `LineNode` · `PathNode` · `ShapeNode` | Single segments, polylines, extruded 2D polygons |
- | **Custom geometry** | `MeshNode` | Your own Filament `VertexBuffer` / `IndexBuffer` |
- | **Surfaces** | `ImageNode` · `VideoNode` · `BillboardNode` | PNG/JPG plane, video plane (MediaPlayer), camera-facing sprite |
- | **3D text** | `TextNode` | World-space text label that always faces the camera |
- | **Compose-in-3D** | `ViewNode` | Any Compose UI rendered as a 3D surface, fully touch-interactive |
- | **Gaussian splats** | `SplatNode` | Render a Gaussian-splat capture |
- | **Lighting & sky** | `LightNode` · `ReflectionProbeNode` · `DynamicSkyNode` · `FogNode` | Sun/dir/point/spot lights, local IBL, time-of-day sky, atmospheric fog |
- | **Physics** | `PhysicsNode` | Simple rigid-body simulation (gravity, collisions) |
- | **Cameras** | `CameraNode` · `SecondaryCamera` | Main and picture-in-picture cameras |
- | **Group** | `Node` | Empty pivot for nesting and transform inheritance |
- ### AR scene
- `ARSceneView` is `SceneView` with ARCore: the camera follows real-world tracking. See the
- [AR quick start](#ar-android) above.
- | Node | What it does |
- |---|---|
- | `AnchorNode` | Pin a node to a real-world ARCore `Anchor` |
- | `HitResultNode` · `DepthHitResultNode` | Live surface cursor from each frame's hit-test (planes or depth) |
- | `PoseNode` | Position a node at any ARCore `Pose` |
- | `PlaneNode` · `ReticleNode` | Render a detected plane, or a placement reticle |
- | `PointCloudNode` · `DepthMeshNode` · `SceneMeshNode` | Feature points, depth mesh, classified geospatial scene mesh |
- | `AugmentedImageNode` | Image tracking — pose + 2D extent of a detected image |
- | `AugmentedFaceNode` | Face mesh overlay (front camera) |
- | `CloudAnchorNode` | Persistent cross-device anchor (host + resolve) |
- | `StreetscapeGeometryNode` | **Geospatial** — semantic city mesh (buildings, terrain) |
- | `TerrainAnchorNode` | **Geospatial** — anchor pinned to ground at a lat/lng |
- | `RooftopAnchorNode` | **Geospatial** — anchor pinned to a building rooftop |
- | Feature | API surface |
- |---|---|
- | **Automatic placement** | `AutoPlacementScene` + `AutoPlacementModel` — grounded, gesture-ready, no tap |
- | **Plane / depth / instant placement** | `ARSceneView(planeRenderer = …, depthMode = …, instantPlacementMode = …)` |
- | **Geospatial (VPS)** | `Streetscape` + `Terrain` + `Rooftop` anchors via `Earth` session |
- | **Cloud Anchors** | `CloudAnchorNode.host(ttlDays = N)` + `.resolve(id)` |
- | **Augmented Faces & Images** | `AugmentedFaceNode`, `AugmentedImageDatabase`, runtime image add |
- | **Image Stabilization (EIS)** | `ARSceneView(imageStabilizationMode = ImageStabilizationMode.EIS)` |
- | **Camera exposure & focus** | `ARSceneView(sessionCameraConfig = …, focusMode = …, cameraExposure = …)` |
- | **Record & Replay** | `rememberARRecorder()` to capture, `ARSceneView(playbackDataset = file)` to replay 1:1 — see [AR debugging](#ar-debugging) |
- | **Rerun.io live debug** | `rememberRerunBridge()` streams poses, planes and point clouds to the Rerun viewer |
- | **Permission flow** | `ARPermissionHandler` — auto-detected from `ComponentActivity` |
- ### Capabilities
- | Capability | What it gives you | Where it lives |
- |---|---|---|
- | **Gestures** | Drag, pinch-to-scale, two-finger rotate, elevate, tap. Per-node opt-in via `isEditable`. | `NodeGestureDelegate`, `OnGestureListener` |
- | **Animations** | Skeletal/morph from glTF, plus per-node spring/property/smooth-transform. | `ModelNode.playAnimation()`, `NodeAnimationDelegate` |
- | **Physics** | Rigid-body dynamics — gravity, collisions, impulses. Pure Kotlin Multiplatform, no JNI. | `PhysicsNode`, `sceneview-core` |
- | **Collision & raycasting** | Ray vs box / sphere intersections, hit-testing, frustum culling. | `CollisionSystem`, `Ray`, `Box`, `Sphere` |
- | **Procedural geometry** | Cube/sphere/cylinder/cone/torus/capsule generators, extrusion from 2D shapes (Earcut + Delaunator). | `sceneview-core` geometry + triangulation |
- | **HDR environment** | IBL lighting + skybox from `.hdr` / `.ktx`. Async load + reactive swap. | `EnvironmentLoader`, `rememberEnvironment` |
- | **Custom materials** | Filament `.filamat` materials with parameters, plus built-in unlit / lit / overlay variants. | `MaterialLoader` |
- | **Post-processing** | Bloom, depth of field, SSAO, vignette, color grading, tone mapping. | `View.bloomOptions`, `dynamicResolutionOptions`, … |
- | **Compose UI in 3D** | Any `@Composable` as a textured plane in world space. Touches are forwarded, so `Button.onClick`, ripples and inner scrolling work. | `ViewNode` + `ViewNode.WindowManager` |
- | **Multiple cameras** | Picture-in-picture, mini-map, security-camera views. | `SecondaryCamera` |
- | **Reactive scene graph** | Change state → the tree updates. No imperative `parent.addChild()`. | `SceneScope` / `ARSceneScope` DSL |
- ---
- ## Model formats
- | Format | Android | Apple | Web |
- |---|---|---|---|
- | glTF / GLB | ✅ | — convert to USDZ (`tools/convert-usdz.sh`) | ✅ |
- | USDZ / Reality / USD | — | ✅ RealityKit | — |
- | STL (binary + ASCII) | ✅ converted to GLB in memory | ✅ ModelIO, millimetres by default | — |
- | OBJ + MTL | ✅ converted to GLB, material colours | ✅ ModelIO | — |
- | PLY (binary + ASCII) | ✅ converted to GLB, vertex colours | ✅ ModelIO, vertex colours | — |
- | 3MF | ✅ converted to GLB, declared units honoured | ✅ SceneViewSwift parser, declared units honoured | — |
- There is no per-format API on Android: `rememberModelInstance(modelLoader, path)` accepts all of
- them. On Apple, RealityKit reads no glTF, so `.gltf` / `.glb` are deliberately not in
- `ModelFormat`; USD/Reality load through RealityKit and the mesh formats through `MeshAsset`. The format is decided by the file's bytes, not its extension, so a file shared into your
- app as `application/octet-stream` with no name still opens. The converters are dependency-free
- Kotlin in `sceneview-core`. Tracked next:
- [one `ModelFormat` entry point](https://github.com/sceneview/sceneview/issues/3489) and
- [every format on the web](https://github.com/sceneview/sceneview/issues/3491). Details:
- [Model formats](https://sceneview.github.io/docs/formats/).
- ---
- ## Apple (iOS / macOS / visionOS)
- Native Swift Package built on RealityKit, with a node set mirroring the Android API. Content you
- can build synchronously uses the `@NodeBuilder` form:
- ```swift
- SceneView {
- GeometryNode.cube(size: 0.1, color: .blue)
- .position(.init(x: 0.5, y: 0, z: 0))
- LightNode.directional(intensity: 1000)
- }
- .environment(.studio)
- .cameraControls(.orbit)
- ```
- AR on iOS — tap a detected plane to place content:
- ```swift
- ARSceneView(
- planeDetection: .horizontal,
- onTapOnPlane: { position, arView in
- let anchor = AnchorNode.world(position: position)
- anchor.add(GeometryNode.cube(size: 0.1, color: .blue).entity)
- arView.scene.addAnchor(anchor.entity)
- }
- )
- ```
- **Nodes** — `ModelNode` · `GeometryNode` (cube/sphere/cylinder/cone/torus/capsule/plane) ·
- `LightNode` · `ImageNode` · `VideoNode` · `TextNode` · `ViewNode` · `BillboardNode` · `MeshNode` ·
- `LineNode` · `PathNode` · `ShapeNode` · `PhysicsNode` · `ReflectionProbeNode` · `DynamicSkyNode` ·
- `FogNode` · `CameraNode` · `AnchorNode` · `AugmentedImageNode` · `SceneReconstructionNode`
- (visionOS scene mesh). Plus an iOS `RerunBridge` with the same wire format as Android.
- Full guide: [SceneViewSwift/README.md](SceneViewSwift/README.md).
- ---
- ## SceneView Web
- Two `<script>` tags and one call (see [Web](#web) above). The wrapper is ~24 KB gzipped; the
- engine it drives is Filament — the same renderer as Android SceneView — compiled to WebAssembly
- (~2.3 MB gzipped).
- **JavaScript API (script tag):**
- - `SceneView.modelViewer(canvasOrId, url, options?)` — all-in-one viewer with orbit + auto-rotate
- - `SceneView.create(canvasOrId, options?)` — empty viewer, load a model later
- - `viewer.loadModel(url)` — load or replace a glTF/GLB model
- - `viewer.setAutoRotate(enabled)` — toggle rotation
- - `viewer.dispose()` — release resources
- **Kotlin/JS (`sceneview-web`, npm only)** — the power-user API: `OrbitCameraController`, the
- geometry DSL, reactive node updates, and **WebXR** through `ARSceneView` (`immersive-ar`,
- hit-test, anchors, light estimation), `VRSceneView` (`immersive-vr`, controllers) and the
- low-level `WebXRSession`. The module builds a webpack bundle, so it has no Maven coordinate:
- ```bash
- npm install sceneview-web
- ```
- The package expects a `Filament` global and does not include the `SceneView.modelViewer` script
- helpers. A Kotlin Multiplatform project that only needs the shared core (collision, math,
- geometry, animation, physics — no renderer) uses
- `implementation("io.github.sceneview:sceneview-core-js:4.69.7")`.
- [Landing page](https://sceneview.github.io/) · [Web demo](https://sceneview.github.io/web-demo/) · [npm](https://www.npmjs.com/package/sceneview-web)
- ---
- ## The Compose-native successor to Sceneform
- Google [archived Sceneform](https://github.com/google-ar/sceneform-android-sdk) in 2021 and ships
- no first-party declarative AR renderer. SceneView descends from the maintained Sceneform
- community fork: ARCore for perception, Filament for rendering, Jetpack Compose for the API, and
- glTF (`.glb` / `.gltf`) instead of the deprecated `.sfb` format.
- Coming from Sceneform? The [migration guide](https://sceneview.github.io/docs/migration/) maps it
- concept by concept (`ArFragment` → `ARSceneView { }`, `ModelRenderable` →
- `rememberModelInstance`, and so on).
- ---
- ## AR debugging
- - **Record & Replay** — capture an ARCore session once with `rememberARRecorder()`, replay it 1:1
- at your desk with `ARSceneView(playbackDataset = file)`. See
- [`docs/docs/ar-recording.md`](docs/docs/ar-recording.md) and the
- [Record & Playback demo](samples/android-demo/RECORDING_PLAYBACK.md).
- - **Hosted Rerun viewer** — export a scan's **Rerun recording** from the 3D Scan demo, host the `.rrd` file at
- an https address that ends in `.rrd`, and open
- `https://sceneview.github.io/rerun/?url=<encoded-url>` to scrub the session frame by frame in a
- browser, with no local install. The host has to allow cross-origin requests (CORS): a public
- GitHub repository's `raw.githubusercontent.com` link and GitHub Pages do, a GitHub release
- asset does not (checked 2026-10-13); an R2 or S3 bucket does with a CORS rule that allows
- `https://sceneview.github.io`. Architecture and the Kotlin API
- (`RerunBridge.requestSaveAndShare`) are in the *AR Debug — Rerun.io* section of
- [`llms.txt`](./llms.txt).
- ---
- ## Architecture
- Each platform uses its **native renderer**. Shared logic lives in Kotlin Multiplatform.
- ```
- sceneview-core (Kotlin Multiplatform)
- ├── math, collision, geometry, physics, animation, model-format converters
- │
- ├── sceneview (Android) → Filament + Jetpack Compose
- ├── arsceneview (Android) → ARCore
- ├── sceneview-compose (KMP) → one SceneViewer for Android, iOS and desktop
- ├── SceneViewSwift (Apple) → RealityKit + SwiftUI
- ├── sceneview-web (Web) → Filament.js + WebXR
- └── flutter/ · react-native/ → bridges to the native views
- ```
- ## Samples
- | Sample | Platform | Run |
- |---|---|---|
- | `samples/android-demo` | Android — 3D & AR | `./gradlew :samples:android-demo:assembleDebug` |
- | `samples/android-tv-demo` | Android TV | `./gradlew :samples:android-tv-demo:assembleDebug` |
- | `samples/ios-demo` | iOS — 3D & AR | Open in Xcode |
- | `samples/web-demo` | Web | `cd samples/web-demo && cp ../../website-static/js/sceneview.js site/js/sceneview.js && npx http-server site -p 8080` |
- | `samples/desktop-demo` | Desktop (JDK 21+) | `./gradlew :samples:desktop-demo:run` |
- | `samples/flutter-demo` | Flutter | `cd samples/flutter-demo && flutter run` |
- | `samples/react-native-demo` | React Native | See its README |
- ## Used in
- In Google Play apps (checked in their published builds: the Volkswagen Group and Philips Hue apps on
- November 17, 2026, Medal and IKEA on November 9, 2026):
- - **[Volkswagen](https://www.volkswagen.com/)** — [Volkswagen](https://play.google.com/store/apps/details?id=com.volkswagen.weconnect).
- - **[Audi](https://www.audi.com/)** — [myAudi](https://play.google.com/store/apps/details?id=de.myaudi.mobile.assistant).
- - **[Porsche](https://www.porsche.com/)** — [My Porsche](https://play.google.com/store/apps/details?id=de.porsche.one).
- - **[CUPRA](https://www.cupra.com/)** — [My CUPRA](https://play.google.com/store/apps/details?id=com.cupra.mycupra).
- - **[Philips Hue](https://www.philips-hue.com/)** — [Philips Hue](https://play.google.com/store/apps/details?id=com.philips.lighting.hue2): ships SceneView's AR module (`ARSceneView`).
- - **[Medal](https://medal.tv/)** — [Medal](https://play.google.com/store/apps/details?id=tv.medal.recorder).
- - **[IKEA](https://www.ikea.com/)** — [IKEA](https://play.google.com/store/apps/details?id=com.ingka.ikea.app).
- Declared in their public source code or published build files (checked November 17, 2026):
- - **[Meshtastic](https://github.com/meshtastic/Meshtastic-Android/blob/main/feature/node/build.gradle.kts)**: the Android app's 3D and AR device viewer (SceneView 4.69.5).
- - **[Bitkey by Block](https://github.com/proto-at-block/bitkey/blob/main/app/gradle/libs.versions.toml)**: 3D rendering of the hardware wallet in the Android app (SceneView 2.3.0).
- - **[Vocable AAC by WillowTree](https://github.com/willowtreeapps/vocable-android/blob/main/gradle/libs.versions.toml)**: head tracking for hands-free communication (ARSceneView 2.3.3).
- - **[Niantic Spatial](https://github.com/nianticspatial/nsdk-samples-kotlin/blob/main/NsdkSamples/NsdkSamples/build.gradle.kts)**: the Kotlin samples of its spatial SDK (ARSceneView 2.3.1).
- - **[GeneXus](https://central.sonatype.com/artifact/com.genexus.android/AugmentedReality)**: its Android augmented reality module, in the Maven Central POM (SceneView 2.3.0).
- - **[TruVideo](https://central.sonatype.com/artifact/com.truvideo.com/sdk-camera)**: its camera SDK, in the Maven Central POM (ARSceneView 2.3.0).
- ## Built with SceneView
- - **[3D AR Model Viewer](https://play.google.com/store/apps/details?id=com.gorisse.thomas.arcamera)** —
- open a 3D file from any app or link (GLB, glTF, STL, OBJ, PLY, 3MF) and see it in your room at
- real size.
- - **[Will It Fit](https://play.google.com/store/apps/details?id=com.gorisse.thomas.willitfit)** —
- enter a piece of furniture's dimensions and see whether it fits before you buy.
- ---
- ## Maintainer
- [Thomas Gorisse](https://github.com/ThomasGorisse) — Mobile SDKs and the AI agent pipeline behind them · Creator of SceneView, open-source 3D & AR
- ## Links
- - [Website](https://sceneview.github.io/) · [Web demo](https://sceneview.github.io/web-demo/) · [Documentation](https://sceneview.github.io/docs/)
- - [Discord](https://discord.gg/UbNDDBTNqb) · [Contributing](CONTRIBUTING.md) · [Changelog](CHANGELOG.md) · [Migration v2 → v3](MIGRATION.md)
- ## Sponsors
- <!-- Same message as the website home page (#fund) and companies.html#sponsor: edit the three together.
- Generic on purpose: no company is named. Open Collective first, GitHub Sponsors second, nothing else. -->
- ### SceneView runs in commercial products. Sponsor it.
- Commercial products ship SceneView. Almost nobody contributes back, in code or in funding, while the maintainers carry every fix and every release. If SceneView is part of your product, **sponsor it.**
- **Sponsor.** Funds the fixes, Filament upgrades and releases your product depends on. Open Source Collective issues the invoice and the receipt; your company is listed nowhere unless you ask.
- **[Sponsor on Open Collective](https://opencollective.com/sceneview)** · or through [GitHub Sponsors](https://github.com/sponsors/sceneview)
- Questions about SceneView in your product: [hello@sceneview.dev](mailto:hello@sceneview.dev).
- <a href="https://opencollective.com/sceneview"><img src="https://opencollective.com/sceneview/organizations.svg?avatarHeight=56&width=830" alt="Logos of the companies sponsoring SceneView on Open Collective"></a>
- <a href="https://opencollective.com/sceneview"><img src="https://opencollective.com/sceneview/individuals.svg?avatarHeight=40&width=830&button=false" alt="Avatars of the people backing SceneView on Open Collective"></a>
- [How sponsorship works](.github/SPONSORS.md)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.