How nishwanth2809/ai-attention works
Attn is a browser-first focus coach. The user starts a camera or simulated session, receives sampled focus cues and automation responses, then reviews and exports locally saved reports or adjusts privacy settings. The current React application is the product; the archived Flask app is a distinct legacy monitoring system. The current worker, camera hook and signal code are represented from the tree and README; their internal wiring is not fully evidenced by excerpts, so uncertain links are omitted.
Main entry points: app.py Legacy Flask service · useFocus.js Session controller · App.jsx App shell · session.js Session aggregates
Components 25
Focus application
- App shell
frontend/src/App.jsx - Focus workspace
frontend/src/features/focus/FocusSpace.jsx - Session controller
frontend/src/features/focus/useFocus.js
Vision and signals
- Camera lifecycle
frontend/src/features/focus/useCamera.js - Vision worker
frontend/public/vision-worker.js - Signal calculation
frontend/src/features/focus/signals.js
Coaching automations
- Rule engine
frontend/src/core/automation.js - Automation editor
frontend/src/features/automations/Automations.jsx - Coaching actions
frontend/src/features/focus/useFocus.js
Reports and privacy
- Session aggregates
frontend/src/core/session.js - Browser storage
frontend/src/core/storage.js - Reports dashboard
frontend/src/features/reports/Reports.jsx - Privacy settings
frontend/src/features/reports/Settings.jsx - Chart display
frontend/src/ui/Chart.jsx
Legacy monitor
- Legacy Flask service
legacy/app.py - Legacy vision analysis
legacy/src/attention_score.py - Face detection
legacy/src/face_detection.py - Blink detection
legacy/src/blink_detection.py - Gaze tracking
legacy/src/gaze_tracking.py - Head pose
legacy/src/head_pose.py - Legacy dashboard
legacy/frontend-src/App.jsx - Video panel
legacy/frontend-src/components/VideoPanel.jsx - Legacy data polling
legacy/frontend-src/hooks/useAttentionData.js - Session database
legacy/app.py
Other components
- Focus user
Connections 30
- Focus user → App shell: uses
frontend/src/App.jsx - App shell → Session controller: creates
frontend/src/App.jsx - App shell → Focus workspace: renders
frontend/src/App.jsx - App shell → Automation editor: renders
frontend/src/App.jsx - App shell → Reports dashboard: renders
frontend/src/App.jsx - App shell → Privacy settings: renders
frontend/src/App.jsx - Focus workspace → Session controller: uses
frontend/src/App.jsx - Session controller → Camera lifecycle: starts
frontend/src/features/focus/useFocus.js - Session controller → Rule engine: evaluates
frontend/src/features/focus/useFocus.js - Session controller → Session aggregates: records
frontend/src/features/focus/useFocus.js - Session controller → Browser storage: loads and saves
frontend/src/features/focus/useFocus.js - Session controller → Coaching actions: dispatches
frontend/src/features/focus/useFocus.js - Camera lifecycle → Signal calculation: uses
frontend/src/features/focus/useCamera.js - Camera lifecycle → Vision worker: processes frames
- Automation editor → Rule engine: configures
frontend/src/features/automations/Automations.jsx - Automation editor → Session aggregates: formats activity
frontend/src/features/automations/Automations.jsx - Reports dashboard → Session aggregates: formats and exports
frontend/src/features/reports/Reports.jsx - Reports dashboard → Chart display: renders
README.md - Privacy settings → Session aggregates: clears reports
frontend/src/features/reports/Settings.jsx - Privacy settings → Browser storage: manages
- Legacy dashboard → Video panel: renders
legacy/frontend-src/App.jsx - Legacy dashboard → Legacy data polling: uses
legacy/frontend-src/App.jsx - Video panel → Legacy Flask service: streams video
- Legacy data polling → Legacy Flask service: polls scores
legacy/frontend-src/hooks/useAttentionData.js - Legacy Flask service → Legacy vision analysis: scores frames
legacy/app.py - Legacy Flask service → Face detection: detects faces
legacy/app.py - Legacy Flask service → Blink detection: measures blinks
legacy/app.py - Legacy Flask service → Gaze tracking: tracks gaze
legacy/app.py - Legacy Flask service → Head pose: estimates pose
legacy/app.py - Legacy Flask service → Session database: stores sessions
legacy/app.py