Iconello
Xcode Ready

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

iOS will reject app icons with an alpha channel. Every pixel must be opaque. If your icon has a transparent background, fill it with a solid color before submitting. Iconello handles this automatically — the generated icons always have an opaque background.

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.

ContextPointsScalePixelsFilename
iPhone Notification20x202x40x40icon-20@2x.png
iPhone Notification20x203x60x60icon-20@3x.png
iPhone Settings29x292x58x58icon-29@2x.png
iPhone Settings29x293x87x87icon-29@3x.png
iPhone Spotlight40x402x80x80icon-40@2x.png
iPhone Spotlight40x403x120x120icon-40@3x.png
iPhone App60x602x120x120icon-60@2x.png
iPhone App60x603x180x180icon-60@3x.png
iPad App76x762x152x152icon-76@2x.png
iPad Pro App83.5x83.52x167x167icon-83.5@2x.png
Mac128x1281x/2x128/256icon-128.png
App Store1024x10241x1024x1024icon-1024.png

The 1024x1024 matters most

The App Store icon is the one potential users see first. It gets displayed at various sizes across the store — on search results, feature pages, and the app detail page. Making it look good at full resolution is worth the effort, because Apple will not let you upload a separate marketing image for this slot.

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:

  1. Open your Xcode project and navigate to Assets.xcassets in the project navigator.
  2. Delete the existing AppIcon set (right-click > Delete).
  3. Drag the AppIcon.appiconset folder from the Iconello download directly into the asset catalog sidebar.
  4. Xcode reads the Contents.json and maps every file to the correct slot. All slots should show the icon — no yellow warnings.
  5. 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:

AppIcon.appiconset/Contents.json (excerpt)
{
  "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

If you skip dark variants, iOS will auto-generate them. The auto-generated versions are passable but never as good as a purposefully designed dark icon. Iconello generates both light and dark variants automatically when you enable the dark mode option.

What Iconello Handles for You

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.

Skip the manual resize marathon

Describe your app, and get every iOS icon size in a ready-to-use Xcode asset catalog.