Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/n8iveapps/N8iveKit
A set of frameworks making iOS development more fun
https://github.com/n8iveapps/N8iveKit
Last synced: 3 months ago
JSON representation
A set of frameworks making iOS development more fun
- Host: GitHub
- URL: https://github.com/n8iveapps/N8iveKit
- Owner: n8iveapps
- License: mit
- Created: 2017-08-05T10:40:33.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2017-09-07T21:45:53.000Z (about 7 years ago)
- Last Synced: 2024-04-22T04:16:05.736Z (7 months ago)
- Language: Swift
- Size: 542 KB
- Stars: 16
- Watchers: 7
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - N8iveKit - A set of frameworks making iOS development more fun. (UI / Font)
- awesome-ios-star - N8iveKit - A set of frameworks making iOS development more fun. (UI / Font)
README
A set of frameworks making iOS development more fun, developed by [N8ive Apps](http://n8iveapps.com)
## 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](https://developer.apple.com/documentation/uikit/uiviewcontroller) that adds `N8iveKit` supporting logic.
#### NKNavigationController:
Replaces [UINavigationController](https://developer.apple.com/documentation/uikit/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](https://developer.apple.com/documentation/uikit/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](https://developer.apple.com/documentation/uikit/uiactivityindicatorview#main) by adding the ability to use your own animatable layer and handle it.
#### NKRefreshControl:
Replaces [UIRefreshControl](https://developer.apple.com/documentation/uikit/uirefreshcontrol) by adding the ability to use your own animatable layer and handle it, below is an example on how to use it.
```swift
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](https://www.oauth.com/oauth2-servers/oauth2-clients/mobile-and-native-apps/) flow on iOS using `SFSafariViewController`, currently supports`OAuth2CodeGrant` , tested on [Facebook](https://www.facebook.com) , [Google](https://www.google.com) & [Github](https://www.github.com) (example app includes code for all).
`OAuth2Client`supports 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](http://git-scm.com/docs/git-submodule) by running the following command:
```bash
$ 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](https://github.com/Alamofire/Alamofire)
- [SwiftyJSON](https://github.com/SwiftyJSON/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](https://github.com/n8iveapps/N8iveKit/blob/master/LICENSE) for details.