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.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
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/
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-02-04
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!