🥑 MacroMate

Your AI-Powered Nutrition Companion

MacroMate is a premium, AI-powered macro tracking application that revolutionizes the way you monitor nutrition, weight, and daily habits. Built with Flutter and powered by Google Gemini AI, it offers a sleek, modern dark-mode interface with intelligent food logging capabilities.

Features • Demo • Installation • Configuration

✨ Features

🤖 AI-Powered Features

🍔 AI Food Logging: Simply snap a photo or type a description (e.g., "Oatmeal with blueberries") and get instant macro analysis using Google Gemini AI
💬 AI Nutrition Coach: Chat with your personal AI nutritionist for personalized advice, meal suggestions, and dietary guidance
🧠 AI Diet Strategy: Get AI-generated meal strategies and recommendations based on your fitness goals

📊 Tracking & Analytics

📈 Smart Dashboard: Real-time tracking of Calories, Protein, Carbs, and Fat against your personalized TDEE targets
⚖️ Weight Tracker: Log your weight daily and visualize trends over time with beautiful interactive charts
💧 Habit Tracking: Track daily water intake with quick-add buttons and visual progress indicators
📉 Trends & Insights: Analyze your nutrition patterns with detailed charts powered by fl_chart

🍽️ Meal Planning & Recipes

🗓️ Weekly Meal Planner: Plan your entire week with organized meals (Breakfast, Lunch, Dinner, Snacks)
🍳 Recipe Builder: Create and save custom recipes with ingredient tracking
📚 Recipe Library: Browse and manage your collection of favorite recipes
📸 Barcode Scanner: Quickly log packaged foods by scanning barcodes (Mobile only)

🎨 Premium Design

🌙 Dark Mode Interface: Beautiful, modern dark-themed UI designed for extended use
🎯 Intuitive UX: Smooth animations and responsive design across all platforms
📱 Cross-Platform: Seamlessly works on Windows, Android, iOS, Web, macOS, and Linux
🔐 Secure Authentication: Firebase-powered login with email/password and Google Sign-In

🎬 Demo

Application Walkthrough

🔗Demo Video if below video not play

Demo Part - 1 :
🔊 Note: Click the sound icon to enable audio.

part1.mp4

Demo Part - 2 :
🔊 Note: Click the sound icon to enable audio.

part2.mp4

Main dashboard, AI food logging, and tracking features

Firebase data storage and cloud sync

Note: Demo videos showcase the application's key features including AI-powered food logging, real-time macro tracking, weight trends, meal planning, recipe management, and the AI nutrition coach.

🔧 Prerequisites

Before you begin, ensure you have the following installed:

Required Software

Flutter SDK (version 3.0.0 or higher)
- Download Flutter
- Verify installation: flutter --version
Dart SDK (comes with Flutter)
Git (for cloning the repository)
- Download Git

Platform-Specific Requirements

Platform	Requirements
Windows	Windows 10/11, Visual Studio 2022 with C++ tools
Android	Android Studio, Android SDK (API 21+)
iOS	macOS, Xcode 14+, CocoaPods
macOS	macOS 10.14+, Xcode 14+
Linux	Linux development packages, GTK 3.0+
Web	Chrome browser (for testing)

Required Accounts

Firebase Account (free tier available)
- Create Firebase Account
Google AI Studio Account (for Gemini API)
- Get Gemini API Key

⚡ Installation & Setup

Step 1: Clone the Repository

# Clone the repository
git clone https://github.com/yourusername/macro_tracker_ai.git

# Navigate to project directory
cd macro_tracker_ai

Step 2: Install Dependencies

# Install Flutter packages
flutter pub get

# Run code generation for Riverpod and JSON serialization
flutter pub run build_runner build --delete-conflicting-outputs

Step 3: Verify Flutter Installation

# Check for any issues
flutter doctor

# List available devices
flutter devices

Tip: If flutter doctor shows any issues, follow the suggested fixes before proceeding.

🔑 Configuration

MacroMate requires two main configurations: Firebase for data storage and Google Gemini AI for intelligent food logging.

1. Firebase Database Setup

Firebase is used for user authentication and storing all user data.

A. Create a Firebase Project

Go to Firebase Console
Create a new project (e.g., "MacroMate-AI")
Enable Authentication (Email/Password and Google Sign-In)
Enable Cloud Firestore

