What Are Flavors?

Step-by-Step Setup

1. Define Your App Flavors in Flutter Code

Create a file named lib/flavors.dart. Inside it, add this code:

enum Flavor { development, staging, production }

class FlavorConfig {
  final Flavor flavor;
  final String baseUrl;

  static late FlavorConfig instance;

  FlavorConfig._internal(this.flavor, this.baseUrl);

  static void initialize(Flavor flavor) {
    switch (flavor) {
      case Flavor.development:
        instance = FlavorConfig._internal(flavor, "https://dev.api.com");
        break;
      case Flavor.staging:
        instance = FlavorConfig._internal(flavor, "https://staging.api.com");
        break;
      case Flavor.production:
        instance = FlavorConfig._internal(flavor, "https://api.com");
        break;
    }
  }
}

Here’s what’s happening:

Now, in your main.dart, initialize the flavor like this:

import 'flavors.dart';

void main() {
  FlavorConfig.initialize(Flavor.development); // Choose the flavor here
  runApp(MyApp());
}

This ensures that when you run the app, it loads the right environment config.

2. Set up Flavors in Android

Open android/app/build.gradle and add:

android {
    ...
    flavorDimensions "env"
    productFlavors {
        dev {
            dimension "env"
            applicationIdSuffix ".dev"
            resValue "string", "app_name", "MyApp Dev"
        }
        staging {
            dimension "env"
            applicationIdSuffix ".staging"
            resValue "string", "app_name", "MyApp Staging"
        }
        prod {
            dimension "env"
            resValue "string", "app_name", "MyApp"
        }
    }
}

Explanation:

Also, update your AndroidManifest.xml to use:

android:label="@string/app_name"

This ensures the app name comes from the correct flavor.

3. Setup Flavors in iOS

Steps:

4. Run with Flavors

For Android:

flutter run --flavor dev -t lib/main.dart
flutter build apk --flavor staging -t lib/main.dart

For iOS:

flutter run --flavor prod -t lib/main.dart