How pumpowhat/fitholic works
Fitholic is a fitness-tracking product whose current runnable surface is a Next.js prototype plus a NestJS API focused on authentication and profile onboarding. The principal implemented flow is account creation or sign-in, followed by authenticated onboarding that calculates and stores suggested nutrition targets. The web tree also contains calendar, nutrition, workout, progress/dashboard and profile features, but README-described logging, sleep, AI-coach, worker and related capabilities are not evidenced as implemented in this tree. Arrows are limited to relationships shown in excerpts, the source index, or README; unsampled feature-to-API wiring is omitted.
Main entry points: index.ts Shared contracts · profile.service.ts Onboarding and profile · auth.controller.ts Auth endpoints · profile.controller.ts Profile endpoints
Components 21
Web experience
- Sign-in and signup
apps/web/features/auth/auth-screen.tsx - Auth context
apps/web/features/auth/auth-context.tsx - OAuth callback
apps/web/features/auth/oauth-callback.tsx - Onboarding form
apps/web/features/onboarding/onboarding-form.tsx - Progress dashboard
apps/web/features/dashboard/dashboard.tsx - Nutrition tracking
apps/web/features/nutrition/nutrition-page.tsx - Workout tracking
apps/web/features/workout/workout-page.tsx - Training calendar
apps/web/features/calendar/calendar-page.tsx - Profile settings
apps/web/features/profile/profile-page.tsx - Tracking state
apps/web/features/tracking/tracking-context.tsx - API client
apps/web/lib/api-client.ts
Identity and sessions
- Auth endpoints
apps/api/src/modules/auth/auth.controller.ts - Auth and sessions
apps/api/src/modules/auth/auth.service.ts
Profile and targets
- Profile endpoints
apps/api/src/modules/profile/profile.controller.ts - Onboarding and profile
apps/api/src/modules/profile/profile.service.ts - Nutrition calculator
apps/api/src/modules/profile/nutrition-calculator.service.ts
API platform
- Shared contracts
packages/contracts/src/index.ts - PostgreSQL data store
apps/api/src/database/prisma.service.ts - API module wiring
apps/api/src/app.module.ts - API bootstrap
apps/api/src/main.ts
Other components
- Fitness user
Connections 19
- Fitness user → Sign-in and signup: signs in
apps/web/features/auth/auth-screen.tsx - Sign-in and signup → Auth context: uses
apps/web/features/auth/auth-screen.tsx - Auth endpoints → Auth and sessions: dispatches
apps/api/src/modules/auth/auth.controller.ts - Auth and sessions → PostgreSQL data store: reads and writes
apps/api/src/modules/auth/auth.service.ts - Fitness user → Onboarding form: provides details
README.md - Profile endpoints → Onboarding and profile: dispatches
apps/api/src/modules/profile/profile.controller.ts - Onboarding and profile → Nutrition calculator: calculates targets
apps/api/src/modules/profile/profile.service.ts - Onboarding and profile → PostgreSQL data store: reads and writes
apps/api/src/modules/profile/profile.service.ts - Onboarding and profile → Auth and sessions: gets current user
apps/api/src/modules/profile/profile.service.ts - API bootstrap → API module wiring: creates app
apps/api/src/main.ts - API module wiring → Auth endpoints: registers module
apps/api/src/app.module.ts - API module wiring → Profile endpoints: registers module
apps/api/src/app.module.ts - Auth endpoints → Shared contracts: uses types
apps/api/src/modules/auth/auth.controller.ts - Profile endpoints → Shared contracts: uses types
apps/api/src/modules/profile/profile.controller.ts - Onboarding and profile → Shared contracts: uses types
apps/api/src/modules/profile/profile.service.ts - Nutrition calculator → Shared contracts: returns target
apps/api/src/modules/profile/nutrition-calculator.service.ts - Auth context → Shared contracts: uses types
apps/web/features/auth/auth-context.tsx - API client → Shared contracts: uses types
apps/web/lib/api-client.ts - Auth endpoints → OAuth callback: redirects callback
apps/api/src/modules/auth/auth.controller.ts