![](https://user-images.githubusercontent.com/7403338/53202857-3e1e1600-3630-11e9-9bea-b9b369996e87.png)


# CircleBar 

[![GitHub license](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://github.com/softhausHQ/CircleBar/blob/readme-styling/LICENSE)
[![CocoaPod compatible](https://img.shields.io/cocoapods/v/CircleBar.svg)](https://github.com/softhausHQ/CircleBar)
[![Swift 4.2](https://img.shields.io/badge/Swift-4.2-green.svg?style=flat)](https://developer.apple.com/swift/)
[![Twitter](https://img.shields.io/twitter/follow/softhausHQ.svg?style=social)](http://twitter.com/softhausHQ)

<a href="https://github.com/softhausHQ/CircleBar">
<img align="right" src="https://user-images.githubusercontent.com/7403338/53284076-884de700-3757-11e9-9185-33a67e7b3ba0.gif" width="400" height="300" /></a>

<br>
<br> 

Don’t you, sometimes, miss fun user interfaces?  
Truth is, we do. Sure, you can't use them in enterprise apps for obvious reasons, but if you're working on a fun project... 

CircleBar is a fun tab bar navigation controller,  
written in Swift 4 and available through CocoaPods. 

> Currently at v1.0. Contributions are welcome.


<br> 
<br> 
<br>



#

We’re a nimble team of friendly designers and thoughtful developers.  
Have a fun project or need help?   

<a href="mailto:team@softhaus.org">
<img align="left" style="margin-top:200px;" src="https://user-images.githubusercontent.com/7403338/53203134-08c5f800-3631-11e9-99cd-f85e16037cf1.png" width="160" height="40"/></a>

<br>
<br> 
<br> 

# Installation
CircleBar is available through [CocoaPods](https://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'CircleBar'
```


# Roadmap
- [x] Write the Usage section
- [ ] Improve landscape support
- [ ] Improve transitions
- [ ] Release v1.0 
- [ ] iPad support

# Usage
1. Create a new `UITabBarController` in your storyboard or nib.

2. Set the class of the `UITabBarController` to `SHCircleBarController` in your Storyboard or nib. 

3. Set the class of the `UITabBar` of `SHTabBarController` to `SHCircleBar` in your Storyboard or nib.

4. Add a custom image icon and title for `UITabBarItem` of each child `UIViewContrroller`.



# Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.



# License
CircleBar is available under the MIT license. See the [LICENSE](https://github.com/softhausHQ/CircleBar/blob/readme-styling/LICENSE) file for more information.  
If you use the library, please include credits and link to https://softhaus.org.

> _Design inspired from Lukáš Straňák, Dribbble._

Thank you.