About the Project

Inspiration

WellnessAI was born from a personal need to take a holistic approach to mental and physical well-being. Traditional health apps often focus on a single dimension—fitness, finance, or mental health—but we recognized that true wellness requires understanding the interconnectedness of all aspects of our lives.

The inspiration came from observing how stress affects sleep, how financial worries impact mood, and how physical activity influences mental clarity. We wanted to create a platform that combines bienestar (wellness) with inteligencia artificial (artificial intelligence) to not only track these dimensions separately but also reveal the meaningful correlations between them, empowering users with actionable insights derived from their own data patterns.

What it does

WellnessAI is a comprehensive wellness tracking application that helps users understand the holistic connections between different aspects of their well-being. The app tracks four key dimensions:

  • Emotional Well-being: Daily mood levels, emotions, and mental state
  • Physical Health: Sleep patterns, exercise, and nutrition
  • Financial Wellness: Spending habits and financial stress
  • Stress Management: Stress levels and triggers

Key Features

🤖 AI-Powered Insights

  • Uses Google Gemini AI to analyze user data and identify meaningful correlations
  • Generates personalized recommendations based on individual patterns
  • Visualizes correlations through interactive heatmaps and scatter plots

📊 Smart Analytics

  • Real-time correlation analysis between wellness dimensions
  • Pattern recognition across time periods (daily, weekly, monthly)
  • Statistical significance testing to ensure reliable insights

🔔 Intelligent Reminders

  • Contextual reminders triggered by user behavior patterns
  • Hydration and rest reminders
  • Pattern-based notifications that adapt to user needs

🆘 Risk Detection

  • Automatic analysis of check-in data for concerning patterns
  • SMS alerts to emergency contacts when users show risk factors
  • Cooldown mechanism to prevent notification spam

🏆 Gamification

  • Badge system for achievements
  • Streak tracking for consistent engagement
  • Points system for completing check-ins and goals

👥 Community Features

  • Support groups for different wellness categories
  • Weekly challenges with progress tracking
  • Social feed for sharing experiences and motivation

📱 Beautiful UI/UX

  • Material Design 3 with custom theming
  • Responsive design across mobile, tablet, and desktop
  • Smooth animations and micro-interactions
  • Comprehensive onboarding for new users

How we built it

Technology Stack

  • Framework: Flutter 3.0+ with Dart
  • State Management: Riverpod 2.5+
  • Backend: Firebase (Firestore, Auth)
  • AI: Google Gemini API
  • Charts: fl_chart, Syncfusion Flutter Charts
  • Notifications: flutter_local_notifications
  • Localization: Flutter's built-in i18n system

Architecture

The app follows a clean architecture pattern:

lib/
├── config/          # Theme, routes, constants
├── domain/          # Business logic entities
│   ├── entities/    # Core domain models
│   ├── repositories/# Repository interfaces
│   └── use_cases/   # Business logic
├── data/            # Data layer
│   ├── repositories/# Repository implementations
│   └── mappers/     # Entity ↔ Model conversions
├── presentation/    # UI layer
│   ├── pages/       # Screen widgets
│   ├── widgets/     # Reusable components
│   └── providers/   # Riverpod providers
├── services/        # External services
└── utils/           # Helper functions

Key Implementation Details

  1. Daily Check-in System

    • Multi-step stepper with progress indicator
    • Dynamic emoji feedback for mood and stress sliders
    • Micro-animations on emotion chip selection
    • Confetti celebration on completion
  2. Intelligent Insights

    • AI-powered correlation analysis between wellness dimensions
    • Visual heatmaps and scatter plots
    • Pattern recognition across time periods
    • Personalized recommendations based on user data
  3. Smart Reminders

    • Contextual reminders triggered by user patterns
    • Hydration and rest reminders
    • Pattern-based notifications
    • Configurable reminder preferences
  4. Risk Detection

    • Automatic analysis of check-in data
    • Detection of concerning patterns (extreme stress, low mood, risk keywords)
    • SMS alerts to emergency contacts
    • Cooldown mechanism to prevent spam
  5. Community & Challenges

    • Support groups for different wellness categories
    • Weekly challenges with progress tracking
    • Social feed for sharing experiences
    • Gamification with badges and streaks

Challenges we ran into

1. Data Correlation Complexity

Challenge: Identifying meaningful correlations from noisy, sparse user data while avoiding false positives.

Solution:

  • Implemented statistical significance testing
  • Used multiple correlation coefficients (Pearson, Spearman)
  • Added minimum data point requirements
  • Created visual indicators for correlation strength

2. Real-time State Synchronization

Challenge: Keeping UI in sync with Firestore updates across multiple screens and providers.

Solution:

  • Leveraged Riverpod's StreamProvider for reactive updates
  • Implemented proper provider invalidation strategies
  • Used AsyncValue for consistent loading/error states
  • Created a centralized data repository pattern

3. Performance Optimization

Challenge: Rendering complex charts and large lists without lag, especially on lower-end devices.

Solution:

  • Implemented lazy loading for lists
  • Used ListView.builder with proper item builders
  • Added Shimmer skeletons for loading states
  • Optimized chart rendering with appropriate data sampling
  • Implemented staggered animations to reduce initial render cost

4. Cross-platform Consistency

Challenge: Ensuring consistent UI/UX across iOS, Android, and web platforms.

Solution:

  • Created responsive utility functions for padding and font sizes
  • Used platform-agnostic widgets where possible
  • Implemented adaptive layouts with LayoutBuilder
  • Tested extensively on multiple screen sizes