B. Set up Cloud Firestore

In Firebase Console, go to Firestore Database
Click "Create database"
Select Production mode or Test mode (for development)
Choose a Cloud Firestore location
Update Firestore security rules (example for development):

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if request.auth != null;
    }
  }
}

C. Configure Your App

For Web:

In Firebase Console, go to Project Settings → Your apps
Click the Web icon </>
Register your app (nickname: "MacroMate Web")
Copy the Firebase config
Update web/index.html with your credentials

For Android:

Add an Android app in Firebase Console
Enter package name: com.example.macro_tracker_ai
Download google-services.json
Place in android/app/ folder

For iOS:

Add an iOS app in Firebase Console
Enter bundle ID: com.example.macroTrackerAi
Download GoogleService-Info.plist
Place in ios/Runner/ folder

2. Google Gemini AI Setup

The AI food logging and nutrition coach features require a Google Gemini API key.

A. Get Your API Key

Visit Google AI Studio
Sign in with your Google account
Click "Get API Key" in the top navigation
Click "Create API key"
Select your Google Cloud project (or create a new one)
Copy the generated API key

B. Configure in MacroMate

Option 1: Configure in App (Recommended)

Launch MacroMate
Navigate to Settings page (bottom navigation)
Scroll to AI Provider section
Select "Google Gemini"
Paste your API key
Click "Save"
API key is securely stored locally on your device

Option 2: Environment Variables (Advanced)

# Windows PowerShell
$env:GEMINI_API_KEY="your-api-key-here"
flutter run

# macOS/Linux
export GEMINI_API_KEY="your-api-key-here"
flutter run

Security Note: Never commit API keys to version control. They are stored locally using shared_preferences and never transmitted except to Google AI services.

C. Verify AI Features

Go to the Dashboard or Logging screen
Click "Add Food" → "AI Analysis"
Type a food description or take a photo
If configured correctly, you'll see macro analysis results

Alternative: ChatGPT API Integration

MacroMate also supports ChatGPT as an alternative AI provider.

A. Get OpenAI API Key

Visit OpenAI Platform
Sign in or create an account
Navigate to API Keys section
Click "Create new secret key"
Copy the generated key

B. Configure in MacroMate

Launch MacroMate
Go to Settings → AI Provider
Select "ChatGPT"
Paste your OpenAI API key
Choose your preferred model (e.g., GPT-4, GPT-4o)
Click "Save"

Available Models:

gpt-4o - Latest multimodal model (recommended)
gpt-4-turbo - Fast and cost-effective
gpt-3.5-turbo - Budget-friendly option

Note: ChatGPT API usage is billed by OpenAI. Check their pricing at openai.com/pricing

🚀 Running the Application

Run on Specific Platform

Once configuration is complete, you can run MacroMate on any platform:

# Windows
flutter run -d windows

# Android (with device/emulator connected)
flutter run -d android

# iOS (macOS only, with simulator/device)
flutter run -d ios

# Web
flutter run -d chrome

# macOS
flutter run -d macos

# Linux
flutter run -d linux

Select Device Interactively

# List all available devices
flutter devices

# Run and select device
flutter run

Hot Reload During Development

While the app is running:

Press r to hot reload
Press R to hot restart
Press q to quit

📱 Building for Release

Android APK/Bundle

# Build APK (for direct installation)
flutter build apk --release

# Output: build/app/outputs/flutter-apk/app-release.apk

# Build App Bundle (for Play Store)
flutter build appbundle --release

iOS

# Build for iOS (requires macOS)
flutter build ios --release

# Open in Xcode for signing and distribution
open ios/Runner.xcworkspace

Windows Executable

# Build Windows executable
flutter build windows --release

# Output: build\windows\runner\Release\

Web

# Build for web deployment
flutter build web --release

# Output: build/web/

macOS

# Build for macOS
flutter build macos --release

🏗️ Project Structure

