Generate iOS App Icons with AI
12 Xcode-ready sizes with Apple superellipse masking. Drag the AppIcon.appiconset folder into your asset catalog.
Why iOS App Icons Are Annoying to Get Right
Apple requires a specific set of sizes — not just one image that gets scaled. Each size serves a different context: the home screen, Spotlight search, Settings, notifications, the App Store itself. Miss one and Xcode gives you a build warning. Miss the 1024x1024 and App Store Connect rejects your upload outright.
On top of that, iOS applies a superellipse mask (the "squircle") to every app icon. You cannot include this shape in your source image — Apple clips it automatically. Your source file must be a full square with no rounded corners, no transparency, and content that extends to all four edges.
No transparency allowed
Complete iOS Icon Size Reference
These are the 12 sizes Xcode expects in a universal app that supports iPhone, iPad, and Mac Catalyst. Point sizes and scale factors determine the actual pixel dimensions.
| Context | Points | Scale | Pixels | Filename |
|---|---|---|---|---|
| iPhone Notification | 20x20 | 2x | 40x40 | icon-20@2x.png |
| iPhone Notification | 20x20 | 3x | 60x60 | icon-20@3x.png |
| iPhone Settings | 29x29 | 2x | 58x58 | icon-29@2x.png |
| iPhone Settings | 29x29 | 3x | 87x87 | icon-29@3x.png |
| iPhone Spotlight | 40x40 | 2x | 80x80 | icon-40@2x.png |
| iPhone Spotlight | 40x40 | 3x | 120x120 | icon-40@3x.png |
| iPhone App | 60x60 | 2x | 120x120 | icon-60@2x.png |
| iPhone App | 60x60 | 3x | 180x180 | icon-60@3x.png |
| iPad App | 76x76 | 2x | 152x152 | icon-76@2x.png |
| iPad Pro App | 83.5x83.5 | 2x | 167x167 | icon-83.5@2x.png |
| Mac | 128x128 | 1x/2x | 128/256 | icon-128.png |
| App Store | 1024x1024 | 1x | 1024x1024 | icon-1024.png |
The 1024x1024 matters most
Installing in Xcode
The download from Iconello includes an AppIcon.appiconset folder with all icon files and a valid Contents.json manifest. Installation takes about ten seconds:
- Open your Xcode project and navigate to Assets.xcassets in the project navigator.
- Delete the existing AppIcon set (right-click > Delete).
- Drag the
AppIcon.appiconsetfolder from the Iconello download directly into the asset catalog sidebar. - Xcode reads the Contents.json and maps every file to the correct slot. All slots should show the icon — no yellow warnings.
- Build and run. The icon appears on the home screen and in the Settings app immediately.
What's in Contents.json
Contents.json tells Xcode which image file corresponds to which size/scale/idiom combination. Writing this by hand is tedious and error-prone. Here is what a typical entry looks like:
{
"images": [
{
"filename": "icon-20@2x.png",
"idiom": "iphone",
"scale": "2x",
"size": "20x20"
},
{
"filename": "icon-60@3x.png",
"idiom": "iphone",
"scale": "3x",
"size": "60x60"
},
{
"filename": "icon-1024.png",
"idiom": "ios-marketing",
"scale": "1x",
"size": "1024x1024"
}
],
"info": {
"author": "iconello",
"version": 1
}
}The idiom field specifies the device family: iphone, ipad,mac, or ios-marketing (the App Store icon). Get the idiom wrong and Xcode silently ignores the image — it will show up in the file list but the icon slot remains empty.
iOS 18 Dark Mode Variants
Starting with iOS 18, users can switch their home screen to dark mode or tinted mode, and app icons adapt. Apple introduced two new appearance modes for icons:
Dark Mode
A separate icon variant with darker background colors and adjusted contrast. If you provide a dark variant, iOS uses it automatically when the user enables dark mode icons. If you do not, iOS applies its own darkening algorithm, which often looks washed out.
Tinted Mode
iOS applies a monochrome tint based on the user's wallpaper color. For this mode, you provide a single-channel (grayscale) version of your icon. iOS colorizes it using the user's selected tint.
Providing dark mode icons is optional but recommended
What Iconello Handles for You
- Generates all 12 sizes individually (not just downscaled from 1024)
- Fills the canvas completely — no transparency, no alpha channel
- Writes a valid Contents.json with correct idiom/scale/size mappings
- Packages everything in an AppIcon.appiconset folder ready for drag-and-drop
- Optionally generates dark mode and tinted variants for iOS 18
- Premium users get 4 unique design directions per prompt
Frequently Asked Questions
What Xcode version is the output compatible with?
The generated asset catalog works with Xcode 14 and later. The Contents.json format follows Apple's current specification, including the single-size icon format introduced in Xcode 14 where you can optionally provide just a 1024x1024 and let Xcode scale down. Iconello still provides all individual sizes for the sharpest result at each resolution.
Does the icon include rounded corners?
No — and it should not. iOS applies the superellipse mask at render time. If you bake rounded corners into the source file, you end up with visible artifacts where the baked shape does not perfectly match Apple's mask. Always supply a full square.
Can I customize the icon after generation?
Yes. Every file in the download is a standard PNG. Open it in any image editor — Photoshop, Pixelmator, GIMP — make your changes, and save it back. The Contents.json references files by name, so keep the filenames unchanged.