Flavor Tools #

A CLI utility for quickly creating and managing flavors in Flutter projects. Automatically configures iOS (Xcode project, xcconfig, schemes) and Android (Gradle, AndroidManifest).

Features #

• Create a flavor for iOS and Android with a single command
• Batch creation from a YAML config (create-all)
• Update existing flavors (update)
• Configure target device family for iOS
• Support for Kotlin DSL (build.gradle.kts) and Groovy (build.gradle)
• Auto-detection of settings from an existing Xcode project (SWIFT_VERSION, IPHONEOS_DEPLOYMENT_TARGET, etc.)
• Duplicate checking before creation
• flutter_launcher_icons support

Installation #

dependencies:
  flavor_tools: ^2.0.1

or

dart pub add flavor_tools

Global installation (optional) #

dart compile exe bin/flavor_tools.dart -o flavor_tools
mv flavor_tools /usr/local/bin/

Commands #

create — create a single flavor #

dart run flavor_tools create \
  -p com.example.app \
  -f dev \
  -d "My App Dev"

create-all — batch creation from YAML #

dart run flavor_tools create-all -c flavor_tools.yaml

flavor_tools.yaml format:

flavors:
  dev:
    package_name: com.example.app.dev
    display_name: "My App Dev"
  staging:
    package_name: com.example.app.staging
    display_name: "My App Staging"
  prod:
    package_name: com.example.app
    display_name: "My App"
    team_id: "ABC123"
    icons_launcher: true

Each flavor supports the following fields:

When running create-all again, it automatically detects changes and updates only those flavors whose config has changed.

update — update an existing flavor #

dart run flavor_tools update \
  -f dev \
  -p com.example.newpackage \
  -d "New Display Name"

set-target-device-family — target iOS devices #

dart run flavor_tools set-target-device-family -d "1,2"

• 1 — iPhone
• 2 — iPad
• 1,2 — iPhone and iPad

Running a flavor #

flutter run --flavor=dev

What gets generated #

iOS:

• XCBuildConfiguration for Debug, Release, Profile
• xcconfig files (ios/Flutter/Debug-{flavor}.xcconfig, Release-{flavor}.xcconfig)
• Xcode scheme (ios/Runner.xcodeproj/xcshareddata/xcschemes/{flavor}.xcscheme)
• Info.plist and Runner.entitlements updates

Android:

• flavorDimensions and productFlavors in build.gradle / build.gradle.kts
• resValue for app_name in each flavor
• AndroidManifest.xml updates