5. Error Handling & Edge Cases

Challenge: Handling network failures, empty states, and edge cases gracefully.

Solution:

  • Created a centralized ErrorHandler utility
  • Implemented custom error dialogs with retry mechanisms
  • Added comprehensive empty states with helpful illustrations
  • Used AsyncValue.when() for consistent error handling patterns

6. Notification Scheduling

Challenge: Scheduling contextual reminders that adapt to user behavior patterns.

Solution:

  • Built a SmartRemindersService that analyzes user data
  • Implemented pattern recognition algorithms
  • Used flutter_local_notifications with timezone support
  • Added permission handling for exact alarms and battery optimization

7. UI Overflow Issues

Challenge: Text and layout overflows across different screen sizes and languages.

Solution:

  • Systematically added maxLines and TextOverflow.ellipsis to all text widgets
  • Used Flexible and Expanded widgets strategically
  • Implemented SingleChildScrollView for horizontal content
  • Created responsive padding and font size utilities

Accomplishments that we're proud of

🎯 Complete Feature Set: Successfully implemented all core features including AI-powered insights, smart reminders, risk detection, and community features

📊 Advanced Data Analysis: Built a sophisticated correlation analysis system that identifies meaningful patterns while avoiding false positives through statistical significance testing

🎨 Polished UI/UX: Created a beautiful, responsive interface with smooth animations, micro-interactions, and comprehensive onboarding that works seamlessly across all platforms

🔔 Intelligent Automation: Implemented a smart reminder system that adapts to user behavior patterns and a risk detection system that can automatically alert emergency contacts

🏗️ Clean Architecture: Established a maintainable codebase with clear separation of concerns, following clean architecture principles with Riverpod for state management

🌍 Internationalization: Fully localized the app in English and Spanish, with support for easy addition of more languages

Performance Optimization: Achieved smooth performance even with complex charts and large datasets through lazy loading, efficient rendering, and optimized data structures

🛡️ Robust Error Handling: Created a comprehensive error handling system with user-friendly dialogs, retry mechanisms, and graceful degradation

What we learned

Building WellnessAI has been an incredible learning journey across multiple domains:

State Management & Architecture

  • Mastered Riverpod for reactive state management, learning to structure providers efficiently and handle async data streams
  • Adopted clean architecture patterns with clear separation between domain entities, data repositories, and presentation layers
  • Learned the art of dependency injection and provider composition

Firebase & Cloud Services

  • Deep dive into Firestore for real-time data synchronization and complex querying
  • Implemented robust authentication flows with Firebase Auth
  • Learned to structure NoSQL data models for optimal query performance and scalability

AI Integration

  • Integrated Google Gemini AI to generate personalized insights and recommendations
  • Explored prompt engineering techniques to extract meaningful patterns from user data
  • Built a system that transforms raw data into actionable wellness recommendations

UI/UX Design

  • Applied Material Design 3 principles with custom theming
  • Implemented responsive design patterns that work seamlessly across mobile, tablet, and desktop
  • Created intuitive micro-interactions using Hero animations, HapticFeedback, and staggered list animations
  • Designed comprehensive onboarding flows to guide new users

Data Visualization

  • Built custom correlation heatmaps and scatter plots using fl_chart
  • Implemented statistical analysis to identify meaningful patterns in user data
  • Created visual representations that make complex correlations accessible to non-technical users

Advanced Flutter Concepts

  • Mastered complex widget composition and state management
  • Learned to handle edge cases and error states gracefully
  • Implemented efficient list rendering and chart optimization techniques

What's next for WellnessAI bienestar + inteligencia artificial

🚀 Machine Learning Integration: Train custom ML models on aggregated user data to provide even more accurate predictions and personalized recommendations

Wearable Integration: Connect with fitness trackers and smartwatches (Apple Watch, Fitbit, Garmin) for automatic data collection, reducing manual input burden

📈 Advanced Analytics: Implement more sophisticated statistical models including time series analysis, predictive analytics, and trend forecasting

💬 Enhanced Social Features: Add direct messaging between users, group challenges with leaderboards, and community-driven content sharing

📤 Export & Reporting: Allow users to export their data in multiple formats (PDF, CSV) and generate comprehensive wellness reports for sharing with healthcare providers

🌐 Web Dashboard: Develop a comprehensive web dashboard for deeper data analysis and visualization on larger screens

🔐 Privacy & Security: Implement end-to-end encryption for sensitive health data and add advanced privacy controls

🤖 AI Improvements: Enhance AI capabilities with fine-tuned models, natural language processing for journal entries, and predictive health risk assessments

📱 Offline Support: Add comprehensive offline functionality so users can track their wellness even without internet connectivity

🎯 Personalization Engine: Build a more sophisticated personalization system that learns from user behavior and adapts recommendations in real-time

We're excited to continue evolving WellnessAI based on user feedback and emerging technologies, always keeping our core mission in mind: bienestar + inteligencia artificial—combining wellness with the power of AI to help people live healthier, more balanced lives.

Built With

  • android
  • auth
  • confetti
  • etc.-platforms:-ios
  • firestore)-ai-&-apis:-google-gemini-api-data-visualization:-fl-chart
  • flutter-3.0+-state-management:-riverpod-con-code-generation-backend-&-cloud-services:-firebase-(core
  • languages-&-frameworks:-dart-3.0+
  • lottie-notifications:-flutter-local-notifications-utilities:-intl
  • shared-preferences
  • shimmer
  • svg
  • syncfusion-charts-ui-libraries:-google-fonts
  • url-launcher
Share this project:

Updates