ios-icon-fix
Remove alpha channel (transparency) from iOS app icons. Apple App Store rejects icons with transparency. Use this after regenerating app icons or before iOS archive/upload to fix the "Invalid large app icon - can't be transparent or contain an alpha channel" error.
When & Why to Use This Skill
The ios-icon-fix skill is a specialized utility designed to automatically remove alpha channels (transparency) from iOS app icons. It ensures that all icons within an .appiconset directory meet strict Apple App Store submission requirements by compositing images onto a solid white background, effectively resolving the common 'Invalid large app icon' error during the upload process.
Use Cases
- App Store Submission Fix: Resolve the 'Invalid large app icon' error when Apple App Store Connect rejects icons containing transparency or alpha channels.
- Post-Design Asset Cleanup: Automatically process app icons generated by AI tools or design software that default to transparent backgrounds before archiving the iOS project.
- CI/CD Pipeline Integration: Use as a pre-flight check in mobile development workflows to ensure all visual assets are compliant with Apple's technical specifications before TestFlight or App Store distribution.
| name | ios-icon-fix |
|---|---|
| description | Remove alpha channel (transparency) from iOS app icons. Apple App Store rejects icons with transparency. Use this after regenerating app icons or before iOS archive/upload to fix the "Invalid large app icon - can't be transparent or contain an alpha channel" error. |
iOS Icon Fix
Remove alpha channel from iOS app icons to comply with Apple App Store requirements.
When to Use
- Before uploading to App Store Connect / TestFlight
- After regenerating iOS app icons
- When you see error: "Invalid large app icon... can't be transparent or contain an alpha channel"
Usage
Run the script:
python3 .claude/skills/ios-icon-fix/scripts/remove_alpha.py
Or specify a custom path:
python3 .claude/skills/ios-icon-fix/scripts/remove_alpha.py path/to/AppIcon.appiconset
What It Does
- Finds all PNG icons in the appiconset directory
- For each icon with alpha channel:
- Creates white background
- Composites the icon onto it
- Saves without alpha
- Verifies all icons have no transparency
Requirements
- Python 3
- Pillow:
pip install Pillow
Default Icon Location
decentpaste-app/src-tauri/gen/apple/Assets.xcassets/AppIcon.appiconset/