icons: App icons

The icons configuration allows you to define the icons to be used for your app.

All icons are square, and must be placed in your src directory. Paths to your icons should be specified relative to your src directory.

Important: All icons need to be supplied in PNG format.

Config options

Android

48, 72, 96, 144, 192

Paths to various icons used to represent your app (all required), relative to your src directory. The numbers represent the height/width of the icon in pixels.

Adaptive

background-color

The color for the adaptive icon's background - e.g. #fe30a5

108, 162, 216, 324, 432

Paths to various icons used to represent your app (all required), relative to your src directory. The numbers represent the height/width of the icon in pixels.

iOS

57, 72, 76, 114, 120, 144, 152, 167, 180

Paths to various icons used to represent your app on an iOS device (all required), relative to your src directory. The numbers represent the height/width of the icon in pixels.

Prerendered

Setting this to true will stop iOS from applying the gloss effect to your icons.

Note: If you specify any icons for a particular platform, you must specify all required icons!

Notes on Android icons

From Android 8.0 (API Level 26) onwards the preferred format for Android icons are the so-called "adaptive" icon format.

Adaptive icons will be displayed as different shapes across different Android device models according to the "shape mask" used by the particular device model.

For instance, on one device model the launcher icons may be circular whereas a different device model may render launcher icons as rounded squares.

To accomodate the different shapes, icon sizes are now sized larger than the visible area with a "safe zone" in the center which is guaranteed to not be clipped by the shape mask.

In relative measurements, adaptive icons are 108dp x 108dp in size, with a "safe zone" of 66dp x 66dp in the center:

In absolute measurements, for each icon size the corresponding safe zone is equal to:

For more information please see the following:

• Understanding Android Adaptive Icons
• Designing Adaptive Icons
• Android UI Guidelines: Adaptive Icons