Package selection guidance compiled from public package information, community data, and project usage.
icons_launcher is a command-line tool designed to streamline the process of updating launcher icons in Flutter applications. It automates the generation and placement of app icons across multiple platforms, including Android, iOS, macOS, Windows, and Linux. By simplifying icon management, it reduces manual effort and ensures consistency across different device configurations. The tool integrates seamlessly with Flutter projects via pub add, making it accessible for developers aiming to maintain professional app appearances without complex workflows.
Use cases
Updating app icons for new releases
Automating icon generation across platforms
Maintaining consistent branding across devices
Quickly regenerating icons after design changes
Supporting multi-platform app deployment
Key features
Cross-platform icon generation
Command-line interface integration
Automatic asset folder updates
Support for various icon sizes and formats
Simple setup with flutter pub add
Suitable for
Flutter developers managing app branding
Teams requiring consistent icon deployment
Projects targeting multiple operating systems
Developers seeking time-saving automation tools
Considerations
Requires command-line familiarity
May need manual verification of generated assets
Depends on correct input image dimensions
Not suitable for real-time icon editing
Limited GUI interaction
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
🍃 Icons Launcher 🍃
A command-line tool that simplifies the task of updating your Flutter app's launcher icon. Full flexibility allows you to only update the launcher icon for specific platforms as needed.
Platform Support
Android
iOS
macOS
Web
Linux
Windows
✅
✅
✅
✅
✅
✅
Guide
1. Setup the config file
Add your Icons Launcher configuration to your pubspec.yaml or create a new config file called icons_launcher.yaml.
An example is shown below. More complex examples here.
Add config to pubspec.yaml or create a separate icons_launcher.yaml
Note
For IOS 18 icons dark and tinted also supported. See more on example config below.
2. Run the package
After setting up the configuration, all that is left to do is run the package:
flutter pub get
dart run icons_launcher:create
If you name your configuration file something other than icons_launcher.yaml or pubspec.yaml you will need to specify the name of the file when running the package.
flutter pub get
dart run icons_launcher:create --path <your config file name here>
Note
If you are not using the existing pubspec.yaml your config file must still be located in the same directory as it.
In the above configuration, the package is setup to replace the existing launcher icons in both the Android and iOS project.
Attributes
Shown below is the full list of attributes which you can specify within your Icons Launcher configuration.
Icons Launcher Option
Type
Default
Description
image_path
String
null
The image file path
platforms
Object
null
Use for specific platforms to generate icons
Platforms Option
Type
Default
Description
android
Object
null
Use for specific Android platform
ios
Object
null
Use for specific iOS platform
macos
Object
null
Use for specific macOS platform
windows
Object
null
Use for specific Windows platform
web
Object
null
Use for specific Web platform
linux
Object
null
Use for specific Linux platform
Android Option
Type
Default
Description
enable
Boolean
false
Use for enable Android platform
image_path
String
null
The image file path
notification_image
String
null
Image for the notification icon
adaptive_background_color
String
null
Color for fill out the background of the adaptive icon
adaptive_background_image
String
null
Image for fill out the background of the adaptive icon
adaptive_foreground_image
String
null
Image for the icon foreground of the adaptive icon
adaptive_round_image
String
null
Image for the round icon of the adaptive icon
adaptive_monochrome_image
String
null
Image for the monochrome version of the adaptive icon
iOS Option
Type
Default
Description
enable
Boolean
false
Use for enable iOS platform
image_path
String
null
The image file path
dark_path
String
null
The dark image file path
tinted_path
String
null
The tinted image file path
Web Option
Type
Default
Description
enable
Boolean
false
Use for enable Web platform
image_path
String
null
The image file path
maskable_image_path
String
null
The maskable image file path for PWA
favicon_path
String
null
The image file path
favicon_output_extension
String
.png
Extension for favicon .png or .ico
macOS Option
Type
Default
Description
enable
Boolean
false
Use for enable macOS platform
image_path
String
null
The image file path
Windows Option
Type
Default
Description
enable
Boolean
false
Use for enable Windows platform
image_path
String
null
The image file path
Linux Option
Type
Default
Description
enable
Boolean
false
Use for enable Linux platform with snapcraft
image_path
String
null
The image file path
Flavor support
Create a Icons Launcher configuration file for your flavor. The config file is called icons_launcher-<flavor>.yaml by replacing <flavor> by the name of your desired flavor.
Example: icons_launcher-dev.yaml and icons_launcher-prod.yaml
Run with flavor:
flutter pub get
# create for dev flavor
dart run icons_launcher:create --flavor dev
# create for prod flavor
dart run icons_launcher:create --flavor prod
Alternatively, you can run multiple flavors at the same time with the following command:
dart run icons_launcher:create --flavors dev,prod
The configuration file format is the same.
Example
icons_launcher:platforms:android:enable:trueimage_path:"assets/ic_logo_radius.png"notification_image:"assets/ic_foreground.png"# adaptive_background_color: "#ffffff"adaptive_background_image:"assets/ic_background.png"adaptive_foreground_image:"assets/ic_foreground.png"adaptive_round_image:"assets/ic_logo_round.png"adaptive_monochrome_image:"assets/ic_black_white.png"ios:enable:trueimage_path:"assets/ic_logo_rectangle_light.png"# For iOS 18+ (support dark and tinted)dark_path:"assets/ic_logo_rectangle_dark.png"tinted_path:"assets/ic_logo_rectangle_tinted.png"web:enable:falseimage_path:"assets/ic_logo_rectangle_light.png"maskable_image_path:"assets/ic_logo_radius.png"favicon_path:"assets/ic_logo_round.png"# favicon_output_extension: ".ico"macos:enable:falseimage_path:"assets/macos_icon.png"windows:enable:falseimage_path:"assets/ic_logo_radius.png"linux:enable:falseimage_path:"assets/ic_logo_radius.png"