← Sammy Gutiérrez

Icon Composer Fails on Xcode Cloud: Check Your Filename Case

February 6, 2026

If you're using Xcode 26's Icon Composer and your archive builds fail on Xcode Cloud with this:

The layer "mic" references an image named "mic.svg" that does not exist.
Icon export exited with status 255, signal 0

The cause is probably a filename case mismatch in git.

The Cause

Xcode Cloud uses a case-sensitive APFS volume. Your Mac almost certainly uses a case-insensitive one.

If you ever renamed an SVG file's case (say, from Mic.svg to mic.svg), macOS treats them as the same file. But git doesn't detect case-only renames on a case-insensitive filesystem, so it continues to track the file under the old name.

Verify with:

git ls-files -- 'YourApp.icon/'

If you see Mic.svg but your icon.json references mic.svg, that's the problem.

The Fix

Use git mv to update the index:

git mv YourApp.icon/Assets/Mic.svg YourApp.icon/Assets/mic.svg

Commit and push. Git will record the rename, and CI will check out the files with the correct case.