System architecture

Model Lab is organized as a monorepo with a reusable package and several applications.

text

apps/
  docs/             VitePress documentation and live examples
  playground/       full editor playground
  galaxy-showcase/  cinematic production demo
packages/
  model-lab/        publishable library

Runtime layers

Loading

GLTFLoader, Draco, Meshopt, local bundle resolution, cloning, disposal.

Scene state

Typed configuration for camera, pivot, transforms, environment, lights, animation, and diagnostics.

Authoring

Editor panels, scene tree, transform controls, sequence timeline, export and import.

Playback

Snapshot interpolation, camera/target application, model root motion, material effects.

Data flow

text

Local files → ModelLabEditor → ViewerExportPayload JSON
                                  ↓
Deployed model URL → ModelLabViewer + preset → WebGL scene
                                  ↓
Existing custom Canvas → headless utilities → same authored behavior

Phase 0 architectural reset

The platform refactor is specified in the repository-level Phase 0 Engineering Plan, including RFCs, package boundaries, migration milestones, acceptance gates, and risk controls.

System architecture ​

Runtime layers ​