How singhdhairya17/wellus-app works
Wellus is a mobile nutrition and health-goal app. Users enter through onboarding and authentication, set personal targets, then log or scan food, track hydration, exercise, and weight, and review nutrition insights and progress; separate flows support AI coaching, recipe planning, and reminders. The graph includes major README capabilities whose detailed wiring is not established by the sampled excerpts; edges are limited to documented calls or visible source calls, so some feature-to-backend links are omitted.
Main entry points: _layout.jsx Main tabs · schema.js Convex data · index.jsx Entry and onboarding · Home.jsx Nutrition dashboard
Components 34
Mobile app
- Entry and onboarding
app/index.jsx - Sign in and sign up
app/auth/SignIn.jsx - Main tabs
app/(tabs)/_layout.jsx - Nutrition dashboard
app/(tabs)/Home.jsx - Meal logging
app/(tabs)/Meals.jsx - Label scanning
app/scan-label/index.jsx - Diet preferences
app/preferance/index.jsx - Health tracking
app/(tabs)/Progress.jsx - Progress insights
components/insights/NutritionInsights.jsx - Recipe planning
app/generate-ai-recipe/index.jsx - Health coach
app/health-coach/index.jsx - Reminder settings
app/meal-reminders/index.jsx - Plans and billing
app/billing/index.jsx - Profile management
components/profile/ProfileManager.jsx
App services
- OCR pipeline
services/ocr/OCRService.jsx - Image preprocessing
services/ocr/ImagePreprocessing.jsx - On-device OCR
services/ocr/LocalOCRService.jsx - Adaptive monitoring
services/monitoring/AdaptiveMonitoringService.jsx - Explainable insights
services/ai/XAIService.jsx - Reminder scheduler
services/reminders/MealReminderScheduler.jsx - Convex client
utils/convexClient.js
Convex backend
- AI actions
convex/Ai.js - Profile functions
convex/Profiles.js - Meal plan functions
convex/MealPlan.jsx - Recipe functions
convex/Recipes.js - Tracking functions
convex/Tracking.js - Reminder functions
convex/Reminders.js - User functions
convex/Users.js - Billing functions
convex/Billing.js - Convex data
convex/schema.js
External services
- Firebase Auth
services/FirebaseConfig.jsx - OpenAI
- Device notifications
Other components
- App user
Connections 35
- App user → Entry and onboarding: starts
- Entry and onboarding → Sign in and sign up: routes to
- Sign in and sign up → Firebase Auth: authenticates
- Entry and onboarding → Main tabs: enters app
- Main tabs → Nutrition dashboard: shows
- Main tabs → Meal logging: opens
- Main tabs → Label scanning: opens
- Main tabs → Health tracking: opens
- Main tabs → Profile management: opens
- Diet preferences → Profile functions: queries and updates
- Label scanning → OCR pipeline: extracts nutrition
- OCR pipeline → Image preprocessing: preprocesses image
- OCR pipeline → On-device OCR: tries local OCR
- Label scanning → Explainable insights: explains nutrition
- Meal logging → Tracking functions: records meals
- Health tracking → Tracking functions: records activity
- Nutrition dashboard → Adaptive monitoring: shows adaptive guidance
- Progress insights → Explainable insights: generates explanations
- Recipe planning → AI actions: requests AI recipes
- Recipe planning → Recipe functions: uses recipes
- Health coach → AI actions: requests coaching
- AI actions → OpenAI: calls
- Reminder settings → Reminder scheduler: schedules or cancels
- Reminder scheduler → Device notifications: schedules
- Reminder settings → Reminder functions: syncs settings
- Plans and billing → Billing functions: uses billing
- Profile management → Profile functions: manages profiles
- Nutrition dashboard → Meal plan functions: shows plan
- Profile functions → Convex data: reads and writes
- Meal plan functions → Convex data: reads and writes
- Recipe functions → Convex data: reads and writes
- Tracking functions → Convex data: reads and writes
- Reminder functions → Convex data: reads and writes
- User functions → Convex data: reads and writes
- Billing functions → Convex data: reads and writes