What sizes Android needs, and why
Android sizes icons in density-independent pixels (dp). A launcher icon is 48 dp, and each screen density gets its own PNG so it stays sharp: 48 px for mdpi, 72 px for hdpi, 96 px for xhdpi, 144 px for xxhdpi and 192 px for xxxhdpi. These go in the mipmap-* folders, which Android keeps even when it strips unused densities from an app bundle, because a launcher may show an icon larger than the screen’s own density.
Since Android 8.0 (API 26) launchers use adaptive icons: a background layer and a foreground layer, each 108 × 108 dp. The launcher shows only the middle 72 × 72 dp and cuts it into a circle, squircle or rounded square depending on the phone maker. The extra 18 dp on each side is room for parallax and pulse effects. Google’s rule of thumb is to keep the logo within the inner 66 × 66 dp, because that is the part every mask keeps. That is why this tool defaults to a 66 dp logo, and why a logo that looks fine as a square can get its corners clipped on a Pixel. The mipmap-anydpi-v26/ic_launcher.xml file ties the two layers together; older Android versions fall back to the plain ic_launcher.png files.
Android 13 added themed icons, which tint a single-colour version of your logo to match the wallpaper. That needs a monochrome layer, which only works well if your logo has a transparent background, so it is an option here rather than a default.
iOS icon rules
- No transparency. iOS icons must be opaque. Transparent areas turn black on the home screen, and App Store Connect rejects a marketing icon with an alpha channel. This tool fills transparent areas with your background colour and saves the iOS PNGs without an alpha channel.
- No rounded corners in the file. Upload a full square. iOS applies the rounded mask itself, and pre-rounded corners show up as dark or light slivers in each corner.
- A 1024 × 1024 marketing icon. The App Store uses it on your product page, and Xcode expects it in the icon set. Recent Xcode versions can build every size from that one file, but Flutter’s template still ships the full set, so the zip does the same: 15 PNGs from 20 pt up to 83.5 pt for iPad Pro, at @1x, @2x and @3x, plus a Contents.json that lists them.
Where the files go in a Flutter project
- Commit or back up your project first, because the files replace the default Flutter icons.
- Copy the
android,ios,web(andmacos) folders from the zip into your project root and let them overwrite the existing files. The paths are the same onesflutter createmade, so nothing else needs to change;AndroidManifest.xmlalready points to@mipmap/ic_launcher. - If another values file already defines a colour called
ic_launcher_background, delete one of the two, or the Android build fails with a duplicate resource error. - The
storefolder is not part of the project: those are the files you upload to Google Play Console and App Store Connect.
If you prefer a config file, the flutter_launcher_icons package does the same job from pubspec.yaml. Use one or the other: running the package later overwrites these files.
How to check the new icon
Hot reload and hot restart do not change the launcher icon, and launchers cache icons hard. Run flutter clean, uninstall the app from the device or simulator, then run it again. On Android, also look at the icon in the app drawer and in the recent apps screen; on iOS, check Settings and Spotlight, which use the small 29 pt and 40 pt sizes where thin details disappear first.
Web and PWA icons
Flutter web’s manifest.json already lists Icon-192.png, Icon-512.png and their maskable versions. A maskable icon is drawn edge to edge, because Android and other platforms crop it to their own shape; only a circle 80% as wide as the icon is guaranteed to show. The zip’s maskable icons use a full background with your logo inside that area. The 32 px favicon.png is the browser tab icon.
Store listing icons
Google Play wants a 512 × 512 px, 32-bit PNG of up to 1 MB. Upload a full square: Play adds the rounded corners and shadow itself. The App Store takes its icon from the 1024 × 1024 px icon in your build, with no transparency and no rounded corners. Both files are in the zip’s store folder.
Questions
Is my image uploaded anywhere?
No. The image is read and resized with the canvas in your browser, and the zip is built on this page. Nothing is sent to a server.
What image should I start from?
A square PNG or SVG at 1024 × 1024 px or larger, without rounded corners or a drop shadow. For Android adaptive icons and themed icons, a logo on a transparent background works best; pick the background colour here.
Why is my Android icon cut off or tiny?
If the logo fills the whole image, the adaptive mask crops its edges. Lower the Android logo size so it stays within 66 dp. If it looks tiny, your image has built-in padding: crop it, or raise the size.
Do I still need all the iOS sizes?
Xcode 14 and later can generate them from a single 1024 px icon, but the full set from Flutter’s template works with every Xcode version and lets you check the small sizes yourself.
Related guide: read how to change the app icon in Flutter, step by step for Android, iOS and web, including adaptive and themed icons.
Want an app that looks this polished all the way through? I’m Muhammad Naeem, a Flutter developer with 10+ apps live on the stores. Tell me about your project.