Need help with CalendarKit?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

1.7K Stars 217 Forks MIT License 744 Commits 23 Opened issues


đź“… Calendar for iOS, iPadOS and macOS in Swift

Services available


Need anything else?

Contributors list

CalendarKit License SwiftPM compatible Swift Compatibility Platform Compatibility Tag Version


CalendarKit is a Swift calendar UI library for iOS, iPadOS and Mac Catalyst. It looks similar to the Apple Calendar app out-of-the-box, while allowing customization when needed. CalendarKit is composed of multiple modules which can be used together or independently.

Need Help?

If you have a programming question about how to use CalendarKit in your application, ask it on StackOverflow with the CalendarKit tag.

Please, use GitHub Issues only for reporting a bug or requesting a new feature.



Try live in a browser

To try CalendarKit with CocoaPods issue the following command in the Terminal:

pod try CalendarKit


CalendarKit can be installed with Swift Package Manager or with CocoaPods.

Swift Package Manager (Xcode 12 or higher)

The preferred way of installing CalendarKit is via the Swift Package Manager.

  1. In Xcode, open your project and navigate to File → Swift Packages → Add Package Dependency...
  2. Paste the repository URL (
    ) and click Next.
  3. For Rules, select Version (Up to Next Major) and click Next.
  4. Click Finish.

Adding Package Dependencies to Your App


To install it, add the following line to your Podfile:

pod 'CalendarKit'

Adding Pods to an Xcode project


  1. Subclass
  2. Implement
    protocol to show events.

CalendarKit requires

to return an array of objects conforming to
protocol, specifying all the information needed to display a particular event. You're free to use a default
class as a model or create your own class conforming to the
// Return an array of EventDescriptors for particular date
override func eventsForDate(_ date: Date) -> [EventDescriptor] {
  var models = myAppEventStore.getEventsForDate(date) // Get events (models) from the storage / API

var events = Event

for model in models { // Create new EventView let event = Event() // Specify StartDate and EndDate event.startDate = model.startDate event.endDate = model.endDate // Add info: event title, subtitle, location to the array of Strings var info = [model.title, model.location] info.append("(datePeriod.beginning!.format(with: "HH:mm")) - (datePeriod.end!.format(with: "HH:mm"))") // Set "text" value of event by formatting all the information needed for display event.text = info.reduce("", {$0 + $1 + "\n"}) events.append(event) } return events }

After receiving an array of events for a particular day, CalendarKit will handle view layout and display.


To respond to the user input, override mehtods of

, for example:
override func dayViewDidSelectEventView(_ eventView: EventView) {
  print("Event has been selected: \(")

override func dayViewDidLongPressEventView(_ eventView: EventView) { print("Event has been longPressed: (") }


CalendarKit supports localization and uses iOS default locale to display month and day names. First day of the week is also selected according to the iOS locale.



By default, CalendarKit looks similar to the Apple Calendar app and fully supports Dark Mode. If needed, CalendarKit's look can be easily customized. Steps to apply a custom style are as follows:

  1. Create a new
    object (or copy existing one)
  2. Change style by updating the properties.
  3. Invoke
    method with the new
let style = CalendarStyle()
style.backgroundColor =

Light theme Dark theme


  • iOS 9.0+, iPadOS 13.0+, macOS 10.15+
  • Swift 4+ (Library is written in Swift 5.3)


The list of features currently in development can be viewed on the issues page.

Before contributing, please review guidelines and code style.


Richard Topchii


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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.