How praveenkumar0031/3d-voxel-builder works
GesticStudio is a gesture-controlled, browser-based 3D voxel builder. Its main workflow is webcam hand tracking → gesture recognition and orbital-menu selection → SceneEngine voxel/scene operations, with authenticated scene saving and retrieval alongside account, dashboard, and history flows. The graph preserves documented effects and scene-management capabilities. Some connections are supported by README descriptions where implementation excerpts were unavailable; those evidence limits are noted by using the README only for documented relationships.
Main entry points: useGestureStateMachine.js Gesture state machine · useVoxelArchitect.js Builder lifecycle · server.js Express API server · scenes.js Scene routes
Components 28
Gesture interaction
- Camera source
frontend/src/engine/cameraSource.js - Gesture state machine
frontend/src/hooks/useGestureStateMachine.js - Gesture predicates
frontend/src/utils/gestures.js - Tracking overlay
frontend/src/engine/overlayRenderer.js - UI event bus
frontend/src/utils/eventBus.js - Menu state sync
frontend/src/utils/orbitalMenuSync.js
Voxel builder
- Builder lifecycle
frontend/src/hooks/useVoxelArchitect.js - 3D scene engine
frontend/src/engine/SceneEngine.js - World and grid math
frontend/src/utils/math.js
Application UI
- Builder page
frontend/src/pages/BuilderPage.jsx - Orbital tool ring
frontend/src/components/OrbitalMenu/OrbitalMenu.jsx - Scene dashboard
frontend/src/pages/Dashboard.jsx - Scene history
frontend/src/pages/HistoryPage.jsx - Public gallery
frontend/src/pages/LandingPage.jsx
Accounts and scenes
- Authentication state
frontend/src/context/AuthContext.jsx - Auth client
frontend/src/api/authApi.js - HTTP client
frontend/src/api/axios.js - Scene client
frontend/src/api/scenesApi.js
API and persistence
- Express API server
backend/server.js - Account routes
backend/routes/auth.js - Scene routes
backend/routes/scenes.js - JWT authorization
backend/middleware/auth.js - User records
backend/models/User.js - Scene records
backend/models/Scene.js - MongoDB connection
backend/config/db.js
Other components
- Builder user
- Webcam tracking
- MongoDB
Connections 34
- Builder user → Webcam tracking: provides hand motion
- Webcam tracking → Camera source: supplies video
- Builder page → Builder lifecycle: starts builder
- Builder lifecycle → Camera source: selects tracking source
frontend/src/hooks/useVoxelArchitect.js - Builder lifecycle → Gesture state machine: sets up gesture control
frontend/src/hooks/useVoxelArchitect.js - Builder lifecycle → 3D scene engine: creates scene engine
frontend/src/hooks/useVoxelArchitect.js - Gesture state machine → Gesture predicates: tests hand poses
frontend/src/hooks/useGestureStateMachine.js - Gesture state machine → Tracking overlay: draws tracking cues
frontend/src/hooks/useGestureStateMachine.js - Gesture state machine → 3D scene engine: dispatches scene operations
- Gesture state machine → UI event bus: publishes menu events
frontend/src/hooks/useGestureStateMachine.js - Gesture state machine → Menu state sync: updates menu state
frontend/src/hooks/useGestureStateMachine.js - Orbital tool ring → UI event bus: subscribes to events
frontend/src/components/OrbitalMenu/OrbitalMenu.jsx - Orbital tool ring → Menu state sync: reads menu state
frontend/src/components/OrbitalMenu/OrbitalMenu.jsx - 3D scene engine → World and grid math: uses grid helpers
frontend/src/engine/SceneEngine.js - Gesture state machine → World and grid math: projects hand coordinates
frontend/src/hooks/useGestureStateMachine.js - Authentication state → Auth client: calls account operations
frontend/src/context/AuthContext.jsx - Authentication state → HTTP client: sets token and callback
frontend/src/context/AuthContext.jsx - Auth client → HTTP client: sends auth requests
frontend/src/api/authApi.js - Scene dashboard → Scene client: loads scene data
frontend/src/pages/Dashboard.jsx - Scene history → Scene client: loads scene history
frontend/src/pages/HistoryPage.jsx - Public gallery → Scene client: loads public scenes
frontend/src/pages/LandingPage.jsx - Scene client → HTTP client: sends scene requests
frontend/src/api/scenesApi.js - HTTP client → Express API server: calls REST API
- Express API server → Account routes: mounts auth routes
backend/server.js - Express API server → Scene routes: mounts scene routes
backend/server.js - Express API server → MongoDB connection: connects database
backend/server.js - Account routes → User records: reads and writes users
backend/routes/auth.js - Account routes → JWT authorization: protects profile route
backend/routes/auth.js - Scene routes → JWT authorization: guards scene routes
backend/routes/scenes.js - Scene routes → Scene records: reads and writes scenes
backend/routes/scenes.js - Scene routes → User records: uses user records
backend/routes/scenes.js - MongoDB connection → MongoDB: connects to
- User records → MongoDB: persists users
- Scene records → MongoDB: persists scenes