macro_tracker_ai/
├── lib/
│   ├── core/              # Core utilities and theme
│   ├── features/          # Feature modules
│   │   ├── auth/         # Authentication screens
│   │   ├── dashboard/    # Main dashboard
│   │   ├── logging/      # Food logging and AI analysis
│   │   ├── food_search/  # Food database search
│   │   ├── meal_planner/ # Meal planning
│   │   ├── recipes/      # Recipe builder & library
│   │   ├── weight/       # Weight tracking
│   │   ├── trends/       # Charts and analytics
│   │   ├── nutrition/    # Nutrition insights
│   │   ├── coach/        # AI nutrition coach
│   │   ├── strategy/     # Diet strategy planner
│   │   ├── history/      # Food log history
│   │   └── settings/     # App settings
│   ├── models/           # Data models (Food, User, Meal, etc.)
│   ├── providers/        # Riverpod state providers
│   ├── services/         # API services
│   │   ├── ai_service.dart      # Google Gemini integration
│   │   ├── auth_service.dart    # Firebase authentication
│   │   ├── firestore_service.dart # Cloud Firestore
│   │   ├── food_log_service.dart  # Food logging
│   │   ├── meal_planner_service.dart
│   │   ├── recipe_service.dart
│   │   ├── user_service.dart
│   │   ├── weight_service.dart
│   │   └── water_service.dart
│   └── main.dart         # App entry point
├── android/              # Android-specific code
├── ios/                  # iOS-specific code
├── windows/              # Windows-specific code
├── web/                  # Web-specific code
├── macos/                # macOS-specific code
├── linux/                # Linux-specific code
├── assets/               # Images and resources
│   └── app_icon.png     # App icon
└── pubspec.yaml          # Dependencies

Key Files

File	Purpose
`lib/main.dart`	Application entry point, Firebase initialization
`lib/services/ai_service.dart`	Google Gemini AI integration with HTTP fallback
`lib/services/auth_service.dart`	Firebase Authentication (Email + Google Sign-In)
`lib/services/firestore_service.dart`	Cloud Firestore operations
`lib/providers/`	Riverpod state management
`lib/models/`	Data models with JSON serialization

🛠️ Tech Stack

Core Framework

Flutter ^3.0.0 - Cross-platform UI framework
Dart ^3.0.0 - Programming language

State Management

flutter_riverpod ^2.5.1 - Reactive state management
riverpod_annotation ^2.3.5 - Code generation for Riverpod
state_notifier ^1.0.0 - State change notifier

Backend & Database

firebase_core ^3.1.0 - Firebase initialization
firebase_auth ^5.1.0 - User authentication
cloud_firestore ^5.0.0 - NoSQL cloud database
google_sign_in ^6.2.1 - Google OAuth integration

AI & Machine Learning

Google Gemini API (HTTP fallback) - Vision and text analysis for food recognition
ChatGPT API Support - Alternative AI provider for food analysis and coaching

Navigation

go_router ^14.0.0 - Declarative routing

UI & Visualization

fl_chart ^0.68.0 - Interactive charts and graphs
cupertino_icons ^1.0.6 - iOS-style icons

Utilities

shared_preferences ^2.2.3 - Local data persistence
image_picker ^1.0.7 - Camera/gallery access
image_picker_windows ^0.2.2 - Windows image picker support
mobile_scanner ^5.1.0 - Barcode scanning
openfoodfacts ^3.1.0 - Food database API
http ^1.1.0 - HTTP requests
intl ^0.19.0 - Internationalization
uuid ^4.4.0 - Unique ID generation
json_annotation ^4.9.0 - JSON serialization annotations

Development Tools

build_runner ^2.4.9 - Code generation
riverpod_generator ^2.4.0 - Riverpod code generation
freezed ^2.5.2 - Immutable data classes
json_serializable ^6.8.0 - JSON serialization
flutter_launcher_icons ^0.13.1 - App icon generation

❓ Troubleshooting

Common Issues

🔴 Build failed: "Plugin not found"

Solution:

# Clean Flutter
flutter clean

# Remove existing symlinks (Windows only)
Remove-Item -Recurse -Force windows/flutter/ephemeral

# Reinstall dependencies
flutter pub get

# Rebuild
flutter run

🔴 Firebase not initialized

Error: [core/no-app] No Firebase App '[DEFAULT]' has been created

Solution:

Verify Firebase configuration files exist:
- Web: Check web/index.html has Firebase config
- Android: android/app/google-services.json
- iOS: ios/Runner/GoogleService-Info.plist
Check that Firebase.initializeApp() is called in main.dart
Run flutter clean and rebuild

