IconBanner adds custom nice-looking banners over your mobile app icons.

It is available both as a command-line tool and as a Fastlane plugin.

IconBanner is inspired by the great HazAT/badge. It provides custom banner creation on-the-fly, allowing to create different text banners for different build contexts.

It allows to create this kind of icons:

Original	Daily	QA	Staging	Production

Original	Daily	QA	Staging	Production

Start by running this command in your project repository:

fastlane add_plugin icon_banner

Then simply add the following actions in your Fastfile:

lane :sample do
  icon_banner([options])
  # [build_ios_app and other actions]
  icon_banner_restore()
end

For more details, see the Usage section below.

First install the gem:

gem install icon-banner

Then use it directly from the root of your app repository:

icon-banner generate [options]
icon-banner restore

For more details, see the Usage section below.

Generates banners and adds them to app icons. Available via:

• The icon_banner() Fastlane action
• The icon-banner generate terminal command

Sample usages:

# fastlane
icon_banner(label: 'QA')
icon_banner(label: 'QA', color: '#ff000088', font: '/Users/johndoe/Documents/mybestfont.ttf')

# command-line
icon-banner generate --label QA
icon-banner generate --label QA --color '#ff000088' --font '/Users/johndoe/Documents/mybestfont.ttf'

Restores app icons without banners (if backups are available). Available via:

• The icon_banner_restore() Fastlane action
• The icon-banner restore terminal command

No options are required – if backup files are available, they are automatically restored.

Sample usage:

# fastlane
icon_banner_restore()

# command-line
icon-banner restore

Bug reports and pull requests are welcome on GitHub at https://github.com/ebelair/icon-banner.

IconBanner is ©2019 ebelair and may be freely distributed under the MIT license. See the LICENSE file.

The project is highly inspired by badge by HazAT. Used also under the MIT license. Thanks again. 🙏

Émile Bélair acts as a Product Owner @ Mirego. He enjoys creating great products and works hard with his team to deliver some of the greatest.