illutions
v0.22.1
Published
A TypeScript framework for interactive 3D web applications with Three.js, WebGL/WebGPU, XState, advanced post-processing and animation workflows.
Downloads
720
Maintainers
Readme
illutions
illutions is a proprietary Web 3D engine for building interactive browser-based 3D applications with Three.js, XState, GSAP, Tweakpane and more.
Highlights
Advanced post-processing
Add SSAO, SSR, FXAA and SMAA through configurable pipelines for WebGL and WebGPU.
Advanced animation control
Coordinate GLTF animation clips, GSAP transitions, camera paths and custom dolly-rig camera workflows.
XState-powered application logic
Model complex application flows as predictable and inspectable state machines with integrated XState 5 usage.
Resource-aware rendering
An intelligent, configurable FPS limiter avoids unnecessary frames and helps reduce CPU and GPU load.
WebGL and WebGPU rendering
Support established and next-generation browser rendering with automatic WebGPU selection and WebGL fallback.
Lean initial bundles
Optional controls, loaders, inspectors and effects are dynamically imported only when needed.
Optimized GLTF/GLB pipeline
Load assets with Draco or Meshopt mesh compression and WebP or KTX2 textures.
Built-in interaction and audio
Use pointer-based raycasting and distance-aware spatial audio.
Flexible environments
Load HDR, EXR and texture environments with configurable rotation, intensity and background controls.
Runtime insights and debugging
Inspect runtime properties, FPS, CPU and renderer statistics with detailed state, event and console reporting.
Installation
The recommended starting point is an illutions project template. The template
includes a package.json with all dependencies required by the application, so
setup is usually just:
Project templates for customers are available on GitHub.
npm installFor a manual setup, install illutions together with its peer dependencies:
npm install illutions three xstatethree and xstate are peer dependencies and must be installed by the
application that uses illutions.
Usage
import { App, cfg } from 'illutions';
await App.run(cfg);License
illutions is not open source software. It may be used only under the terms granted by illutions.
A valid license.json permits commercial and non-commercial use without
requiring the illutions menu bar or attribution to remain visible.
For the 2026 introductory period, the official GitHub project templates include
a free license.json valid through December 31, 2026.
See the included LICENSE file for the legal rights and restrictions.
Templates, documentation, and support links are provided through the illutions website as they become available.
Website: https://illutions.com
