## 1. Project Overview

Frontend

### Flutter 3.x.x

Cross-platform mobile framework powered by Dart.

Backend

### Firebase

Handles Authentication, FireStore, Storage, and Messaging.

AI Engine

### Groq Deep AI

Lightning-fast Llama-3 models for food analysis.

## 2. Quick Start Guide

Terminal

    # 1. Extract zip
    # 2. Get dependencies
    flutter pub get

    # 3. Check for issues
    flutter doctor

    # 4. Run the app
    flutter run

## 3. App Branding & Icons

### App Icon

Replace `assets/images/logo.png` then run:
`flutter pub run flutter_launcher_icons`

### Splash Screen

Update `assets/images/splash.png`. Change colors in `app_colors.dart`.

## 4. Groq AI Configuration

1. Get your key at Groq Console.
2. Update `assets/.env`

assets/.env

    GROQ_API_KEY=your_key_here

## 5. Firebase & Cloud Setup

Register your app in Firebase and download:

- Android: `android/app/google-services.json`
- iOS: `ios/Runner/GoogleService-Info.plist`

## 6. Stripe Payment Setup

1. Get keys at Stripe.com
2. Update `assets/.env`

assets/.env

    STRIPE_PUBLISHABLE_KEY=pk_your_key
    STRIPE_SECRET_KEY=sk_your_key

## 7. AdMob Integration

- Banner, Interstitial, Rewarded, and App Open ads support.
- Configure IDs in `lib/config/ads_config.dart`

## 8. Language & Translations

Edit translations in: `lib/config/app_localizations.dart`

Pre-translated languages include English, Bengali, Hindi, Arabic, etc.

## 9. Coins & Plans

Adjust coins in: `lib/providers/coins/coin_provider.dart`

Manage plans in: `lib/providers/payment/subscription_provider.dart`

## 10. Android Build

    flutter build appbundle --release

## 11. iOS Release

Open `ios/Runner.xcworkspace` in Xcode to update bundle ID & signing.

## 12. Release Notes & Changelog

## Version 2.1.2 — April 2026 Latest

### New

- Context-Aware AI Coach – Now uses your 7-day food history, calorie goals, and top foods for personalized advice
- AI-Driven Diet Optimization – History-based analysis of nutritional gaps (protein, fiber, fat) with corrective diet suggestions
- AI Hydration & Lifestyle Tips – Personalized wellness guidance added to meal plans
- Action-Based Interstitial Ads – Strategic triggers after 2 scans or on Analysis entry with smart cooldown
- Smart Ad Frequency Capping – Global protection of user experience with max 8 ads/hour limit across all types
- Enhanced App Open Ads – Adaptive 4-minute cooldown to prevent repetitive ad displays
- Interactive Nutrient Alerts – Immediate local notifications with deficiency warnings and recovery tips
- A+ Maintenance – Latest library updates and Dart SDK compatibility (^3.9.0+)

### Version 2.0.2 — February 2026

#### New

- Nutrient deficiency notification
- Smart meal plan suggestions from 14-day food history
- Suggested diet styles with auto-select banner
- Improved AI balanced meal plan generation
- Localization updates for all 16 languages
- Turkish key added & notification fixes (pt-BR, Arabic)
- App version display updated across screens

#### Fixes

- Removed unused `avgCarbs`
- Fixed condition block syntax issues
- Cleaned prompt formatting issues
- Removed unused comments/code
- Updated version references to 2.0.2

### Version 2.0.1 — November 2025

- AI Meal Plan Generator added
- 7 diet styles with customizable calorie targets
- Meal details with ingredients and instructions
- Auto-generated grocery list
- Hydration and lifestyle tips

### Version 1.0.0 — July 2025

- Initial Release
- Core food scanning functionality
- Basic nutrition tracking
- SQLite database implementation

## Need More Help?

If you have specific questions about customization, reach out via WhatsApp.

💬 Message via WhatsApp