app-icon
Skill1 starsChanged 4 days agoMITView on GitHub
A Mac app icon made the way Apple's are - an Icon Composer file (AppIcon.icon, JSON plus SVG layers) the system turns into Liquid Glass, compiled with actool and reviewed in every look (default, dark, tinted, clear) and at 16 px. Works for SwiftUI, Electron and Tauri apps. Use when the user wants an app icon, a better icon, or a Dock icon.
5 other projects use a version of this, 2 of them edited.
Adopted by
Most recently taken up by
- Conceptual-Machines/magda-coretheir own version, first seen Nov 14, 2026
- Stijnus/dsh-rev-engedited, first seen Nov 8, 2026
- daveebbelaar/bawatheir own version, first seen Nov 8, 2026
- daveebbelaar/bamaedited, first seen Nov 1, 2026
- MohamedAbdallah-14/prompt-to-assettheir own version, first seen May 6, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 2
- daveebbelaar/bama★ 1.7k70% same
- Stijnus/dsh-rev-eng★ 171% same
Wrote their own version · 3
- Conceptual-Machines/magda-core★ 264same name
- MohamedAbdallah-14/prompt-to-asset★ 18same name
- daveebbelaar/bawa★ 17same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository20 other files it gives its agents.
- AGENTS.mdAGENTS.md
- agents-mdSkill
- buildSkill
- cloneSkill
- debugSkill
- design-systemSkill
- docker-optimizeSkill
- improve-loopSkill
- mac-appSkill
- mac-designSkill
- product-briefSkill
- quality-barSkill
- refactorSkill
- researchSkill
- reviewSkill
- start-hereSkill
- stop-overthinkingSkill
- ui-directorSkill
- user-storiesSkill
- ux-designSkill
The file
We split this skill into the rules it gives an agent
6 rules. 1 is common, 1 is distinctive, and 4 are very specific to this project.
1
Common
Most of the 5 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 73
No text, no letters, no screenshots of the UI.
- Very specific: line 87
Read docs/BRIEF.md. Write three icon concepts in one line each: the object, the background color, the layers.
- Common: line 91
Check: one concept is chosen and it uses no SF Symbol.
- Very specific: line 93
Write the layers as SVG files in Icon/AppIcon.icon/Assets/, on a 1024 x 1024 canvas, white filled shapes (rect with rx, circle, path).
- Very specific: line 98
Check: every image-name in icon.json has a file in Assets/.
- Very specific: line 102
Check: Assets.car and AppIcon.icns exist.
“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
App icon
The icon is an Icon Composer file in git: Icon/AppIcon.icon, a folder with icon.json and SVG
layers in Assets/. You write both by hand. macOS adds the glass, the highlights, the shadow, the
mask, and the dark, tinted and clear looks. You never draw those yourself.
Compile (Xcode 26 or later; an Xcode project compiles the .icon on its own):
xcrun actool Icon/AppIcon.icon --compile /tmp/icon-out --platform macosx \
--minimum-deployment-target 26.0 --app-icon AppIcon \
--output-partial-info-plist /tmp/icon-out/partial.plistIt writes Assets.car and AppIcon.icns. Copy both into the app's Contents/Resources/ and set
CFBundleIconName and CFBundleIconFile to AppIcon. Electron and Tauri: point the packager's
mac icon at the .icns, and add Assets.car to the bundle's resources for the glass looks.
Render a look to review it:
"$(xcode-select -p)/../Applications/Icon Composer.app/Contents/Executables/ictool" \
Icon/AppIcon.icon --export-image --output-file /tmp/icon-dark.png \
--platform macOS --rendition Dark --width 256 --height 256 --scale 2Renditions used for review: Default, Dark, TintedDark, ClearLight.
The file
Icon/AppIcon.icon/
icon.json
Assets/front.svg 1024 x 1024 canvas, same as the icon
Assets/back.svg{
"fill" : { "automatic-gradient" : "srgb:0.20000,0.42000,0.96000,1.00000" },
"groups" : [
{
"layers" : [
{ "glass" : true, "image-name" : "front.svg", "name" : "front" },
{ "glass" : true, "image-name" : "back.svg", "name" : "back", "opacity" : 0.6 }
],
"shadow" : { "kind" : "neutral", "opacity" : 0.5 },
"translucency" : { "enabled" : true, "value" : 0.5 }
}
],
"supported-platforms" : { "squares" : [ "macOS" ] }
}fillis the background:solid,automatic-gradient(one color, the system adds a soft gradient), orlinear-gradientwith two colors. Colors aresrgb:r,g,b,aordisplay-p3:r,g,b,a.- The first layer in the list sits on top.
- Shadow
kind:neutral,layer-color, ornone. - A different look per appearance goes in
<key>-specializations, for examplefill-specializationswith an entry fordark. - The art fills the whole square. Never draw the rounded square, a margin, a shadow, or a sheen: the system adds them.
What makes it look like Apple made it
- One idea. One object that says what the app does: a check for tasks, a stack of cards for a reader, a waveform for audio.
- No text, no letters, no screenshots of the UI.
- The glyph is your own drawing. Never use an SF Symbol, or a shape that looks like one: the SF Symbols license forbids symbols in app icons.
- Two or three layers, each one flat shape in white or one tint. Glass gives the depth. Put the main shape on top, a softer one behind it.
- The glyph is large: about 45 to 55 percent of the canvas width. Thin parts vanish at 16 px.
- Filled shapes only. A stroke on an open path leaves a faint glass line.
- One background hue.
automatic-gradientlooks right almost every time. - Distinct from the apps next to it in the Dock. List Dock apps without a
screenshot:
defaults read com.apple.dock persistent-apps | grep file-label.
Steps
Read
docs/BRIEF.md. Write three icon concepts in one line each: the object, the background color, the layers. Pick one with the user, or pick the one that is easiest to recognize at 16 px.Check: one concept is chosen and it uses no SF Symbol.
Write the layers as SVG files in
Icon/AppIcon.icon/Assets/, on a 1024 x 1024 canvas, white filled shapes (rectwithrx,circle,path). Writeicon.jsonto list them. Delete layer files you no longer use.Check: every
image-nameinicon.jsonhas a file inAssets/.Compile with
actool(above).Check:
Assets.carandAppIcon.icnsexist. On an error, fix the file it names. A folder not named exactlyAppIcon.iconmakesactoolwrite nothing and still exit 0.- Review every look: render
Default,Dark,TintedDarkandClearLightat 256, and Default at 32 and 16, withictool(above), and look at each image. The glyph reads in every look and is still recognizable at 16 pt. If not, make it bigger, bolder, or simpler. - Iterate two or three times. Change one thing per round: glyph size, layer opacity, background color.
- Build, install and look at the Dock. If it still shows the old icon, macOS cached it:
touchthe app bundle and restart the app. As a last resort,killall Dock.
The user can fine-tune the file by hand in Icon Composer:
open -a "Icon Composer" Icon/AppIcon.icon. Compile again after they save.
Gotchas
- The folder must be named
AppIcon.icon. With another name,actoolwrites nothing and still exits 0. - A missing layer file:
actoolfails with the name, butictoolexits 0 and renders an empty background. Compile before you review. - PDF layers do not render. Use SVG or PNG.
xcrun ictoolis a different tool. Icon Composer'sictoollives at$(xcode-select -p)/../Applications/Icon Composer.app/Contents/Executables/ictool.- The icon needs
CFBundleIconName=AppIconinInfo.plistandAssets.carinContents/Resources.AppIcon.icnscovers older Finder views and macOS 15.
Done when actool writes both files, the renders show a clear
glyph in all four looks and at 16 pt, the icon uses no SF Symbol, and the
Dock shows the new icon.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

