Automatically add a badge to your app icon
Please use the badge plugin instead.
This action will add a light/dark badge onto your app icon.
You can also provide your custom badge/overlay or add a shield for more customization.
More info: https://github.com/HazAT/badge
Note: If you want to reset the badge back to default, you can use
sh 'git checkout -- <path>/Assets.xcassets/'.
|Supported platforms||ios, android, mac|
badge(shield: "Version-0.0.3-blue", no_badge: true)
||Adds a dark flavored badge ontop of your icon|
||Add your custom overlay/badge image|
||Hides the beta badge|
||Add a shield to your app icon from shields.io|
||Adds and alpha badge instead of the default beta one|
||Sets the root path to look for AppIcons||
||Set custom duration for the timeout of the shields.io request in seconds|
||Glob pattern for finding image files|
||Keeps/adds an alpha channel to the icon (useful for android icons)|
||Position of shield on icon. Default: North - Choices include: NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast|
||Shield image will no longer be resized to aspect fill the full icon. Instead it will only be shrunk to not exceed the icon graphic|
* = default value is dependent on the user's system
To show the documentation in your terminal, run
fastlane action badge
It is recommended to add the above action into your
Fastfile, however sometimes you might want to run one-offs. To do so, you can run the following command from your terminal
fastlane run badge
To pass parameters, make use of the
: symbol, for example
fastlane run badge parameter1:"value1" parameter2:"value2"
It's important to note that the CLI supports primitive types like integers, floats, booleans, and strings. Arrays can be passed as a comma delimited string (e.g.
param:"1,2,3"). Hashes are not currently supported.
It is recommended to add all fastlane actions you use to your
This action, just like the rest of fastlane, is fully open source, view the source code on GitHub