The Immersive Web SDK makes building immersive web experiences as approachable as traditional web development. It’s a complete collection of frameworks and tools built on Three.js with a high-performance Entity Component System, developer-first workflow with one-command setup and built-in emulation, and production-ready systems for grab interactions, locomotion, spatial audio, physics, and scene understanding.
Same code, two experiences: Run immersively in VR/AR headsets and automatically provide mouse-and-keyboard emulation on desktop browsers. No browser extensions, no special setup—anyone with a laptop can develop for the immersive web.
# Install dependencies
pnpm install
# Build all packages as tgz files (for examples to consume)
npm run build:tgz
# Run an example (fresh install from local tgz packages)
cd examples/locomotion && npm run fresh:dev
# Lint and format
pnpm run lint
pnpm run format
# Build a specific package
pnpm --filter @iwsdk/core build
Development Workflow
The examples use file: dependencies pointing to .tgz files built from local packages. This simulates how end-users will consume the packages from npm.
npm run build:tgz - Builds all packages in dependency order and creates .tgz archives
npm run fresh:dev (in example) - Cleans node_modules, reinstalls from tgz files, and starts dev server
This ensures examples always test against the latest local build.
License
IWSDK is licensed under the MIT License. See the LICENSE file for details.
Immersive Web SDK
Where every webpage can become a world.
The Immersive Web SDK makes building immersive web experiences as approachable as traditional web development. It’s a complete collection of frameworks and tools built on Three.js with a high-performance Entity Component System, developer-first workflow with one-command setup and built-in emulation, and production-ready systems for grab interactions, locomotion, spatial audio, physics, and scene understanding.
Same code, two experiences: Run immersively in VR/AR headsets and automatically provide mouse-and-keyboard emulation on desktop browsers. No browser extensions, no special setup—anyone with a laptop can develop for the immersive web.
Getting Started
Create a new project with a single command:
Or install into an existing project:
Documentation
For guides, concepts, and API reference, visit: https://iwsdk.dev
Packages
Internal Packages
Development
Development Workflow
The examples use
file:dependencies pointing to.tgzfiles built from local packages. This simulates how end-users will consume the packages from npm.npm run build:tgz- Builds all packages in dependency order and creates.tgzarchivesnpm run fresh:dev(in example) - Cleansnode_modules, reinstalls from tgz files, and starts dev serverThis ensures examples always test against the latest local build.
License
IWSDK is licensed under the MIT License. See the LICENSE file for details.
Contributing
Contributions are welcome! Please review our Contributing Guidelines and Code of Conduct before submitting issues or pull requests.
Developer Terms