iOS app icon generator

How iOS app icons work

iOS shows your icon on the home screen, in Spotlight, Settings, notifications and the App Store. Since Xcode 14 the asset catalog only needs a single 1024×1024px image and Xcode renders the smaller sizes at build time. The icon must be a square, opaque PNG without rounded corners: iOS applies its own continuous-corner mask.

iOS 18 added two optional appearances. The dark icon has a transparent background so the system can place it on a dark gradient, and the tinted icon is grayscale so iOS can color it with the user's tint.

Add the icon in Xcode

1. Open Assets.xcassets (React Native: ios/YourApp/Images.xcassets).
2. Replace the contents of AppIcon.appiconset with the files from the ZIP, or delete the old set and drag the new one in.
3. In the target's General tab, check that App Icon is set to AppIcon.
4. Delete the app from the simulator and run it again to clear the cached icon.

The single-size Contents.json with dark and tinted variants looks like this:

{
  "images": [
    { "filename": "AppIcon-1024.png", "idiom": "universal", "platform": "ios", "size": "1024x1024" },
    { "appearances": [{ "appearance": "luminosity", "value": "dark" }],
      "filename": "AppIcon-1024-dark.png", "idiom": "universal", "platform": "ios", "size": "1024x1024" },
    { "appearances": [{ "appearance": "luminosity", "value": "tinted" }],
      "filename": "AppIcon-1024-tinted.png", "idiom": "universal", "platform": "ios", "size": "1024x1024" }
  ],
  "info": { "author": "xcode", "version": 1 }
}

Legacy iOS icon sizes

Choose All sizes in the generator if your project still lists every size in the asset catalog:

Sizes for every platform are in the app icon size cheat sheet.