A comprehensive Flutter application that transforms food inspiration into actionable cooking experiences using AI-powered recipe generation, community features, and subscription-based monetization.

• Generate recipes from text descriptions
• Create recipes from food images
• YouTube video analysis for recipe extraction
• Personalized recommendations based on dietary preferences
• Nutritional analysis and grocery list generation

• Share and discover recipes from other users
• Like, comment, and save community recipes
• Follow your favorite cooks
• Recipe collections and meal planning

• RevenueCat integration for subscription management
• Premium features with paywall
• Multiple subscription tiers
• Restore purchases functionality

• Material Design 3 with custom theming
• Smooth animations and transitions
• Responsive design for all screen sizes
• Dark/light theme support
• Accessibility features

• Flutter SDK (>=3.10.7)
• Dart SDK (>=3.10.7)
• Android Studio / VS Code
• Git

1. Clone the repository

   git clone https://github.com/yourusername/letscook.git
   cd letscook

2. Install dependencies

   flutter pub get

3. Generate code

   flutter packages pub run build_runner build

The app requires several API keys for full functionality. You can set them up in multiple ways:

Option 1: Environment Variables (Recommended)

export GEMINI_API_KEY="your_gemini_api_key_here"
export REVENUE_CAT_API_KEY="your_revenue_cat_api_key_here"
export FIREBASE_API_KEY="your_firebase_api_key_here"

Option 2: Flutter Run with --dart-define

flutter run --dart-define=GEMINI_API_KEY=your_key_here \
           --dart-define=REVENUE_CAT_API_KEY=your_key_here \
           --dart-define=FIREBASE_API_KEY=your_key_here

Option 3: Create a .env file (Development only) Create a .env file in the root directory:

GEMINI_API_KEY=your_gemini_api_key_here
REVENUE_CAT_API_KEY=your_revenue_cat_api_key_here
FIREBASE_API_KEY=your_firebase_api_key_here

1. Google Gemini AI API Key

   • Visit Google AI Studio
   • Create a new API key
   • Enable the Gemini API

2. RevenueCat API Key

   • Sign up at RevenueCat
   • Create a new project
   • Get your public API key from the dashboard

3. Firebase API Key (Optional)

   • Create a Firebase project at Firebase Console
   • Enable Authentication
   • Download google-services.json (Android) and GoogleService-Info.plist (iOS)

1. Development mode

   flutter run

2. With specific environment

   flutter run --dart-define=ENVIRONMENT=development

3. Release mode

   flutter run --release

The app follows Clean Architecture principles with the following structure:

lib/
├── core/                    # Core utilities and services
│   ├── config/             # Environment configuration
│   ├── constants/          # App constants
│   ├── di/                 # Dependency injection
│   ├── error/              # Error handling
│   └── services/           # External service integrations
├── data/                   # Data layer
│   ├── datasources/        # Remote and local data sources
│   ├── models/             # Data models with JSON serialization
│   └── repositories/       # Repository implementations
├── domain/                 # Domain layer (business logic)
│   ├── entities/           # Core business entities
│   ├── repositories/       # Repository interfaces
│   └── usecases/           # Business use cases
└── presentation/           # Presentation layer
    ├── blocs/              # State management (BLoC pattern)
    ├── screens/            # Full-screen views
    └── widgets/            # Reusable UI components

• State Management: BLoC Pattern with flutter_bloc
• Dependency Injection: GetIt
• Networking: Dio with custom interceptors
• Local Storage: SharedPreferences + Hive
• Animations: flutter_animate + Lottie
• AI Integration: Google Generative AI (Gemini)
• Subscriptions: RevenueCat
• Authentication: Firebase Auth (optional)

Run tests with:

flutter test

Run integration tests:

flutter drive --target=test_driver/app.dart

flutter build apk --release
# or
flutter build appbundle --release

flutter build ios --release

*Required for full functionality. App will work with limited features without these keys.

The app automatically enables/disables features based on available API keys:

• AI Features: Enabled when GEMINI_API_KEY is provided
• Subscriptions: Enabled when REVENUE_CAT_API_KEY is provided
• Firebase Auth: Enabled when FIREBASE_API_KEY is provided
• Mock Data: Enabled in development mode

The app uses Material Design 3 with custom colors. You can modify the theme in lib/main.dart:

ThemeData _buildTheme() {
  const primaryColor = Color(0xFFFF6B35); // Change this
  // ... rest of theme configuration
}

1. Create domain entities in lib/domain/entities/
2. Define repository interfaces in lib/domain/repositories/
3. Implement use cases in lib/domain/usecases/
4. Create data models in lib/data/models/
5. Implement repositories in lib/data/repositories/
6. Add BLoC for state management in lib/presentation/blocs/
7. Create UI screens and widgets in lib/presentation/

1. API Keys not working

   • Ensure keys are properly set in environment variables
   • Check that keys have proper permissions
   • Verify the keys are not expired

2. Build failures

   • Run flutter clean && flutter pub get
   • Check Flutter and Dart SDK versions
   • Ensure all dependencies are compatible

3. iOS build issues

   • Update CocoaPods: cd ios && pod install
   • Check iOS deployment target (minimum iOS 12.0)

4. Android build issues

   • Check android/app/build.gradle for correct configurations
   • Ensure minimum SDK version is 21

Enable debug logging by setting:

flutter run --dart-define=ENVIRONMENT=development

This project is licensed under the MIT License - see the LICENSE file for details.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

For support, email [email protected] or create an issue in this repository.

• Flutter - UI framework
• Google Gemini AI - AI recipe generation
• RevenueCat - Subscription management
• Firebase - Authentication and backend services
• Lottie - Animations

Made with ❤️ by the LetsCook team