visionOS App Icons: Layered Assets and Target Validation

Start from the visionOS asset type

Use the icon stack provided by the target’s asset catalog. Apple’s asset-catalog documentation distinguishes layered visionOS and tvOS assets from iOS icon appearances. Do not substitute an ordinary image set or hand-written iOS manifest.

Give each layer a purpose

Keep the foreground symbol readable and avoid filling every layer with competing detail. Preserve editable sources so depth and overlap can be adjusted after previewing. Do not assume an illustrative shadow is a replacement for the system’s layered rendering.

Preview the real composition

Build and inspect the icon in the target’s supported preview or simulator workflow, then on a device when available. Check cropping, overlaps and small-size recognition. This guide does not promise a special simulator “ambient light” control or certify every possible environment from one preview.

Separate platform packages

An iOS light/dark/tinted raster set and a layered visionOS stack solve different problems. Reuse a brand motif if appropriate, but prepare each target’s actual files. Keep a release checklist for each platform rather than assuming one export covers all of them.

Validate before submission

Check the project’s target selection and bundle contents, then review the installed presentation. Treat visual review and asset validation as separate checks. Neither establishes ownership of artwork or guarantees approval.

IconBundlr export and purchase scope

IconBundlr’s native iOS export contains three 1024×1024 PNG appearance assets (light, dark and tinted) and Contents.json inside AppIcon.appiconset. Appearance processing is best-effort: if foreground extraction cannot produce a distinct variant, a slot can reuse the light artwork. Review each result in Xcode. This is an iOS asset catalog, not an Icon Composer .icon file or a complete Android, macOS, watchOS, tvOS or visionOS package.

IconBundlr is free to download, with limited free generation. Available in-app purchase options can include a renewing subscription, lifetime export access and individual-icon unlock credits. The app shows the current price, included access, renewal terms and any eligibility requirements in your storefront before purchase. A subscription is not a lifetime purchase, and an icon credit does not grant unlimited generation.

Review generated artwork before publishing. An export purchase does not guarantee originality, exclusivity, trademark clearance or App Store acceptance. Check your inputs and any third-party artwork, fonts or marks against their applicable rights and the app’s terms. Read the terms.

Frequently asked questions