How to Export App Icons for Xcode

Getting your app icon into Xcode correctly is critical — a misconfigured asset catalog can cause build errors or fuzzy icons. Here's the complete guide for both manual and AI-powered workflows.

Method 1: Single Icon (Xcode 15+, Recommended)

Since Xcode 15, Apple simplified the process. You only need one 1024×1024 PNG.

1. Create your icon at exactly 1024×1024 pixels, PNG format, no transparency
2. Open your project in Xcode and navigate to Assets.xcassets
3. Select AppIcon in the asset catalog sidebar
4. Set "All Sizes" to "Automatic" in the Attributes Inspector (right panel)
5. Drag your 1024×1024 PNG into the single icon well
6. Build and run — Xcode generates all platform-specific sizes automatically

Method 2: Full .appiconset (Pixel-Perfect Control)

If you want to hand-optimize icons at small sizes (recommended for detailed icons):

1. Generate all sizes from your 1024×1024 master (use Sketch, Figma, or IconBundlr)
2. Create a folder named AppIcon.appiconset
3. Add a Contents.json manifest listing each image filename, size, scale, and platform
4. Drop all PNG files into the folder alongside Contents.json
5. Replace the existing AppIcon folder in Assets.xcassets with your new one

Method 3: AI-Powered with IconBundlr (Fastest)

IconBundlr combines icon generation and Xcode export into one step:

1. Describe your icon in plain English (e.g., "a purple rocket with gradient background")
2. AI generates multiple options — pick your favorite
3. Export as .appiconset — ready to drag directly into Xcode
4. Total time: ~2 minutes from concept to Xcode-ready

Common Mistakes to Avoid

• Transparency/Alpha: iOS rejects icons with alpha channels. Ensure your PNG has no transparency.
• Rounded corners: Never add rounded corners to your icon — iOS applies the supercircle mask automatically.
• Wrong resolution: The 1024×1024 icon must be exactly 1024×1024 pixels, not upscaled from a smaller image.
• Missing sizes: If using the manual method, every size in Contents.json must have a corresponding PNG file.

Frequently Asked Questions

What is an .appiconset?

An .appiconset is a folder inside an Xcode Asset Catalog that contains your app icon images and a Contents.json manifest. It tells Xcode which image to use for each platform and size.

Can I use a single icon for all sizes?

Yes, since Xcode 15. Provide a single 1024×1024 PNG and Xcode auto-generates all required sizes. This is the recommended approach.

Why does my icon look blurry on device?

Blurry icons usually mean your source image is too small or has been upscaled. Always start with a crisp 1024×1024 original.