N8iveKit

A set of frameworks making iOS development more fun

Programming language: Swift

License: MIT License

Tags: UI    

README

A set of frameworks making iOS development more fun, developed by N8ive Apps

Frameworks

• [x] InterfaceKit
• [x] AuthKit
• [ ] CoreKit (in progress)
• [ ] NetworkKit (in progress)

More frameworks to be added, stay tuned :relaxed:

InterfaceKit

NKViewController:

The base type replacement for UIViewController that adds N8iveKit supporting logic.

NKNavigationController:

Replaces UINavigationController by adding more features:

• Ability to have different NavigationBar height for each viewController (navigation bar size interactively changes during transitions).
• Ability to enable/disable Sloppy swiping (swipe back gesture to be started from anywhere on the screen, not only from the left edge).

To access the NavigationBar, just call adaptableNavigationBar property of the NKNavigationController.

NKTabBarController:

Replaces UITabBarController by adding more features:

• Ability to automatically position the TabBar vertically if the screen width exceeds a certain limit (you can also choose whether to make it on the right or left of the screen).
• Ability to implement your own TabBar layout.
• In case of vertical TabBar, NavigationBar of selected tab (in case it was NKNavigationController) is positioned on top of the TabBar.

To access the TabBar, just call adaptableTabBar property of the NKTabBarController.

NKActivityIndicatorView:

Replaces UIActivityIndicatorView by adding the ability to use your own animatable layer and handle it.

NKRefreshControl:

Replaces UIRefreshControl by adding the ability to use your own animatable layer and handle it, below is an example on how to use it.

let rc = NKRefreshControl()

override func viewDidLoad() {
  super.viewDidLoad()
  rc.tintColor = UIColor.red
  rc.addTarget(self, action: #selector(RefreshViewController.refresh), for: UIControlEvents.valueChanged)
  self.scrollView.refreshControl = rc
}

@objc func refresh(){
  DispatchQueue.main.asyncAfter(deadline: (DispatchTime.now() + Double(5.0))) { () -> Void in
    self.rc.endRefreshing()
  }
}

func scrollViewDidScroll(_ scrollView: UIScrollView) {
  rc.scrollViewDidScroll(scrollView)
}

AuthKit

OAuth2Client:

The base class for handling OAuth2 flow on iOS using SFSafariViewController, currently supportsOAuth2CodeGrant , tested on Facebook , Google & Github (example app includes code for all).

OAuth2Clientsupports custom handlers for updating UI during the authentication flow.

Requirements

• iOS 10.0+
• Xcode 9.0
• Swift 4.0

Installation

Manually

N8iveKit can be integrated manually into your project, dependency managers support coming soon.

Embedded Framework

• Add N8iveKit as a git submodule by running the following command:

  $ git submodule add https://github.com/n8iveapps/N8iveKit.git

• Open the N8iveKit folder, and drag the needed kit (currently, only InterfaceKit.xcodeproj available) into the Project Navigator of your application's Xcode project.

• Navigate to the target configuration window by clicking on the blue project icon, and selecting the application target under the "Targets" heading in the sidebar.

• In the tab bar at the top of that window, open the "General" panel.

• Click on the + button under the "Embedded Binaries" section.

• Select the framework (currently InterfaceKit.framework).

• Enjoy :relaxed:

Please note that some frameworks depend on others, so you have to include all needed frameworks.

Usage

You can use Interface builder and change the element type to your desired one, or you can simple initialize the elements in code.

Included Open source libraries

• Alamofire
• SwiftyJSON

Communication

• If you found a bug, open an issue.
• If you have a feature request, open an issue.
• If you want to contribute, submit a pull request.

License

N8iveKit is released under the MIT license. See LICENSE for details.