Xcode asset catalog builder

Xcode App Icon Generator

Turn one icon into a complete AppIcon.appiconset with matching PNGs and Contents.json.

Choose the modern 1024×1024 Single Size workflow or export the classic iPhone, iPad, and App Store compatibility slots. Every image is flattened to an opaque square and packaged locally in your browser.

Modern 1024 Single Size18 compatibility slotsContents.json includedLocal browser processing
Xcode asset catalog workbench / local sessionWaiting for artwork

Upload a 1024×1024 Xcode App Icon

Start with a finished square master. A 1024px or larger raster image avoids upscaling; SVG also renders cleanly into every compatibility slot.

PNG · JPG · WEBP · SVG / MAX 10 MB / 1024×1024 RECOMMENDED

Choose the Xcode contract

Xcode App Icon Sizes: Single Size vs All Sizes

Modern Xcode can derive iPhone and iPad variants from one 1024×1024 image. The compatibility mode is for projects that retain explicit point-and-scale slots or teams that tune artwork at smaller sizes.

The 18 compatibility outputs are catalog slots, not 18 required designs. Current Xcode All Sizes catalogs can leave slots unassigned, and Single Size is the simpler default for most new iOS projects.

Recommended

Modern Xcode: One 1024×1024 Universal Icon

Generates one opaque Default appearance PNG and a universal iOS manifest entry. Xcode creates the smaller device representations.

1 PNG · 1024×1024 · universal

Xcode All Sizes: iPhone, iPad, and App Store Slots

Generates the complete classic 18-slot matrix so every idiom, point size, and scale has a named PNG.

8 iPhone · 9 iPad · 1 App Store
DecisionModern Single SizeAll Sizes compatibility
Best forNew iOS and iPadOS projects with one finished 1024px masterOlder catalogs, handoff packages, or deliberate small-size tuning
PNG output1 universal 1024×1024 PNG18 slot files across 13 unique pixel dimensions
Manifest mappinguniversal + platform iOS + 1024 sizeiPhone, iPad, and iOS marketing idioms with point size and scale
Artwork controlOne appearance stays identical at every derived sizeFiles can be replaced later when a small slot needs custom detail

From ZIP to asset catalog

How to Add AppIcon.appiconset to Xcode

The download opens directly to the asset set folder. Keep the PNG files and Contents.json together so Xcode can resolve every manifest entry.

  1. 01

    Download and Unzip the App Icon Set

    Generate the chosen mode, download AppIcon.appiconset.zip, and expand it without renaming or separating its files.

  2. 02

    Open Assets.xcassets in Xcode

    In the project navigator, open the asset catalog assigned to your application target and locate the existing AppIcon set.

  3. 03

    Replace the Existing AppIcon.appiconset

    Quit any active file rename, then drag the generated folder into the asset catalog or replace the matching folder in the project.

  4. 04

    Build and Inspect the Target

    Confirm the target's App Icons Source points to AppIcon, then build and review the icon on the devices and appearances you support.

Manifest anatomy

How Contents.json Maps App Icon Sizes in Xcode

Xcode reads the manifest rather than guessing from filenames. Each images entry identifies the intended catalog slot; the filename then connects that slot to the PNG beside Contents.json.

AppIcon.appiconset / Contents.json
{
  "images": [{
    "filename": "AppIcon-1024.png",
    "idiom": "universal",
    "platform": "ios",
    "size": "1024x1024"
  }],
  "info": { "author": "xcode", "version": 1 }
}

filename

References a PNG inside the same AppIcon.appiconset directory. Every generated reference is checked before packaging.

idiom and platform

Modern output uses the universal idiom with the iOS platform. Compatibility output identifies iPhone, iPad, or iOS marketing.

size and scale

Compatibility slots express points and @1x, @2x, or @3x scale; multiplying them gives the required PNG pixel dimension.

info

The catalog metadata declares author xcode and format version 1, matching the asset catalog convention.

Before the first build

Xcode App Icon Export Checklist

Generation solves the file and manifest work. A short visual review still protects the final icon across system masks, devices, and App Store presentation.

Use an Opaque, Full-Square Design

Avoid transparent edges. The selected background is flattened behind every PNG so no alpha remains in the Xcode output.

Do Not Bake In Rounded Corners

Keep the exported canvas square. iOS applies its own mask; pre-rounded artwork can create visible borders or double rounding.

Treat Dark and Tinted as Separate Artwork

This first release generates only the Default appearance. It never duplicates that image into fake Dark or Tinted variants.

Verify in Your Xcode Project

Check target settings, catalog warnings, device previews, and a real build. Automated package checks do not replace project-level validation.

Appearance variants

Default Included; Dark and Tinted Stay Optional

When custom variants are absent, the system can derive them. A proper Dark asset may use transparency and a Tinted asset should be grayscale, so neither can be reconstructed honestly from every flat source.

Layered Apple icons

This Is Not an Icon Composer .icon File

Apple Icon Composer preserves layers and Liquid Glass adjustments. A flat upload cannot recover that structure, so this tool deliberately exports a traditional AppIcon.appiconset.

Different output jobs

Xcode Generator vs Cross-Platform Generator and Resizer

Use this page for a focused Xcode asset catalog. Choose the cross-platform generator for iOS plus Android resources, or the resizer for loose PNG size files without catalog metadata.

Official Xcode App Icon and Asset Catalog References

The modes, terminology, and cautions on this page were reviewed against Apple guidance. The final project build remains the authoritative validation for your Xcode version and target.

Xcode App Icon Generator FAQ

Answers about 1024×1024 source files, Single Size, compatibility slots, transparency, Contents.json, Icon Composer, and local processing.

What size image should I upload to the Xcode app icon generator?

Use a square 1024×1024 PNG, JPG, or WebP, or upload an SVG that can render cleanly at that size. A smaller raster file can be enlarged, but the generated 1024px App Store image cannot recover missing detail.

Does modern Xcode need every iPhone and iPad app icon size?

No. Modern Xcode supports a Single Size workflow that starts from one 1024×1024 icon and derives smaller representations. Use All Sizes compatibility only when your project or handoff needs explicit point-and-scale slots.

Are all 18 compatibility PNGs required by Apple?

No. They represent the complete classic iPhone, iPad, and App Store slot matrix, not 18 universally required designs. Current Xcode All Sizes catalogs can leave slots unassigned; this tool fills the matrix to make a self-contained compatibility package.

Can an Xcode app icon have a transparent background?

The Default app icon should not rely on transparency, so this generator flattens every PNG onto the selected opaque color. Custom Dark appearance artwork follows different guidance and is not generated in this first release.

Does the generator add rounded corners to the PNG files?

No. Every exported PNG remains a full square. The rounded outline in the preview shows how a system mask may frame the artwork; iOS applies the real mask at display time.

What does Contents.json do inside AppIcon.appiconset?

It maps each PNG filename to an asset catalog slot. Modern output uses a universal iOS 1024 entry; compatibility output records idiom, point size, and scale for each iPhone, iPad, and App Store slot.

Does this tool create Dark, Tinted, or Icon Composer assets?

No. It creates the Default appearance in a traditional AppIcon.appiconset. It does not copy artwork into misleading Dark or Tinted variants, and it cannot create the layered .icon file produced by Apple Icon Composer.

Is my app icon uploaded to a server?

No. Image reading, SVG sanitization, resizing, PNG encoding, manifest creation, preview, and ZIP packaging all happen in your browser. LogoFoundry does not receive or store the selected artwork.