How jdeinane/sonic-light works
SonicLight is a drawing-and-sonification web app. A user identifies by username, loads or creates a stroke drawing, saves it through the API, and can listen to it; administrators can browse and listen to all saved drawings. The graph covers the documented SQLite persistence and sonification capabilities. Some implementation details are unsampled, so edges are limited to relationships visible in excerpts, the source index, or the README.
Main entry points: index.js Page router · DrawView.vue Drawing page · api.js API client · AdminView.vue Admin gallery
Components 17
Web client
- App shell
frontend/src/App.vue - Page router
frontend/src/router/index.js - Username session
frontend/src/session.js - Login page
frontend/src/views/LoginView.vue
Drawing experience
- Drawing page
frontend/src/views/DrawView.vue - Drawing canvas
frontend/src/components/DrawingCanvas.vue - Stroke rendering
frontend/src/drawing.js - Admin gallery
frontend/src/views/AdminView.vue
Sonification
- Listen control
frontend/src/components/PlayButton.vue - Drawing sonification
frontend/src/audio.js
API and validation
- API client
frontend/src/api.js - API routes
backend/src/app.js - Input validation
backend/src/validation.js - API server
backend/src/server.js
Persistence
- Drawing data access
backend/src/db.js - SQLite database
Other components
- User
Connections 26
- User → Login page: identifies
README.md - User → Drawing page: draws and saves
README.md - User → Listen control: listens
README.md - App shell → Page router: mounts
frontend/src/main.js - Page router → Login page: routes to
frontend/src/router/index.js - Page router → Drawing page: routes to
frontend/src/router/index.js - Page router → Admin gallery: routes to
frontend/src/router/index.js - Page router → Username session: checks access
frontend/src/router/index.js - Login page → API client: logs in via
frontend/src/views/LoginView.vue - Login page → Username session: sets identity
frontend/src/views/LoginView.vue - Drawing page → API client: loads and saves
frontend/src/views/DrawView.vue - Drawing page → Drawing canvas: edits strokes
frontend/src/views/DrawView.vue - Drawing page → Listen control: offers playback
frontend/src/views/DrawView.vue - Drawing canvas → Stroke rendering: renders strokes
frontend/src/components/DrawingCanvas.vue - Admin gallery → API client: loads gallery
frontend/src/views/AdminView.vue - Admin gallery → Drawing canvas: shows thumbnails
frontend/src/views/AdminView.vue - Admin gallery → Listen control: offers playback
frontend/src/views/AdminView.vue - Listen control → Drawing sonification: plays drawing
frontend/src/components/PlayButton.vue - Drawing sonification → Stroke rendering: uses stroke model
frontend/src/audio.js - API client → Username session: adds username
frontend/src/api.js - API client → API routes: sends API requests
frontend/src/api.js - API routes → Input validation: validates input
backend/src/app.js - API routes → Drawing data access: reads and writes
backend/src/app.js - API server → API routes: starts app
backend/src/server.js - API server → Drawing data access: opens database
backend/src/server.js - Drawing data access → SQLite database: persists drawings
README.md