How akbarsheikh-debug/wondersnap works
WonderSnap is a browser-based, gesture-controlled 3D particle model viewer. The main workflow is webcam hand landmarks → gesture/state interpretation → model selection and point-cloud construction → GPU animation and rendering. The app also supports keyboard/mouse input, model-part selection and exploded views, quiz and cut-away modes, voice commands, and video recording. The source excerpts show the main orchestration and several module dependencies; README statements support additional capabilities whose internal wiring was not sampled.
Main entry points: catalog.js Model catalog · app.js App orchestration · sampling.js Point sampling · renderer.js WebGL renderer
Components 25
Input and interaction
- Hand tracking
src/hands.js - Gesture classifiers
src/logic/gestures.js - Gesture controller
src/logic/controller.js - Viewer state
src/logic/state.js - App orchestration
src/app.js
Procedural models
- Model catalog
src/models/catalog.js - Wonders
src/models/wonders.js - Anatomy
src/models/anatomy.js - More anatomy
src/models/anatomy2.js - Human body
src/models/body.js - Biology
src/models/biology.js - Engines
src/models/engines.js - Vehicles
src/models/vehicles.js - Machines
src/models/machines.js - Point sampling
src/lib/sampling.js - Shape helpers
src/lib/shapes.js - Vector math
src/lib/vec.js - Deterministic RNG
src/lib/rng.js
Particle rendering
- WebGL renderer
src/gl/renderer.js - GPU shaders
src/gl/shaders.js - Particle seeds
src/logic/simRef.js
Viewer features
- Voice and recording
src/features.js
Other components
- Viewer
- Webcam
- MediaPipe runtime
Connections 27
- Viewer → App orchestration: controls viewer
README.md - Webcam → Hand tracking: provides video
README.md - MediaPipe runtime → Hand tracking: tracks landmarks
README.md - Hand tracking → App orchestration: supplies hands
src/app.js - App orchestration → Gesture controller: processes input
src/app.js - Gesture controller → Gesture classifiers: classifies poses
src/logic/controller.js - Gesture controller → Viewer state: updates state
src/logic/controller.js - App orchestration → Model catalog: builds models
src/app.js - Model catalog → Wonders: uses definitions
src/models/catalog.js - Model catalog → Anatomy: uses definitions
src/models/catalog.js - Model catalog → More anatomy: uses definitions
src/models/catalog.js - Model catalog → Human body: uses definitions
src/models/catalog.js - Model catalog → Biology: uses definitions
src/models/catalog.js - Model catalog → Engines: uses definitions
src/models/catalog.js - Model catalog → Vehicles: uses definitions
src/models/catalog.js - Model catalog → Machines: uses definitions
src/models/catalog.js - Model catalog → Point sampling: samples parts
src/models/catalog.js - Point sampling → Deterministic RNG: uses randomness
src/lib/sampling.js - Point sampling → Vector math: uses vector math
src/lib/sampling.js - Shape helpers → Point sampling: builds primitives
src/lib/shapes.js - Shape helpers → Vector math: uses vector math
src/lib/shapes.js - App orchestration → WebGL renderer: creates renderer
src/app.js - WebGL renderer → GPU shaders: runs shaders
src/gl/renderer.js - WebGL renderer → Particle seeds: creates particle seeds
src/gl/renderer.js - App orchestration → Voice and recording: parses voice commands
src/app.js - App orchestration → Voice and recording: supports voice and recording
README.md - App orchestration → WebGL renderer: renders interactive scene
README.md