How to make dark, clear and tinted iOS app icons
People can now show every Home Screen icon in dark, clear or tinted styles. You don’t have to draw six versions, but it helps to know what iOS does with the one you give it.
Updated 10 November 2026 · Checked against Apple, Google and Expo docs
The short answer
You have three ways to do it, from least to most work:
- Supply one icon and let iOS do the rest. Give Xcode a single opaque 1024 × 1024 PNG. iOS generates the dark, clear and tinted versions by splitting your image into a foreground and a background layer.
- Add your own dark and tinted images. In the asset catalog, add Dark and Tinted appearances to AppIcon and drop in a separate image for each.
- Build a layered icon in Icon Composer. Apple’s free tool turns your layers into one
.iconfile with settings for default, dark and mono appearances. Clear and tinted come from the mono settings.
Option 1 is fine for most apps with a simple icon. Option 3 gives you the most control over how Liquid Glass treats each part of the design.
The six appearances
Apple lists six appearances for iOS, iPadOS and macOS icons: default, dark, clear light, clear dark, tinted light and tinted dark. Apple’s guidelines say the system automatically generates any variants you don’t provide.
When you supply a flat image, the system tries to separate the foreground from the background. It applies Liquid Glass effects to large, simple foreground shapes, but not to small or complex details such as text and thin lines. That is why a single bold mark on a plain or gradient background usually comes out well, and a busy illustration often doesn’t.
iOS 27 renders Liquid Glass slightly differently from iOS 26 (sharper highlights and refraction, for example), and Icon Composer can preview both.
Designing an icon that survives every appearance
- Keep the same core features in every version. Don’t swap elements in and out between default and dark, or people lose track of your app.
- Base the dark version on the light one. Use complementary colours, avoid very bright images, and remember that a coloured background usually gives the most contrast in dark mode.
- Give foreground shapes clean edges. Apple advises against soft, feathered edges on foreground layers because they spoil the system’s highlights and shadows.
- Leave effects out of the artwork. No baked-in shadows, glows, blurs or highlights: the system adds its own, and they change with each iOS version.
- Use a simple background. A solid colour or gradient. If you import a background image, make it full-bleed and opaque.
- Prefer vectors. SVG or PDF layers stay crisp at every size. Use PNG for raster artwork.
Using Icon Composer (free)
Icon Composer comes with Xcode (Xcode → Open Developer Tool → Icon Composer) and is also a separate download from Apple. The basic flow:
- Draw your icon in layers in any design tool, on a 1024 × 1024 canvas for iPhone, iPad and Mac. Remove background colours, shadows and blurs before export.
- Export the layers as SVG where you can, PNG otherwise, and drag them into Icon Composer’s sidebar. Organise them into no more than four groups.
- Set the background colour or gradient, then preview the default, dark and mono appearances. Adjust colours for dark and mono, and check clear and tinted from the mono options.
- Save the file (for example
AppIcon.icon), drag it into your Xcode project, and make sure the App Icon name in the target’s General tab matches the file name.
The .icon file replaces your asset catalog icon. If your app supports older iOS versions, Xcode generates flat icon images for them at build time.
Doing it in Expo
In app.json, ios.icon can be an object with separate images, or (from Expo SDK 54) a path to an Icon Composer file:
"ios": {
"icon": {
"light": "./assets/images/icon.png",
"dark": "./assets/images/icon-dark.png",
"tinted": "./assets/images/icon-tinted.png"
}
}
"ios": { "icon": "./assets/app.icon" }
Icons are part of the native app, so rebuild it to see the change. See setting up your Expo app icon for the rest of the files.
Where Iconic Icons helps
Iconic Icons makes the default icon, which every other appearance is based on. Describe your app in a sentence and it returns four options, each a single centred mark on a smooth background: the simple, one-idea design Apple’s guidelines recommend. You can change any of them in plain words.
- Default, dark and tinted icons: the free export has an Xcode icon set with the opaque 1024 default icon and, when the mark separates cleanly from its background, a dark icon on a transparent ground and a greyscale tinted icon, already listed in
Contents.json. iOS generates clear from them. - Dark version: the brand kit can make a dark variant, the same mark on a deep dark background, for 1 credit. Use it as the Dark image in the asset catalog or in Expo’s
ios.icon.dark. - Starting layers for Icon Composer: when the mark separates cleanly from its background, the Expo export includes it on its own transparent 1024 PNG (
adaptive-icon.png) with the background as a separate PNG. They are PNGs, not vectors, the mark keeps the soft shadow from the original design, and it sits inside Android’s smaller safe zone, so scale it up in Icon Composer and check it with effects on.
Questions people ask
No. If you supply only your default icon, iOS generates the dark, clear and tinted versions. You can supply your own for more control.
Apple’s free tool, included with Xcode and available as a download, for building a layered .icon file with default, dark and mono settings that iOS, iPadOS, macOS and watchOS render with Liquid Glass.
Yes. If your app supports earlier releases, Xcode generates flat icon images for them from the .icon file at build time.
Set ios.icon in app.json to an object with light, dark and tinted image paths, or from SDK 54 to the path of a .icon file, then rebuild the app.
No. It exports the default 1024 icon for Xcode, and its brand kit can make a dark variant for 1 credit. iOS generates the rest, or you can build them in Icon Composer.