ikonMaker Workflows

Choose the path that matches your Xcode project — iOS, macOS, 1024 only, or both.

Guides

DocContents
User GuideQuick start, crop modes, 1024 export, Xcode drag-in
FeaturesPlatform matrix, size tables, single-size sets, screenshots
Product pageOverview and size matrices

New iOS app — App Store icons

Drop image→iOS→Export→Xcode Assets
  1. Drop a 1024×1024 or larger square source (PNG, JPEG, HEIC, TIFF, PDF).
  2. Select iOS as the export target.
  3. Choose center crop (full bleed art) or fit with padding (logo-safe).
  4. Export — you get a full multi-size AppIcon.appiconset and root {base}-1024.png.
  5. Drag the appiconset into Assets.xcassets in Xcode.
  6. Archive and upload — Connect validates the 1024 marketing icon.

1024×1024 only — marketing + single-size catalogs

Drop image→1024×1024→PNG + single-size sets
  1. Select platform 1024×1024.
  2. Export produces:
    • Root {baseName}-1024.png for App Store Connect
    • iOS-SingleSize-AppIcon.appiconset (universal / ios / 1024×1024)
    • macOS-SingleSize-AppIcon.appiconset (mac / macos / 1024×1024)
  3. Use single-size sets when your Xcode project uses a single 1024 App Icon instead of the classic multi-size matrix.

New macOS app — Mac App Store

Drop image→macOS→.icns + iconset + 1024
  1. Select macOS export.
  2. Export produces AppIcon.appiconset, MacAppIcon.iconset, .icns, root {base}-1024.png, and MacAppStoreScreenshots/.
  3. Add the app icon set to your Mac target’s asset catalog.
  4. Use .icns where a standalone icon file is required.

Universal iOS + macOS release — iOS + macOS together

  1. Select macOS + iOS before export.
  2. ikonMaker writes a timestamped folder ikonMaker-{name}-{timestamp} with all sets + root 1024 PNG + screenshots.
  3. Copy the iOS set into your iPhone/iPad project and the macOS set into your Mac project.
  4. Keep the same source image and crop mode for visual consistency across stores.

Mac App Store screenshots only

Drop UI capture→Mac screenshots→5 PNGs
  1. Select Mac screenshots.
  2. Export writes 1280×800, 1440×900, 1800×1200, 2560×1600, 2880×1800 into MacAppStoreScreenshots/.
  3. Center crop fills 16:10; fit-with-padding letterboxes on white.

Replace icons in an existing project

  1. Export a fresh AppIcon.appiconset from ikonMaker.
  2. In Xcode, delete or replace the existing App Icon entry in Assets.
  3. Drag the new AppIcon.appiconset folder into the catalog.
  4. Confirm target membership (main app and App Clip if applicable).
  5. Clean build folder, then archive to verify icon slots are complete.

App Clip

Two separate jobs — do not mix them.

  1. App Clip app icon: preset iOS or 1024. Put that AppIcon.appiconset on the App Clip target. Same 1024 RGB, no-alpha rules as the main app.
  2. App Store Connect header: preset App Clip only. That writes AppClipHeader/ at 1800×1200 JPEG + PNG. It is a marketing header, not an app icon, and is never generated with a normal iOS icon export.