Skip to main content

Installing the NationBuilder iOS SDK

Installing using CocoaPods is recommended. If you need help with other installation methods, or if you're using Swift, we suggest referring to the developer forum if the general iOS community fails to help.

For CocoaPods, add to your Podfile:

pod 'NBClient', '~> 1.3.0'

Note that we semantically version the SDK, so patch versions should never break existing code.


To start quickly using the entire SDK, you can import the main header files in your app's precompile header (*.pch) file. (If your app has many classes, you should consider only importing the headers for classes that require them.)

#import <NBClient/Main.h>
#import <NBClient/UI.h>

NBClient/Main.h gives you access to the Core component: client, authenticator, account, accounts manager, additions and defines.

NBClient/UI.h gives you access to the UI component. They are the account button, the accounts modal and popover, and UIKit additions.


You can pick which components to add to your workspace. You may want this to avoid importing parts of the SDK you will not use. By default, CocoaPods adds the NBClient/Core, NBClient/UI, and NBClient/Locale/en components (subspecs) into your workspace. For example, to just include the Core, but also include the (soon to be) French Locale component:

pod 'NBClient/Core', '~> 1.3.0'
pod 'NBClient/Locale/fr', '~> 1.3.0'

You can refer to the subspecs in NBClient.podspec to see the components and their dependencies. We recommend using the default components when first getting started.


If you want to use the UI widgets, you will also need to add our icon font to your application info plist. Under Fonts provided by application, add an item with the value pe-icon-7-stroke.ttf.



The Foundation and UIKit additions we provide in the SDK are prefixed with nb_, so rest assured there won't be conflicts if you don't use that prefix in your own additions.

Next: Using the Client ➔

Was something unclear? Propose edits here.