https://github.com/softhausHQ/CircleBar

A fun, easy-to-use tab bar navigation controller for iOS.
https://github.com/softhausHQ/CircleBar

circle design design-patterns dribbble fun navigation-controller open-source say-no-to-hamburger-menu swift tabbarviewcontroller ui ui-components ux

Last synced: 3 days ago
JSON representation

A fun, easy-to-use tab bar navigation controller for iOS.

• Host: GitHub
• URL: https://github.com/softhausHQ/CircleBar
• Owner: softhausHQ
• License: mit
• Created: 2019-02-20T08:10:20.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2024-03-29T09:06:49.000Z (9 months ago)
• Last Synced: 2024-10-31T15:44:20.590Z (about 1 month ago)
• Topics: circle, design, design-patterns, dribbble, fun, navigation-controller, open-source, say-no-to-hamburger-menu, swift, tabbarviewcontroller, ui, ui-components, ux
• Language: Swift
• Homepage: https://softhaus.org
• Size: 233 KB
• Stars: 868
• Watchers: 15
• Forks: 64
• Open Issues: 21
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-ios - CircleBar - 🔶 A fun, easy-to-use tab bar navigation controller for iOS. (UI / Menu)
• awesome-swift - CircleBar - A fun, easy-to-use tab bar navigation controller for iOS. (Libs / UI)
• awesome-swift - CircleBar - A fun, easy-to-use tab bar navigation controller for iOS. (Libs / UI)
• awesome-ios - CircleBar - A fun, easy-to-use tab bar navigation controller for iOS. [•](https://user-images.githubusercontent.com/7403338/53284076-884de700-3757-11e9-9185-33a67e7b3ba0.gif) (Content / Tab Bar)
• awesome-ios-star - CircleBar - 🔶 A fun, easy-to-use tab bar navigation controller for iOS. (UI / Menu)
• fucking-awesome-swift - CircleBar - A fun, easy-to-use tab bar navigation controller for iOS. (Libs / UI)
• awesome-swift - CircleBar - A fun, easy-to-use tab bar navigation controller for iOS. ` 📝 2 years ago` (UI [🔝](#readme))

README

        
![](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)









 

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.


 


 




#

We’re a nimble team of friendly designers and thoughtful developers.  

Have a fun project or need help?   









 


 

# 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.