launcher_icons 0.15.0

Thorough, predictable flutter app launcher icon generation & integration across all platforms!

Changelog

0.15.0 - 2026-09-19

⚠ BREAKING CHANGES

• remove dead hasPlatformConfig gate
• remove dead minSdk apparatus
• rebrand flutter_launcher_icons to launcher_icons
• remove deprecated windows.icon_size, flutter_icons key and main shim
• modern universal iOS icon set for all paths, drop legacy list (fluttercommunity/flutter_launcher_icons#528)
• nested android/ios config schema, v3 breaking change (fluttercommunity/flutter_launcher_icons#394)

Features

• accept http(s) image URLs for icon sources (fluttercommunity/flutter_launcher_icons#511) (c764545)
• add android notification icon (9be7f55)
• add config options for linux (8da01fa)
• add ios & macos liquid glass further configs (d57c215)
• add Linux support (5766570)
• add Linux support (fluttercommunity/flutter_launcher_icons#647) (5766570)
• add liquid glass .icon support for macOS (c7295fc)
• add version flag (d4b211c)
• added support for android 13+ themed icons (fluttercommunity/flutter_launcher_icons#497) (8c45d48)
• android adaptive_icon_round opt-in and play_store_icon sidecar (540930b)
• build web favicon from a different source image (fluttercommunity/flutter_launcher_icons#519) (1b28150)
• cli-option: added --prefix option (0381010)
• command to generate config file template (48cf387)
• configs: added new configs to FlutterLauncherIconsConfig (2547d96)
• configurable web favicon size (fluttercommunity/flutter_launcher_icons#614) (6b3027b)
• Configure dark and tinted mode icons for iOS 18+ (fluttercommunity/flutter_launcher_icons#569) (4e66457)
• continuous-corner squircle mask for rounded_corners (7240143)
• custom xcodeproj path for renamed Xcode projects (fluttercommunity/flutter_launcher_icons#637) (84e4b33)
• declare flavor variants as launcher_icons-<flavor> sections (4517781)
• dedicated web image_path_maskable source with padded fallback (ca1233d)
• display command to run to use config file (bdaeb53)
• emit favicon.ico alongside favicon.png (fluttercommunity/flutter_launcher_icons#540) (c20ee1d)
• extend & refactor web to include all potential iconography (4a40a12)
• flavor-aware macOS icon sets (fluttercommunity/flutter_launcher_icons#638) (cd6d1fc)
• fli cli improvement (dfe594d)
• improve windows icon generation capabilities (6d63f9b)
• ios xcconfig flavor mode with hardened pbxproj matching (17c7b1f)
• linux derives a runtime raster from SVG sources (82ab206)
• linux hicolor tree, desktop entries, and snap packaging (428a2a0)
• liquid glass icon support (fluttercommunity/flutter_launcher_icons#650) (a4777c4)
• liquid glass lighting, refractivity, and specular placement (72e890b)
• liquid glass per-appearance layer specializations (06bf883)
• logger: added logger (b3fbd4f)
• macOS padding and rounded-corner icon options (fluttercommunity/flutter_launcher_icons#463, fluttercommunity/flutter_launcher_icons#655) (c5679ab)
• macos: added support for macos icons (9e8e13b)
• modern universal iOS icon set for all paths, drop legacy list (fluttercommunity/flutter_launcher_icons#528) (7b06517)
• multi-layer liquid glass icons with per-layer composition (3e1b755)
• multi-size favicon.ico with opt-out and CSS hex validation (2f438be)
• multi-size windows .ico by default, deprecate icon_size (fluttercommunity/flutter_launcher_icons#651) (0778d78)
• nested android/ios config schema, v3 breaking change (fluttercommunity/flutter_launcher_icons#394) (29533f7)
• non-root flavor configuration file discovery (fluttercommunity/flutter_launcher_icons#664) (55493e7)
• route status output through FLILogger with print fallback (fluttercommunity/flutter_launcher_icons#552) (bb3669c)
• shared FLIException base class for package errors (fluttercommunity/flutter_launcher_icons#378) (72cea01)
• single-size iOS icon mode (fluttercommunity/flutter_launcher_icons#592) (b4013c9)
• svg sources with per-size rasterization opt-in (bbba10c)
• transparent adaptive icon background keyword (fluttercommunity/flutter_launcher_icons#535) (df556b1)
• try flutter_launcher_icons.yaml config file first and allow overriding configFile (fluttercommunity/flutter_launcher_icons#60) (6c1b3c0)
• web output_path for separate flavor roots (fluttercommunity/flutter_launcher_icons#426) (4f6920d)
• web: constants for web platform (3c3ce79)
• web: support for web icons (a79ec01)
• windows icon_filename override, 40/64 frames, upscale warning (d2a93ca)
• windows: add support for windows closes fluttercommunity/flutter_launcher_icons#380 (2444dfb)
• windows: generate multi-size .ico by default; deprecate windows.icon_size (0778d78)

Bug Fixes

• accept any pubspec-declared asset path for linux (b246b99)
• android: minSdk not found closes fluttercommunity/flutter_launcher_icons#384 (1f5f0f8)
• android: show blank icon if no adaptive icon set (fluttercommunity/flutter_launcher_icons#601) (5dc44fa)
• atomic pbxproj writes and loud warning for missing flavor keys (fluttercommunity/flutter_launcher_icons#636, fluttercommunity/flutter_launcher_icons#341) (f6d6af8)
• avoid leaving stale ios & macos folders on failed runs (f11f881)
• bootstrap a missing macos icon set instead of crashing (b1ead43)
• clean stale legacy icons and orphaned flavor catalogs (ffce0f1)
• clear stale adaptive icons when config is not adaptive (fluttercommunity/flutter_launcher_icons#328) (c934ba5)
• code was always getting rid of trailing \n (b64da82)
• collect per-platform failures and exit non-zero (442ce6f)
• config: type error when invalid config is passed (ef52d02)
• correct background channels in iOS alpha blending (fluttercommunity/flutter_launcher_icons#514) (97e8acd)
• detect adaptive background image paths (406b463)
• detect adaptive background image paths (fluttercommunity/flutter_launcher_icons#670) (406b463)
• don't add newline in Android manifest each time (da64d63)
• emit canonical plain monochrome XML at zero inset (63fb69c)
• example: added example for pub.dev closes fluttercommunity/flutter_launcher_icons#402 (199598e)
• explicit -f custom file bypasses flavor loop (fluttercommunity/flutter_launcher_icons#426) (cf5f3ac)
• explicit -f flavor file runs only that flavor (fluttercommunity/flutter_launcher_icons#215) (a6cf3ff)
• fail loudly when no platform is enabled (f77c6eb)
• fixes the issue where the dark and tinted icons were placed in the wrong directory (fluttercommunity/flutter_launcher_icons#597) (8bd7f9a)
• generator: fixed typo in a method (61e3d6b)
• hand-holding error for removed windows.icon_size (b021d4e)
• hand-maintain version.dart, drop build_version (3a61f75)
• ignore commented minSdkVersion (5cb7eb8)
• ignore commented minSdkVersion (819b8fd)
• include 1x switcher sizes in modern iOS icon set (fluttercommunity/flutter_launcher_icons#661) (b252893)
• Incorrect version number shown (d3f5d77)
• Incorrect version number shown (ed733cd)
• json indentation (e2d25e6)
• lint: filxed lint warnings for public_member_api_docs (05a12e2)
• lint: filxed lint warnings for require_trailing_commas (f815295)
• logging: added verbose logging to platform failure (860c84a)
• minSdk lookups tolerate missing files, fall back to default (fluttercommunity/flutter_launcher_icons#644) (23aae3e)
• no longer printing creating icons message for unused platforms (99a92be)
• normalize bare hex colors written to colors.xml (fluttercommunity/flutter_launcher_icons#673) (4233061)
• normalize flag semantics (ae4ee3e)
• only update app-icon related configs (fluttercommunity/flutter_launcher_icons#549) (3ffe772)
• per-variant remove_alpha with unified hex parsing (089e1e6)
• rasterize each SVG source once per run (63acc78)
• remove dead hasPlatformConfig gate (5d0de9d)
• remove dead minSdk apparatus (dc61973)
• resolve renamed Xcode projects when editing pbxproj (fluttercommunity/flutter_launcher_icons#543) (75ac5c5)
• route iOS through decodeImageFile with non-nullable return (719702f)
• sampled chroma scan for tinted validation (7c6d642)
• satisfy strict-casts with explicit casts and typed flag accessors (0b7e2f3)
• skip dark/tinted I/O entirely in iOS single-size mode (8919b53)
• stale generated template no longer shadows pubspec config (fluttercommunity/flutter_launcher_icons#628) (57696e2)
• stop enforcing test pixel contracts on example fixtures (5bd6c66)
• Success message printed on exception (fluttercommunity/flutter_launcher_icons#225) (80beb55)
• template: wrong attribute to remove alpha channel (fluttercommunity/flutter_launcher_icons#586) (3441875)
• tests fails for the newly generated list (fluttercommunity/flutter_launcher_icons#576) (85d009d)
• treat svg as image adaptive background, not colors.xml color (cb53b7d)
• typo in readme (fluttercommunity/flutter_launcher_icons#639) (2b25c9c)
• typos (e6fae79)
• warn instead of crashing on corrupt macOS Contents.json (3de6b38)
• web index.html updater and opaque apple-touch-icon (acc2f66)
• wire flavor configs that share the base xcconfig (a52fbbe)
• wire macOS flavor catalogs into project.pbxproj (ce7384d)
• write custom icon_name PNGs to their own catalog (0173c21)
• wrong PR mentioned in changelog (fluttercommunity/flutter_launcher_icons#584) (0dcac54)

Miscellaneous Chores

• rebrand flutter_launcher_icons to launcher_icons (7150da6)
• remove deprecated windows.icon_size, flutter_icons key and main shim (1b763c0)

0.14.4 (10th June 2025)

• Removed rules which no longer exist from analysis_options #598
• Fix template generated within thegenerate command #642
• Standardize on async I/O and waiting for work to complete #646

0.14.3 (17th January 2025)

• Android: Avoids creating mipmap file used by adaptive and monochrome icons if no config exist for both #601

0.14.2 (5th December 2024)

• iOS: Fixed issue where dark and tinted icons were placed into the wrong directory #597

0.14.1 (24th September 2024)

• Fixed README

0.14.0 (21st September 2024)

• Android: Support for monochrome icons #497

Before

Now

• Android: Ability to set inset for adaptive icon foreground and monochrome icon #563
• iOS: Dark and Tinted icons for iOS 18+ #569

0.13.1 (15th April 2023)

• Can now use flutter_launcher_icons instead of flutter_icons #478
• Can use command flutter pub run flutter_launcher_icons:generate to automatically generate config file #475

0.13.0 (7th April 2023)

• Fix remove alpha for iOS #464
• Updating code style #472
• Updated out of bounds dependency #473

0.12.0 (24th February 2023)

• Updated image package and other packages #447

0.11.0 (27th September 2022)

• Support for Macos Icons #407
• Cli-improvement #400
• Add repository and issue_tracker #411 (thanks to @patelpathik)
• Fix indent in web/manifest.json #407
• Fix the icons 50 and 57 in contents.json #412 (thanks to @adnanjpg)
• Fix typos #405 (thanks to @edwardmp)
• Added newline to EOF #325 (thanks to @sandersaelmans)

0.10.0 (2nd August 2022)

• Support for Web Icons #374
• Support for Windows Icons #382
• Added missing IOS icon sizes #298
• Added min_sdk_android option #392
• Added documentation for remove_alpha_ios #392
• Fixed issue with loading config from pubspec.yaml #398 (thanks to @p-mazhnik)

0.9.3 (6th June 2022)

• Fixes to make sure it works for Flutter v2.8 (thanks to @RatakondalaArun)
• Fixed issue with incorrect version being shown

0.9.2 (22nd August 2021)

• Fixed issue where success message printed even when exception occured (thanks to @happy-san)

0.9.1 (25th July 2021)

• Upgrade args dependency to ^2.1.1 (thanks to @PiN73 and @comlaterra)
• Upgraded image and test dependencies

0.9.0 (28th Feb 2021)

• Null-safety support added (thanks to @SteveAlexander)
• Added option to remove alpha channel for iOS icons (thanks to @SimonIT)

0.8.1 (2nd Oct 2020)

• Fixed flavor support on windows (@slightfoot)

0.8.0 (12th Sept 2020)

• Added flavours support (thanks to @sestegra & @jorgecoca)
• Removed unassigned iOS icons (thanks to @melvinsalas)
• Fixing formatting (thanks to @mreichelt)

0.7.5 (24th April 2020)

• Fixed issue where new lines were added to Android manifest (thanks to @mreichelt)
• Improvements to code quality and general tidying up (thanks to @connectety)
• Fixed Android example project not running (needed to be migrated to AndroidX)

0.7.4 (28th Oct 2019)

• Worked on suggestions from pub.dev

0.7.3 (3rd Sept 2019)

• Lot of refactoring and improving code quality (thanks to @connectety)
• Added correct App Store icon settings (thanks to @richgoldmd)

0.7.2 (25th May 2019)

• Reverted back using old interpolation method

0.7.1 (24th May 2019)

• Fixed issue with image dependency not working on latest version of Flutter (thanks to @sboutet06)
• Fixed iOS icon sizes which were incorrect (thanks to @sestegra)
• Removed dart_config git dependency and replaced with yaml dependency
• Refactoring of code

0.7.0 (22nd November 2018)

• Now ensuring that the Android file name is valid - An error will be thrown if it doesn't meet the criteria
• Fixed issue where there was a git diff when there was no change
• Fixed issue where iOS icon would be generated when it shouldn't be
• Added support for drawables to be used for adaptive icon backgrounds
• Added support for Flutter Launcher Icons to be able to run with it's own config file (no longer necessary to add to pubspec.yaml)

0.6.1 (26th August 2018)

• Upgraded test package
• Due to issue with dart_config not working with Dart 2.1.0, now using forked version of dart_config which contains fixes from both @v3rm0n and @SPodjasek

0.6.0 (8th August 2018)

• Moved the package to Flutter Community

0.5.2 (19th June 2018)

• Previous release didn't fix adaptive icons, just prevented the error message from appearing. This should hopefully fix it!

0.5.1 (18th June 2018)

• Fix for adaptive icons

0.5.0 (12th June 2018)

• [Android] Support for adaptive icons added (Suggestion #23)

0.4.0 (9th June 2018)

• Now possible to generate icons for each platform with different image paths (one for iOS icon and a separate one for Android)

0.3.3 (28th May 2018)

• Upgraded dart image package dependency to 2.0.0 (issue #26)

0.3.2 (2nd May 2018)

• Bug fixing

0.3.1 (1st May 2018)

• Bug fixing

0.3.0 (1st May 2018)

• Fixed issue where icons produced weren't the correct size (Due to images not with a 1:1 aspect r ation)
• Improved quality of smaller icons produced (Thanks to PR #17 - Thank you!)
• Updated console printed messages to keep them consistent
• Added example folder to GitHub project

0.2.1 (25th April 2018)

• Added extra iOS icon size (1024x1024)
• Fixed iOS default icon name (Thanks to PR #15 - Thank you!)
• Fixed issue #10 where creation of the icons was failing due to the target folder not existing

0.2.0 (18th January 2018)

• Ability to create new launcher icons without replacing the old ones added (#6)
• Fixed issue with launcher icons for iOS not correctly being set

0.0.5

• Quick Fix on if statement

0.0.4

• Fixing strong mode error

0.0.3

• Adding flutter as a dependency so its listed as a flutter package.

0.0.2

• Fix Doc typo

0.0.1

• Initial version, Resizes Icon to Android sizes only.