Web Quickstart¶

SceneView Web uses Filament.js — the same Filament rendering engine as SceneView Android, compiled to WebAssembly for browsers (WebGL2).

Install¶

npm install @sceneview/sceneview-web

Or use the Kotlin/JS module directly in your Gradle project:

// build.gradle.kts
kotlin {
    js(IR) { browser() }
    sourceSets {
        jsMain.dependencies {
            implementation(project(":sceneview-web"))
        }
    }
}

Minimal Example¶

HTML¶

<!DOCTYPE html>
<html>
<head><title>SceneView Web</title></head>
<body>
    <canvas id="scene-canvas" style="width:100%;height:100vh"></canvas>
    <script src="your-app.js"></script>
</body>
</html>

Kotlin/JS¶

import io.github.sceneview.web.SceneView
import kotlinx.browser.document
import org.w3c.dom.HTMLCanvasElement

fun main() {
    val canvas = document.getElementById("scene-canvas") as HTMLCanvasElement
    canvas.width = canvas.clientWidth
    canvas.height = canvas.clientHeight

    SceneView.create(
        canvas = canvas,
        configure = {
            camera {
                eye(0.0, 1.5, 5.0)
                target(0.0, 0.0, 0.0)
                fov(45.0)
            }
            light {
                directional()
                intensity(100_000.0)
            }
            model("models/DamagedHelmet.glb")
        },
        onReady = { sceneView ->
            sceneView.startRendering()
        }
    )
}

API Overview¶

Class	Purpose
`SceneView`	Main entry — `create(canvas, configure, onReady)`
`SceneViewBuilder`	DSL: `camera {}`, `light {}`, `model()`, `environment()`
`CameraConfig`	Position, FOV, clip planes, exposure
`LightConfig`	Type (directional/point/spot), intensity, color
`ModelConfig`	URL, scale, animation

Environment Lighting¶

environment(
    iblUrl = "environments/pillars_2k_ibl.ktx",
    skyboxUrl = "environments/pillars_2k_skybox.ktx"
)

Limitations¶

No AR — requires native sensors (camera, compass, accelerometer)
WebGL2 required — ~95% of browsers support it
glTF 2.0 / GLB only — same format as Android
Cross-origin — assets need CORS headers if hosted on a different domain