| name | icon-xcode-wire |
| description | Wire a .icon bundle into an Xcode project asset catalog. Use when icon-composer context reports xcode-project or the user has an .xcodeproj but no App Icon in Assets.xcassets. |
Xcode asset catalog wiring
Detect project
icon-composer context --json
Note signals.xcode_projects and signals.asset_catalogs.
If no bundle yet
Create one first (icon-from-logo or icon-from-scratch), output e.g. ./out/AppIcon.icon.
Add to Xcode
- Open the
.xcodeproj in Xcode.
- Open
Assets.xcassets (path from context signals when present).
- Drag
AppIcon.icon into the catalog or copy the bundle folder beside other assets.
- In target General → App Icons, select the new icon set (iOS 26+
.icon format).
Validate
icon-composer preview ./out/AppIcon.icon preview.png
icon-composer export-marketing ./out/AppIcon.icon marketing.png --size 1024
Keep marketing.png for App Store Connect uploads (flat, no alpha).
CI note
Bundle creation and flat export work on Linux CI; Liquid Glass render needs macOS runners with Icon Composer.