🔴 Gemini API not working

Symptoms: AI food analysis returns errors or nothing happens

Solutions:

Verify API key is correct in Settings
Check API key is enabled in Google Cloud Console
Ensure you haven't exceeded free tier quota (60 requests/minute)
Test API key: Gemini API Docs
Try switching to ChatGPT as alternative AI provider

🔴 ChatGPT API not working

Solutions:

Verify OpenAI API key is correct
Check your account has credits/billing enabled
Ensure selected model is available (try gpt-3.5-turbo)
Check for rate limit errors in logs

🔴 Charts not displaying

Solution:

Ensure you have data logged (weight, meals)
Try pulling down to refresh
Check date range filters
Restart the app

🔴 Barcode scanner not working

Solution:

Grant camera permissions in device settings
Barcode scanner only works on mobile (Android/iOS)
Ensure mobile_scanner plugin is properly installed

🔴 Windows build issues

Error: C++ build tools not found or CMake errors

Solution:

Install Visual Studio 2022 with "Desktop development with C++"
Ensure CMake is installed and accessible
Run flutter doctor to verify
Restart terminal/IDE after installation
Try flutter clean and rebuild

🔴 Google Sign-In not working

Solution:

Ensure google_sign_in is configured in Firebase Console
For Android: Check SHA-1 fingerprint is added to Firebase
For iOS: Check URL schemes are configured in Xcode
Verify Google Sign-In is enabled in Firebase Authentication

Getting Help

If you encounter other issues:

Check Flutter Doctor: Run flutter doctor -v for diagnostic info
Review logs: Use flutter run --verbose for detailed output
Search issues: Check GitHub Issues
Ask for help: Open a new issue with:
- Flutter version (flutter --version)
- Platform (Windows, Android, etc.)
- Error logs
- Steps to reproduce

🤝 Contributing

Contributions are welcome!

This project is a comprehensive example of building a production-grade Flutter AI application using Clean Architecture, Riverpod, and Google Gemini for image recognition and natural language processing.

📄 License

This project is licensed under the MIT License.

Made with ❤️ using Flutter

MacroMate - Transform your nutrition journey with AI

⬆ Back to Top

Name		Name	Last commit message	Last commit date
Latest commit History 23 Commits
.vscode		.vscode
android		android
assets		assets
ios		ios
lib		lib
test		test
web		web
windows		windows
.gitignore		.gitignore
.metadata		.metadata
License		License
MacroMate_AI_Demo_Video.mp4		MacroMate_AI_Demo_Video.mp4
README.md		README.md
analysis_options.yaml		analysis_options.yaml
firebase.json		firebase.json
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

License

kamlesh-IY9/MacroMate-AI-V.0.3

Folders and files

Latest commit

History

Repository files navigation

🥑 MacroMate

Your AI-Powered Nutrition Companion

📋 Table of Contents

✨ Features

🤖 AI-Powered Features

📊 Tracking & Analytics

🍽️ Meal Planning & Recipes

🎨 Premium Design

🎬 Demo

Application Walkthrough

Demo Part - 1 :

Demo Part - 2 :

🔧 Prerequisites

Required Software

Platform-Specific Requirements

Required Accounts

⚡ Installation & Setup

Step 1: Clone the Repository

Step 2: Install Dependencies

Step 3: Verify Flutter Installation

🔑 Configuration

1. Firebase Database Setup

A. Create a Firebase Project

B. Set up Cloud Firestore

C. Configure Your App

2. Google Gemini AI Setup

A. Get Your API Key

B. Configure in MacroMate

C. Verify AI Features

Alternative: ChatGPT API Integration

A. Get OpenAI API Key

B. Configure in MacroMate

🚀 Running the Application

Run on Specific Platform

Select Device Interactively

Hot Reload During Development

📱 Building for Release

Android APK/Bundle

iOS

Windows Executable

Web

macOS

🏗️ Project Structure

Key Files

🛠️ Tech Stack

Core Framework

State Management

Backend & Database

AI & Machine Learning

Navigation

UI & Visualization

Utilities

Development Tools

❓ Troubleshooting

Common Issues

Getting Help

🤝 Contributing

📄 License

Made with ❤️ using Flutter

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

`Demo Part - 1 :`

`Demo Part - 2 :`

Packages