Skip to content

Latest commit

 

History

History
81 lines (47 loc) · 3.63 KB

README.md

File metadata and controls

81 lines (47 loc) · 3.63 KB
Raw

CBToolkit

Meet your new UI. CBToolkit brings your UI to life and thanks to Xcode's IB tools, you can do it without a single line of code. All the elements in the kit are designs to be drag and drop replacements for their UIKit ancestors.

Adding to your project

Manual
Download or clone the repo and drop CBToolkit/CBToolkit into your project. Your good to go.

CocoaPods
CBToolkit is now available on cocoapods Add pod 'CBToolkit', '~> 0.0' to your podfile and run pod update.

Using the views

CBToolkit is designed to help you creat great UIs without extra code. Thanks to IBDesignables many visual effects can be set right in the storyboard. Simply drop the appropriate UIKit element (UIView, UIButton, UIImageView...) into your view controller and change the class to the CB* equivilent.

For example, to add a CBProgressView just drop in a UIVIew, open the attributes inspector in the right utilities panel and set the class to CBProgressView. The custom properties will now be available right along side the standard backgroundColor and such.

And if you really have the urge to type, you can always create CBToolkit views progamratically just like anything else.

Docs & Examples

[View the full docs](https://github.com/WCByrne/CBToolkit/wiki)
[Example app video](https://www.youtube.com/watch?v=AZnW26m93jc)

An example app is included in the repository to show you how some examples of how you can use CBToolkit in your app.

Views

  • CBView : Round those corners, add a border, even drop some shadow all from the storyboard/IB inspector.
  • CBBorderView: Add borders to each side of a view as needed.
  • CBGradientView: Draw a gradient as a background or an overlay with zero code.
  • CBImageView: Style your imageViews and even load remote images with a url.

More about views

Buttons

  • CBButton : Give your buttons some style and bounce.
  • CBIconButton: From the classic hamburger to arrows, this button render it's icon with seamless transition.
  • CBButtonView: A custom UIControl so you can turn any view into a button. Ctrl drag to link it to you code.

More about buttons

TextViews

  • CBTextField : Style your text views without a single line. Make your fields stand out right in the storyboard.
  • CBTextView: Let this text view take care of resizing to fit its text. You can also add a placholder

More about textview

Loaders

  • CBActivityIndicator : A clean and customizable replacement for UIActivityIndicator
  • CBProgressView: Downloading, uploading or doing some background work? Show the prgress in style.

More about progress views

Collection View Layouts

  • CBCollectionViewLayout : A full featured layout with pinterest like placement, aspect ratio sizing, drag and drop and more.
  • CBSliderCollectionViewLayout: A simple full screen horizontal layout with autoscrolling.

More about collection view layouts

Utils

  • CBPhotoFetcher : An image fetching util for retrieving and caching iamges with a url.
  • CBDate extension: A collection of helpful date function and formatters.
  • CBPhoneNumber: Just initialize with a string, then format or call the number.

More about Utils