How maharshith1910/momentum works
Momentum is a full-stack habit-tracking platform. Users register or log in, then manage habits and completions; the app presents progress through dashboards, analytics, heatmaps, and achievements, with reminders as a supporting capability. The React client routes users to these experiences and communicates with a Spring Boot REST backend, which applies domain services and persists data through JPA/PostgreSQL. The graph reflects documented capabilities even where implementation excerpts were unavailable; those unsampled connections are not asserted as direct calls.
Main entry points: pages Product pages · api.ts HTTP client · HabitController.java Habit API · ReminderController.java Reminder API
Components 22
React client
- App routes
frontend/momentum-frontend/src/routes/AppRoutes.tsx - Product pages
frontend/momentum-frontend/src/pages - API services
frontend/momentum-frontend/src/services - HTTP client
frontend/momentum-frontend/src/lib/api.ts
Habit tracking
- Habit API
backend/src/main/java/com/maharshith/backend/habit/controller/HabitController.java - Habit management
backend/src/main/java/com/maharshith/backend/habit/service - Habit records
backend/src/main/java/com/maharshith/backend/habit/entity - Reminder API
backend/src/main/java/com/maharshith/backend/notification/controller/ReminderController.java - Reminder management
backend/src/main/java/com/maharshith/backend/notification/service - Reminder records
backend/src/main/java/com/maharshith/backend/notification/entity
Progress insights
- Dashboard API
backend/src/main/java/com/maharshith/backend/dashboard/controller/DashboardController.java - Analytics
backend/src/main/java/com/maharshith/backend/analytics - Activity heatmap
backend/src/main/java/com/maharshith/backend/heatmap - Achievements
backend/src/main/java/com/maharshith/backend/achievement
Identity and profile
- Login and registration
frontend/momentum-frontend/src/pages/auth - Authentication API
backend/src/main/java/com/maharshith/backend/auth/controller/AuthController.java - JWT security
backend/src/main/java/com/maharshith/backend/auth/jwt/JwtService.java - User API
backend/src/main/java/com/maharshith/backend/controller/UserController.java - User management
backend/src/main/java/com/maharshith/backend/service/UserService.java
Backend services
- User records
backend/src/main/java/com/maharshith/backend/entity/User.java
Other components
- User
- PostgreSQL
Connections 27
- User → App routes: uses
frontend/momentum-frontend/src/routes/AppRoutes.tsx - App routes → Product pages: routes to
frontend/momentum-frontend/src/routes/AppRoutes.tsx - Product pages → API services: requests data
- API services → HTTP client: uses
frontend/momentum-frontend/src/services/authService.ts - HTTP client → Habit API: HTTP REST
- HTTP client → Reminder API: HTTP REST
- HTTP client → Authentication API: HTTP REST
- HTTP client → User API: HTTP REST
- User → Habit API: manages habits
backend/src/main/java/com/maharshith/backend/habit/controller/HabitController.java - Habit API → Habit management: delegates to
backend/src/main/java/com/maharshith/backend/habit/controller/HabitController.java - Habit management → Habit records: updates
- User → Reminder API: manages reminders
backend/src/main/java/com/maharshith/backend/notification/controller/ReminderController.java - Reminder API → Reminder management: delegates to
backend/src/main/java/com/maharshith/backend/notification/controller/ReminderController.java - Reminder management → Reminder records: updates
- User → Dashboard API: views progress
backend/src/main/java/com/maharshith/backend/dashboard/controller/DashboardController.java - Dashboard API → Analytics: assembles insights
- Product pages → Analytics: shows reports
- Product pages → Activity heatmap: shows activity
- Product pages → Achievements: shows badges
- Login and registration → Authentication API: signs in
- Authentication API → JWT security: issues tokens
- User → User API: manages profile
backend/src/main/java/com/maharshith/backend/controller/UserController.java - User API → User management: delegates to
backend/src/main/java/com/maharshith/backend/controller/UserController.java - User management → User records: reads and writes
backend/src/main/java/com/maharshith/backend/service/UserService.java - User records → PostgreSQL: persists
README.md - Habit records → PostgreSQL: persists
- Reminder records → PostgreSQL: persists