Swiftpack.co - Package - hmrc/ios-components

HMRC Components Library for iOS Build Status

Build applications using components with the HMRC look and feel.


  • iOS 11.0+
  • Swift 5.0



Carthage is a decentralised dependency manager that builds your dependencies and provides you with binary frameworks. To integrate the components library into your Xcode project using Carthage, specify it in your Cartfile:

github "hmrc/ios-components"

Using the Component Library

The component library is created using molecular design.

You can read more about this, and see the individual atoms, molecules, and organisms in the Wiki


Getting Started

The first step is to install Homebrew:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

We can then use Homebrew to install Carthage, SwiftLint, and fastlane:

brew update && brew install carthage && brew install swiftlint && brew install fastlane

We then need install the latest Xcode Command Line Tools, and check this is set in Xcode in Preferences > Locations.

xcode-select --install

Next we need to build the dependencies of the app:

carthage bootstrap --platform ios --use-ssh

We're now ready to build and test the components app! 🎉

open UIComponents.xcodeproj



We use fastlane to automate tedious tasks such as tagging a new release.

Our fastlane README documents our custom actions.


We use SwiftLint to enforce Swift style and conventions. Our custom rules can be found in our .swiftlint.yml.


We use Carthage for dependency management.

  • ☐ Add support for SPM

Using Android?

We have an android version of this library available here


Stars: 0


Used By

Total: 0


5.0.0 -

Xcode 12 update

4.6.16 -