🎨 Flavor Config #

A lightweight, intuitive Flutter package for managing multiple app flavors and environment configurations with ease.

✨ Features #

• 🚀 Simple Setup - Configure multiple environments in minutes
• 🎯 Type-Safe - Access configuration values with confidence
• 🏷️ Visual Debugging - Built-in flavor banner for development
• 🔧 Flexible - Support unlimited environments and custom values
• 📱 Device Info - Inspect device information for debugging
• 🎨 Customizable - Toggle banners and customize per environment

📦 Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  flavor_config: ^latest_version

Then run:

flutter pub get

🚀 Quick Start #

1️⃣ Create Environment Entry Points #

Create separate main files for each environment in your lib folder:

• lib/dev_main.dart - Development environment
• lib/staging_main.dart - Staging environment
• lib/prod_main.dart - Production environment

2️⃣ Configure Development Environment #

lib/dev_main.dart

import 'package:flutter/material.dart';
import 'package:flavor_config/flavor_config.dart';

void main() {
  FlavorConfig(
    flavorName: 'dev',
    values: {
      'apiBaseUrl': 'https://dev.example.com/api',
      'apiKey': 'dev-api-key-12345',
      'enableLogging': true,
    },
  );

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'My App - ${FlavorConfig.getFlavorName()}',
      home: FlavorBanner(
        child: Scaffold(
          appBar: AppBar(
            title: Text('Flavor: ${FlavorConfig.getFlavorName()}'),
          ),
          body: Center(
            child: Column(
              spacing: 16,
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                Text(
                  'Environment: ${FlavorConfig.getFlavorName()}',
                  style: Theme.of(context).textTheme.headlineSmall,
                ),
                Text(
                  'API: ${FlavorConfig.getValue('apiBaseUrl')}',
                  style: Theme.of(context).textTheme.bodyLarge,
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}

3️⃣ Configure Production Environment #

lib/prod_main.dart

import 'package:flutter/material.dart';
import 'package:flavor_config/flavor_config.dart';

void main() {
  FlavorConfig(
    flavorName: 'prod',
    bannerEnabled: false, // 🎯 Disable banner in production
    values: {
      'apiBaseUrl': 'https://api.example.com',
      'apiKey': 'prod-api-key-67890',
      'enableLogging': false,
    },
  );

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'My App',
      home: FlavorBanner(
        child: Scaffold(
          appBar: AppBar(
            title: const Text('My App'),
          ),
          body: Center(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                Text(
                  'Welcome to Production!',
                  style: Theme.of(context).textTheme.headlineSmall,
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}

🛠️ Usage #

Accessing Configuration Values #

// Get current flavor name
String flavor = FlavorConfig.getFlavorName(); // 'dev', 'prod', etc.

// Get specific configuration value
String apiUrl = FlavorConfig.getValue('apiBaseUrl');
bool logging = FlavorConfig.getValue('enableLogging');

Using the Flavor Banner #

The FlavorBanner widget displays a diagonal banner showing the current flavor name. Perfect for development and staging environments!

FlavorBanner(
  child: YourWidget(),
)

Running Different Flavors #

# Run development flavor
flutter run -t lib/dev_main.dart

# Run production flavor
flutter run -t lib/prod_main.dart

# Run staging flavor
flutter run -t lib/staging_main.dart

🎯 Advanced Configuration #

Custom Banner Colors #

FlavorConfig(
  flavorName: 'staging',
  color: Colors.orange, // 🔄 Custom banner color
  values: {
    'apiBaseUrl': 'https://staging.example.com/api',
  },
);

Conditional Features #

// Enable features based on flavor
if (FlavorConfig.getFlavorName() == 'dev') {
  // Enable debug features
}

// Use configuration values for conditional logic
if (FlavorConfig.getValue('enableLogging') == true) {
  // Setup logging
}

🎨 FlavorConfig API #

Constructor Parameters #

Static Methods #

💡 Best Practices #

• ✅ Use descriptive flavor names (dev, staging, prod)
• ✅ Disable banners in production environments
• ✅ Store environment-specific values in the config
• ✅ Create separate launch configurations for each flavor
• ✅ Keep sensitive data out of version control

📱 Example App #

Check out the example directory for a complete working implementation.

🤝 Contributing #

Contributions are welcome! Feel free to open issues or submit pull requests.

📄 License #

This Flutter package is made available under the MIT License.