How kushalshrestha303-web/balanceboard works
BalanceBoard is a full-stack study productivity and wellbeing app. Users sign in, then manage tasks, exercise, scheduled sessions, focus time, mood and hydration; the dashboard and dedicated pages present saved progress, analytics and achievements. The frontend routes through shared auth, dashboard and timer state to an HTTP API, with Express persisting per-user data in SQLite. The README documents backend validation, Google sign-in, and browser alarms/notifications; excerpts establish only selected implementation links, so unsampled subsystem connections are left out.
Main entry points: App.jsx Route app · DashboardContext.jsx Dashboard state · Dashboard.jsx Dashboard · Layout.jsx Shared layout
Components 22
Frontend experience
- Route app
src/App.jsx - Dashboard
src/pages/Dashboard.jsx - Calendar
src/pages/Calendar.jsx - Analytics
src/pages/Analytics.jsx - Achievements
src/pages/Achievements.jsx - Profile
src/pages/Profile.jsx - Sign in
src/pages/Login.jsx - Shared layout
src/components/layout/Layout.jsx - Reminders
src/components/layout/Reminders.jsx - Alarm effects
src/services/alarms.js - Study tasks
src/components/tasks/AddTask.jsx - Exercise tracking
src/components/exercise/AddExercise.jsx - Mood and hydration
src/components/wellness/WaterTracker.jsx
Shared application state
- Auth state
src/context/AuthContext.jsx - Dashboard state
src/context/DashboardContext.jsx - Timer state
src/context/TimerContext.jsx
API and services
- HTTP client
src/services/api.js - Express API
server/src/server.js - Google identity
server/src/googleAuth.js - Timer actions
server/src/timer.js
Persistent data
- SQLite database
server/src/server.js
Other components
- User
Connections 37
- User → Route app: uses
README.md - Route app → Sign in: routes to
src/App.jsx - Route app → Dashboard: routes to
src/App.jsx - Route app → Calendar: routes to
src/App.jsx - Route app → Analytics: routes to
src/App.jsx - Route app → Achievements: routes to
src/App.jsx - Route app → Profile: routes to
src/App.jsx - Route app → Auth state: checks session
src/App.jsx - Dashboard → Shared layout: renders
src/pages/Dashboard.jsx - Calendar → Shared layout: renders
src/pages/Calendar.jsx - Analytics → Shared layout: renders
src/pages/Analytics.jsx - Achievements → Shared layout: renders
src/pages/Achievements.jsx - Profile → Shared layout: renders
src/pages/Profile.jsx - Dashboard → Study tasks: renders
src/pages/Dashboard.jsx - Dashboard → Exercise tracking: renders
src/pages/Dashboard.jsx - Dashboard → Mood and hydration: renders
src/pages/Dashboard.jsx - Dashboard → Timer state: selects timer
src/pages/Dashboard.jsx - Shared layout → Reminders: renders
src/components/layout/Layout.jsx - Reminders → Alarm effects: plays or vibrates
src/components/layout/Reminders.jsx - Sign in → Auth state: authenticates
src/pages/Login.jsx - Dashboard → Dashboard state: reads state
src/pages/Dashboard.jsx - Calendar → Dashboard state: reads and updates
src/pages/Calendar.jsx - Analytics → Dashboard state: reads state
src/pages/Analytics.jsx - Achievements → Dashboard state: reads state
src/pages/Achievements.jsx - Study tasks → Dashboard state: records actions
src/components/tasks/AddTask.jsx - Exercise tracking → Dashboard state: records actions
src/components/exercise/AddExercise.jsx - Mood and hydration → Dashboard state: records actions
src/components/wellness/WaterTracker.jsx - Reminders → Dashboard state: reads sessions
src/components/layout/Reminders.jsx - Auth state → HTTP client: requests
src/context/AuthContext.jsx - Dashboard state → HTTP client: requests
src/context/DashboardContext.jsx - Timer state → HTTP client: requests
src/context/TimerContext.jsx - Reminders → HTTP client: checks due alarms
src/components/layout/Reminders.jsx - HTTP client → Express API: sends HTTP requests
README.md - Express API → Google identity: verifies identity
server/src/server.js - Express API → Timer actions: handles timer actions
server/src/server.js - Express API → SQLite database: reads and writes
server/src/server.js - Timer actions → SQLite database: persists timer state
server/src/server.js