flutter_flavor_manager 1.0.0 copy "flutter_flavor_manager: ^1.0.0" to clipboard
flutter_flavor_manager: ^1.0.0 copied to clipboard

A comprehensive tool for setting up and managing flavors (environments) in Flutter projects for both Android and iOS.

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.0 - 2025-11-02 #

Added #

  • Initial release of Flutter Flavor Manager
  • Complete Android flavor configuration support
  • Complete iOS scheme and build configuration support
  • Automatic Dart entry point generation
  • VSCode/Cursor launch configuration generation
  • Smart detection of existing flavors
  • SOLID architecture with clean separation of concerns
  • Comprehensive CLI interface
  • Programmatic API for custom integrations
  • Support for both Groovy and Kotlin DSL build files
  • Automatic bundle ID and package name management
  • Reserved keyword validation
  • Project state validation
  • Post-setup automation (pod install, flutter clean, pub get)

Features #

  • Android Service: Product flavor configuration in build.gradle/build.gradle.kts
  • iOS Service: Xcode project manipulation with scheme generation
  • Dart Service: Main app file extraction and entry point generation
  • VSCode Service: Launch configuration management
  • Validators: Input and project state validation
  • Utils: String manipulation, file operations, console output
  • Models: Type-safe configuration objects
  • Unit Test: Comprehensive unit test suite (76 tests)

Architecture #

  • Single Responsibility Principle: Each service handles one concern
  • Open/Closed Principle: Extensible without modification
  • Liskov Substitution Principle: Interfaces are properly substitutable
  • Interface Segregation Principle: Focused, specific interfaces
  • Dependency Inversion Principle: Depend on abstractions

Documentation #

  • Comprehensive README with examples
  • API documentation
  • Architecture overview
  • Troubleshooting guide
  • Contributing guidelines

Added #

  • Comprehensive unit test suite (76 tests)
    • Model tests (FlavorConfig, ProjectConfig, SetupResult)
    • Validator tests (InputValidator with all validation rules)
    • Utility tests (StringUtils with all transformations)
  • Test coverage reporting
  • TEST_SUMMARY.md documentation

Planned #

  • Web flavor support
  • Windows flavor support
  • Linux flavor support
  • macOS flavor configuration
  • Environment variable management
  • Flavor-specific assets
  • Firebase configuration per flavor
  • CI/CD integration examples
  • Interactive mode improvements
  • Configuration file support (YAML/JSON)
  • Dry-run mode
  • Rollback functionality
  • Integration tests for services
  • GitHub Actions integration
  • Documentation website

For more information, see the README.

8
likes
140
points
14
downloads

Publisher

unverified uploader

Weekly Downloads

A comprehensive tool for setting up and managing flavors (environments) in Flutter projects for both Android and iOS.

Topics

#flutter #cli #flavors #android #ios

Documentation

API reference

License

MIT (license)

Dependencies

flutter

More

Packages that depend on flutter_flavor_manager