How joshfkon/workout-app works
HyperTrack is a science-based hypertrophy training tracker. The main user journey is to enter the dashboard, start and log a workout, then finish the session; session completion triggers post-session training updates and a summary. The product also supports training plans, coaching, nutrition, body and wellness tracking, analytics, motion capture, social features, wearables, and subscriptions. The graph reflects documented README capabilities and visible source references; where implementation or wiring was not sampled, relationships are omitted rather than inferred.
Main entry points: DashboardClient.tsx Dashboard · client.ts Supabase database · finishWorkout.ts Session completion · page.tsx Workout session
Components 18
Access and dashboard
- Authentication
app/(auth)/auth/callback/route.ts - Dashboard
app/(dashboard)/dashboard/DashboardClient.tsx
Training workflow
- Workout session
app/(dashboard)/dashboard/workout/[id]/page.tsx - Session completion
app/(dashboard)/dashboard/workout/[id]/_lib/finishWorkout.ts - Training programs
lib/training/programEngine.ts
Progress and wellness
- Volume analytics
app/(dashboard)/dashboard/_lib/weeklyVolume.ts - Strength trends
app/(dashboard)/dashboard/_lib/liftTrends.ts - Body tracking
components/body/LogBodyDataSheet.tsx - Nutrition and TDEE
lib/nutrition/adaptive-tdee.ts
Coaching and integrations
- AI coaching
services/coachingEngine.ts - Plan review
services/workoutSetup/aiReview.ts - Motion capture
services/shared/motion/pipeline.ts - Social features
components/social/index.ts - Wearable integrations
lib/integrations/index.ts - Subscriptions
lib/stripe.ts
Data and services
- Supabase database
lib/supabase/client.ts - Cached query state
lib/query/queryClient.ts
Other components
- Athlete
Connections 23
- Athlete → Authentication: signs in
README.md - Authentication → Supabase database: authenticates
app/(auth)/auth/callback/route.ts - Athlete → Dashboard: opens app
README.md - Dashboard → Supabase database: loads dashboard data
app/(dashboard)/dashboard/DashboardClient.tsx - Dashboard → Workout session: starts workout
- Workout session → Session completion: finishes session
- Session completion → Supabase database: writes session
app/(dashboard)/dashboard/workout/[id]/_lib/finishWorkout.ts - Session completion → Training programs: updates training block
app/(dashboard)/dashboard/workout/[id]/_lib/finishWorkout.ts - Session completion → Cached query state: queues offline sets
app/(dashboard)/dashboard/workout/[id]/_lib/finishWorkout.ts - Session completion → Workout session: shows summary
app/(dashboard)/dashboard/workout/[id]/_lib/finishWorkout.ts - Training programs → Supabase database: loads and saves plans
lib/training/programEngine.ts - Dashboard → Volume analytics: loads volume data
app/(dashboard)/dashboard/DashboardClient.tsx - Dashboard → Strength trends: loads lift trends
app/(dashboard)/dashboard/DashboardClient.tsx - Body tracking → Supabase database: logs body data
components/body/LogBodyDataSheet.tsx - Dashboard → Nutrition and TDEE: loads eating window
app/(dashboard)/dashboard/DashboardClient.tsx - Athlete → AI coaching: requests guidance
- Athlete → Plan review: reviews draft plan
- Athlete → Motion capture: captures movement
- Athlete → Social features: uses social features
- Athlete → Wearable integrations: connects wearable
- Athlete → Subscriptions: manages subscription
README.md - Subscriptions → Supabase database: updates billing state
- Dashboard → Cached query state: caches app queries