← Back to Documentation
🏆 Achievements & Gamification
Discover Nutrivio's comprehensive gamification system designed to make your nutrition journey engaging, rewarding, and sustainable. Earn XP, unlock achievements, build streaks, and level up your health!
Experience Points (XP) System
Every action you take in Nutrivio contributes to your XP and overall progress. The system is designed to reward consistent healthy habits:
XP Earning Opportunities
XP Multipliers & Bonuses
🚀 Boost your XP with smart gameplay:
- Streak Multiplier: Up to 2.0x XP for maintaining daily habits
- Level Bonus: +5 XP bonus every 10 levels you achieve
- Photo Bonus: Extra XP for meals logged with photos
- Perfect Day Bonus: Additional XP for meeting all daily targets
- Achievement Rewards: Bonus XP when unlocking achievements
- First-Time Bonuses: Extra rewards for trying new features
Level Progression System
Level Overview
5
Growing Strong - 850 / 1,200 XP
🎯 Dynamic level progression (based on Remote Config):
- Level 1: Fresh Start (0 XP) - Beginning your journey
- Level 2: First Sprout (1,500 XP) - Building basics
- Level 3: Growing Roots (4,000 XP) - Developing habits
- Level 4: Budding Success (8,000 XP) - Gaining consistency
- Level 5+: Scaling progression with increasing XP requirements
Note: Level requirements are dynamically configured and may be updated to optimize user engagement.
Level Benefits
- Unlocked Features: Access to new achievements and mission paths
- XP Bonuses: Higher level users earn bonus XP on all activities
- Status Recognition: Unique level badges and titles
- Advanced Analytics: Deeper insights into nutrition patterns
- Priority Support: Enhanced customer service for high-level users
Mission Paths
Choose your nutrition journey theme and unlock path-specific achievements and avatars:
🌱
Plant Growth Path
Growing healthy eating habits one meal at a time. Focus on natural foods, vegetables, and sustainable nutrition choices.
Path Benefits:
- Plant-based achievement categories
- Garden-themed level progression
- Vegetable variety tracking
- Seasonal eating bonuses
🍽️
Meal Mastery Path
Mastering the art of nutrition through balanced meals. Perfect for those who love cooking and meal planning.
Path Benefits:
- Cooking and meal prep achievements
- Chef-themed level progression
- Recipe collection rewards
- Nutritional balance bonuses
Path Switching
🔄 Mission Path Rules (Based on App Logic):
- Cooldown System: 24-hour cooldown between path switches
- Change Tracking: App tracks your path change count and history
- Progress Preservation: All XP, achievements, and statistics are preserved
- Path-Specific Content: Some achievements become active/inactive based on current path
- Level Unlocking: Achievements unlock based on your current level and selected path
- Auto-Sync: Achievement progress automatically syncs when switching paths
Achievement System
Achievement Categories
Common to Rare
Track meals, hit macro targets, maintain food variety
Uncommon to Epic
Build daily habits, maintain streaks, track measurements
Rare to Legendary
Achieve goals, reach milestones, complete perfect days
Epic to Legendary
Mission path milestones, unique accomplishments
Achievement Rarity System
| Rarity |
XP Reward |
Difficulty |
Examples |
| Common |
25-50 XP |
Easy |
First meal logged, 3 days streak |
| Uncommon |
75-125 XP |
Moderate |
7 days streak, 10 meals logged |
| Rare |
150-250 XP |
Challenging |
30 days streak, perfect week |
| Epic |
300-500 XP |
Hard |
90 days streak, weight goal reached |
| Legendary |
500-1000 XP |
Extreme |
365 days streak, perfect year |
Sample Achievements
🏆 Real achievements based on app implementation:
- First Steps (Common): Log your first meal (+25 XP)
- Photo Enthusiast (Uncommon): Upload 5 meal photos (+75 XP)
- Week Warrior (Uncommon): Maintain a 7-day logging streak (+100 XP)
- Macro Master (Rare): Hit all macro targets for 5 consecutive days (+150 XP)
- Streak Champion (Epic): Maintain a 30-day logging streak (+300 XP)
- Profile Complete (Common): Fill out 100% of your profile (+100 XP)
- Measurement Tracker (Uncommon): Record weekly measurements for a month (+125 XP)
- Perfect Month (Legendary): Complete all daily goals for 30 days (+500 XP)
- Goal Crusher (Epic): Achieve your weight target (+400 XP)
- Consistency King (Legendary): Log meals every day for 90 days (+750 XP)
Streak System
Build momentum with multiple types of streaks that reward consistency:
🔥
Daily Logging
Log at least one meal every day
🎯
Goal Achievement
Meet your daily calorie/macro targets
⭐
Perfect Day
Complete all daily nutrition goals
⚖️
Measurement
Record weekly weight/measurements
Streak Milestones & Rewards (From Remote Config)
🔥 Streak milestone bonuses (dynamically configured):
- Daily Milestone: +10-15 bonus XP for daily streak achievements
- Weekly Milestone: +15-25 bonus XP for weekly streak milestones
- Monthly Milestone: +20-30 bonus XP for monthly consistency
- Streak Multiplier: Up to 2.0x XP multiplier for active streaks
- Recovery System: Streak freeze/recovery mechanisms for missed days
- Level Bonus: +5 XP bonus every 10 levels achieved
Note: All streak rewards are configurable via Firebase Remote Config and may be adjusted for optimal engagement.
Accessing Your Gamification Dashboard
How to Find Your Progress
📱 Navigate to your gamification features:
- Main Dashboard: XP progress bar and streak indicators are prominently displayed at the top
- Profile Menu: Tap your profile picture → "Gamification Dashboard" for full details
- Auto-Setup: System automatically creates your gamification profile on first access
- Real-Time Notifications: Toast messages appear instantly when you earn XP or unlock achievements
- Live Updates: All progress updates in real-time as you use the app
Dashboard Features (Based on GamificationDashboardScreen)
- Level & XP Progress: Visual XP bar with current level and progress to next level
- Streak Indicators: Real-time display of all active streak types with fire animations
- Achievement Gallery: Browse recent achievements with progress tracking and rarity indicators
- Statistics Overview: Live stats including meals logged, photo meals, perfect days, measurements
- Mission Path Selector: Interactive interface to view and switch between mission paths
- XP Transaction History: Detailed log of recent XP gains with source information
- Profile Recalculation: Button to recalculate your profile from transaction history
- Test Controls: Development features for testing XP awards and streak updates
Notifications & Rewards
Real-Time Feedback System
🎉 Instant gamification feedback includes:
- XP Toast Notifications: Animated pop-ups showing XP earned with source information
- Achievement Unlocks: Special achievement cards with rarity indicators and celebration effects
- Level Up Celebrations: Full-screen level up animations with new level information
- Streak Milestone Alerts: Fire animations and congratulatory messages for streak achievements
- Progress Updates: Real-time updates to XP bars, achievement progress, and statistics
- Background Processing: All gamification updates happen automatically without blocking the UI
- Auto-Sync: Achievement progress syncs with Firebase for cross-device consistency
Tips for Maximizing Your Gamification Experience
🎮 Pro tips based on actual app implementation:
- Automatic Profile Setup: Your gamification profile is created automatically when you first access features
- Seamless Integration: XP is awarded automatically when you log meals, take measurements, or complete goals
- Mission Path Selection: Choose your path early to unlock path-specific achievements
- Achievement Sync: New achievements are automatically synced from Firebase when they're added
- Progress Tracking: All statistics are tracked automatically including meals logged, photo meals, perfect days
- Profile Recalculation: Use the dashboard's recalculation feature if your progress seems off
- Consistent Logging: Daily meal logging maintains streaks and maximizes XP multipliers
- Photo Bonuses: Adding photos to meals provides extra XP and unlocks photo-specific achievements
- Real-Time Updates: All progress updates immediately without needing to refresh
Advanced Gamification Features
Technical Implementation Details
🔧 Behind-the-scenes features:
- Firebase Remote Config: All XP values and level requirements are dynamically configurable
- Auto-Achievement Sync: New achievements are automatically synced from Firestore when added
- Mission Path System: Dynamic level themes and avatars based on selected path
- Progress Calculation: Real-time progress calculation for all achievements
- Transaction Logging: Complete audit trail of all XP transactions with source tracking
- Profile Recalculation: Ability to recalculate entire profile from transaction history
- Error Recovery: Robust error handling and retry mechanisms for failed operations
- Performance Optimization: Efficient batching of database operations for better performance
Premium Gamification Benefits
- Enhanced Multipliers: Premium users may receive bonus XP multipliers
- Exclusive Achievements: Premium-only achievement categories and rewards
- Advanced Analytics: Detailed gamification progress reports and insights
- Priority Sync: Faster achievement syncing and real-time updates
- Custom Paths: Potential for personalized mission paths
- Extended Features: Access to beta gamification features
⚠️ Important Technical Notes:
- Automatic Setup: Gamification profiles are created automatically for existing users on first access
- Cross-Device Sync: All XP, achievements, and progress sync across devices via Firebase
- Real-Time Updates: The system is designed to update immediately without app restarts
- Achievement Evolution: Achievement requirements may be updated via Remote Config for balance
- Data Recovery: Profile recalculation feature can restore progress from transaction history
- Performance Focus: All gamification features are designed to not impact core app performance
- Mission Path Logic: Achievement eligibility automatically adjusts based on current path and level