Latest 0.1.1
License MIT
Platforms ios 7.0, requires ARC
Dependencies FontAwesomeKit/FontAwesome

A collection of UIView subclasses to wrap around FontAwesomeKit to allow configuration of components from interface builder misusing the title attribute of the classes involved. This is a slightly hackish approach to configure icons in interface builder. It is a tradeoff caused by Apple not priorising custom font support in interface builder. Once Apple supports custom fonts, this project can be considered obsolete.


MWButtonGroup was written for ARC and requires iOS 7.0+ (but it should also work on earlier versions). It needs FontAwesomeKit, which should be installed automatically, if using CocoaPods.


MWAwesomeFontWrappers can be installed using CococaPods (see

Add the following line to your Podfile:

pod 'MWAwesomeFontWrappers', '~> 0.1'


An example of the usage can be seen in the MWAwesomeFontWrapperExample-Folder.

Configuring elements in interface builder

Elements are created as normal. If you are using the provided class and use the name as given in the official cheat sheet. Please note, that some icons are missing, as FontAwesomeKit currently only supports Version 4.0 of the font.


In interface builder set the custom class of UIBarButtonItem to MWAwesomeFontNavigationBarItem:

set class

Then use the title attribute to specify the icon you want:

set title

You won’t see the icon in interface builder, but when running the application the button will automatically be created by the ‘MWAwesomeFontNavigationBarItem` class. Tint color and connections made in interface builder are left intact:



In interface builder set the custom class of UIBarButtonItem to MWAwesomeFontTabBarItem. This is analogue to the step in UIBarButtonItem

Then use the title attribute to specify the icon you want. Here you have two options. If you just want the icon use the font awesome name eg. fa-star. If you want to give the item a title use this notation: Star[fa-star]. This way the title gets set to Star and the fa-star icon is used.

Latest podspec

    "name": "MWAwesomeFontWrappers",
    "version": "0.1.1",
    "summary": "a UIView subclass managing a group of buttons",
    "description": "                       MWAwesomeFontWrappers is a collection of subclasses for providing configurationn                       of Font Awesome icons in Interface Builder by misusing title attributes of the classn                       in question. Currently supported are UIBarButtonItem and UITabBarItem.n",
    "homepage": "",
    "screenshots": "",
    "license": "MIT",
    "authors": {
        "Martin Wilz": "[email protected]"
    "source": {
        "git": "",
        "tag": "0.1.1"
    "platforms": {
        "ios": "7.0"
    "requires_arc": true,
    "dependencies": {
        "FontAwesomeKit/FontAwesome": [
            "~> 2.1.0"
    "source_files": "Classes",
    "public_header_files": "Classes/*.h"

Pin It on Pinterest

Share This