three.js and the Live Office
three.js is the WebGL library behind the Live Office, an optional full-screen 3D view of a business's Employees at work. It is vendored at release r169 and loaded only when someone opens the Live Office. Nothing in the scene decides what anyone is doing. Poses come from work records, and a stale feed stops the animation rather than inventing activity.
What it is#
three.js is an open-source JavaScript 3D library started by Ricardo Cabello (mrdoob) in 2010. It wraps WebGL with scenes, cameras, meshes, materials, lights and loaders.
Connect vendors release r169 (0.169.0) as published, because it ships as one module with no imports. Later releases split the build. A few post-processing add-ons for ambient occlusion come from the same package.
- Category
- 3D graphics (WebGL)
- Version
- r169 (0.169.0), vendored with sha256
- Files
webapp/vendor/three/three.module.min.js,webapp/vendor/three/addons/- Official site
- threejs.org
Where Connect uses it#
| Place in Connect | What it does there |
|---|---|
webapp/src/features/office/ | scene.js, environment.js, camera.js, people.js: the Live Office |
office/model.js | Turns work items into poses; a stale feed stops them |
webapp/office/ASSETS.md | The 3D assets and their CC0 provenance |
How it connects#
- A person switches to Live Office (Alt+Shift+O)
- The office modules and three.js load on demand
- The feed delivers work items and presence from the server
model.jsmaps them to poses; nothing is invented- three.js renders the floor, or the floor-plan or list view on weaker devices
Benefits and limits#
What it gives Connect:
- A legible picture of who is doing what, built from the same records as the Classic view.
- Lazy loading keeps its weight off every other screen.
- A floor-plan and list presentation of the same data for devices or people who do not want 3D.
Where it stops, and what Connect does about it:
- WebGL needs a capable GPU. Low-end phones use the lighter views.
- 3D is not accessible on its own. The list view carries the same information for assistive technology.
- Pinned at r169. An upgrade means re-vendoring and re-checking the add-ons.
Security and privacy#
- The scene shows only what the person's session may read. It is a view of server data.
- The vendored files are checksummed and unmodified, with the upstream licence file kept beside them.
- Assets are CC0 with recorded provenance.
Licence, cost and versions#
| Question | Answer |
|---|---|
| Licence | MIT (webapp/vendor/three/LICENSE) |
| Cost | None |
| Version | r169 (0.169.0) |
| Compatibility | WebGL 2 in current browsers |
Troubleshooting#
- Live Office is blank
- WebGL is unavailable or blocked. Switch to the floor-plan or list view.
- Everyone stands still
- The feed is stale, which is intended: presence becomes Unknown rather than 'On task'.
- Slow on a laptop
- Lower the quality setting, or use the floor-plan view.
Official references#
Questions#
Does the Live Office show what people are really doing?
It shows what the records say: work items and presence with freshness. If the feed is stale it says so instead of animating.
Is the 3D view required?
No. Classic or Live Office is a per-person, per-device choice, and both read the same backend.