| name | icon-from-logo |
| description | Create a Liquid Glass .icon bundle from an existing logo PNG or SVG. Use when icon-composer context reports has-logo or the user has a logo file but no app icon bundle yet. |
From logo → .icon bundle
Preconditions
icon-composer doctor
icon-composer context --json
Confirm signals.logo points at your file.
Workflow
- Create bundle (pick a brand background hex):
icon-composer create assets/logo.svg ./out \
--bg-color "#1C1C2E" \
--bundle-name AppIcon
- Optional dark mode fill:
icon-composer appearance ./out/AppIcon.icon \
--target fill --appearance dark --bg-color "#0D1B2A"
- Tune glass (macOS + Icon Composer required for live glass):
icon-composer glass ./out/AppIcon.icon \
--specular --shadow-kind layer-color --blur-material 0.3
- Preview:
icon-composer preview ./out/AppIcon.icon preview.png
icon-composer render ./out/AppIcon.icon glass.png
- App Store flat export (no alpha):
icon-composer export-marketing ./out/AppIcon.icon marketing.png --size 1024
- Drop
AppIcon.icon into your Xcode asset catalog (see icon-xcode-wire if needed).
Tips
- SVG multi-shape logos: default
--split-layers separates glass layers; use --no-split-layers for a single layer.
- Flat preview works without Icon Composer;
render requires macOS + ictool.
