README.md

UBTokenBar

UBTokenBar is a UICollectionView based token bar written in Swift. It uses UICollectionViewFlow layout objects to layout and render its tokens, which allows for a high level of layout customizability. Since UBTokenBar is powered via a UICollectionView you can register your own cell classes to customize the token appearance and behavior. Right To Left language is supported out of the box!

If you have any questions, feel free to ask on Stack Overflow (tag "ubtokenbar").

Features

• Easy to get started
• Extensible, UICollectionView-based architecture
• Full RTL support

Installation

UBTokenBar requires iOS 10+ and Swift 3

CocoaPods

To integrate UBTokenBar into your project using CocoaPods, add the following line to your Podfile:

pod 'UBTokenBar'

Carthage

To integrate UBTokenBar using Carthage add this to your Cartfile:

github "uber/ubtokenbar"

Running the Examples App

• Clone the repo git clone git@github.com:uber/ubtokenbar.git
• Open the Example directory cd UBTokenBar/Example
• run pod install
• open UBTokenBar.xcworkspace
• Run the UBTokenBar-Example scheme in Xcode. Run the UBTokenBar_ExampleRTL to test Right To Left langauge

Quickstart

See the UBTokenBar Quickstart here!

Authors

• Maxwell Elliott (maxwelle@uber.com, @maxwellE)

Screenshots

Default UBTokenBar

RTL UBTokenBar (Works out of the box!)

Contributions

We'd love for you to contribute to our open source projects. Before we can accept your contributions, we kindly ask you to sign our Uber Contributor License Agreement.

• If you find a bug, open an issue or submit a fix via a pull request.
• If you have a feature request, open an issue or submit an implementation via a pull request
• If you want to contribute, submit a pull request.

Check out the Contribution Guidelines for more information.

License

UBTokenBar is released under the MIT license. See the LICENSE file for more info.