flutter_app_config 1.0.3

Configure app name, icon, version, and splash screen directly from pubspec.yaml. Save 30-60 minutes of manual setup with automatic Android/iOS configuration. Flutter logo included. One command setup.

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.3 - 2026-02-05

Added

• Splash image display: SplashConfig.imageFit – use BoxFit.cover (full screen) or BoxFit.contain (centered, letterboxed).
• Splash image sizing: imageWidth and imageHeight for precise sizing.
• Optional splash: splash_image_path can be omitted; app name/icon/version still update without splash.
• Single splash: Native Android/iOS splash is now set to the same background color and image as your Flutter splash, so you see one seamless splash instead of two.
• App icon (Android): Configure tool copies custom_icon_path into Android mipmap folders so the launcher icon updates after dart run flutter_app_config:configure.
• Optional splash_background_color in pubspec.yaml so native splash matches your Flutter splash color.

Changed

• Native splash is no longer made transparent; it shows your splash image and background color until Flutter loads.
• Documentation simplified and shortened for easier onboarding.

1.0.2 - 2026-02-05

Changed

• Simplified configuration: always use custom_icon_path and splash_image_path (removed use_flutter_logo flag)
• Rewrote README quick-start section to be shorter and easier to follow

Fixed

• Improved SplashScreen lifecycle handling by cancelling its internal timer in dispose to make tests and widget teardown stable

1.0.1 - 2025-12-19

Fixed

• Improved README documentation to prevent "Duplicate mapping key" error
• Added clear warnings about placing flutter_app_config: at root level, not inside dependencies:
• Added troubleshooting section for common YAML configuration mistakes

1.0.0 - 2025-12-19

Added

• Configure app name, package ID, version, and splash screen directly from pubspec.yaml
• Automatic Android/iOS configuration tool (dart run flutter_app_config:configure)
• SplashScreen widget with customizable duration, background color, and image
• Flutter logo support for splash screen (displayed by default)
• Platform-specific configuration options (Android only, iOS only, or both)
• Automatic removal of native splash screens to avoid double splash

Features

• Updates AndroidManifest.xml, build.gradle.kts, and strings.xml
• Updates iOS Info.plist and project.pbxproj
• Supports custom icons and Flutter logo for app icons (manual setup required)
• Configures app metadata (name, package ID, version) automatically