Skip to content

The final Apple calendar you will ever try. Built for iOS in Swift.

License

Notifications You must be signed in to change notification settings

N1c0L4z3R/JTAppleCalendar

 
 

Repository files navigation

JTAppleCalendar

The final iOS calendar control you'll ever try

Inspiration for this control was made possible by Michael @ Karmadust. Want to know how the calendar control works inside out? Check out his KDCalendar tutorial.

CI Status Version License Platform

About Screenshots

Much like a UITableView, because you can design this calendar to look however you want, screenshots will not be an accurate depiction of what this control looks like, but you can check out what people have developed with this control and also post you own images at this link.. A sample iOS application is also included in this project's Github Repository to give you an idea of what you can do.

  • Downloaded and liked this calendar's ease of use?
  • Then don't forget to leave a ★ Star rating on Github. It's needed to make this control #1 :)
  • Also, Support is not manditory, but will be much appreciated.

Features


  • Boundary dates - limit the calendar date range
  • Week/month mode - show 1 row of weekdays. Or 2, 3 or 6
  • Custom cells - make your day-cells look however you want, with any functionality you want
  • Custom calendar view - make your calendar look however you want, with what ever functionality you want
  • First Day of week - pick anyday to be first day of the week
  • Horizontal or vertical mode
  • Ability to add month headers in varying sizes/styles of your liking
  • Ability to scroll to any month by simply using the date
  • Ability to design your calendar however you want. You want it, you build it
  • Complete Documentation

Requirements


  • iOS 8.0+
  • Xcode 7.2+

Communication on Github


Installation using CocoaPods

CocoaPods is a dependency manager for Cocoa projects. Cocoapods can be installed with the following command:

$ gem install cocoapods

CocoaPods 0.39.0+ is required to build JTAppleCalendar

To integrate JTAppleCalendar into your Xcode project using CocoaPods, specify it in your Podfile:

platform :ios, '8.0'
use_frameworks!

pod 'JTAppleCalendar'

Then, run the following command at your project location:

$ pod install

The Problem


  1. Apple has no calendar control.
  2. Other calendar projects on Github try to cram every feature into their control, hoping it will meet the programmer's requirements.

This is an incorrect way to build controls. It leaves the developer with an extremely wide selection of (in many cases non-conventional) features that he has to sift through in order to configure the calendar. Also, no matter how wide the feature selection, the developer is always restricted to a predefined configuration-set shipped with the calendarControl. Do you see Apple building their UITableView by guessing what they think you want the UITableView to look like? No. So neither should we.

The Solution: JTAppleCalendar


Want to get started?

Check out the documentation

Author

JayT, patchthecode@gmail.com

License

JTAppleCalendar is available under the MIT license. See the LICENSE file for more info.

About

The final Apple calendar you will ever try. Built for iOS in Swift.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 85.2%
  • Shell 12.6%
  • Ruby 1.5%
  • Objective-C 0.7%