What is fscalendar?

wenchaod/fscalendar — explained in plain English

Analysis updated 2026-06-24

★ 10,656Objective-CAudience · developerComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((FSCalendar))
    What it does
      Show calendar grid
      Monthly and weekly views
      Mark event dates
    Customization
      Colors and fonts
      Custom cells
      Delegate callbacks
    Integration
      CocoaPods
      Swift Package Manager
      Interface Builder
    Audience
      iOS developers
      Swift and ObjC apps

mindmap root((FSCalendar)) What it does Show calendar grid Monthly and weekly views Mark event dates Customization Colors and fonts Custom cells Delegate callbacks Integration CocoaPods Swift Package Manager Interface Builder Audience iOS developers Swift and ObjC apps

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Add a fully styled calendar to an iOS habit-tracking app where users can see which days they completed a task.

USE CASE 2

Build an appointment scheduling screen with a compact weekly strip that expands into a full monthly view on swipe.

USE CASE 3

Create a custom event calendar with colored dot indicators on dates that have scheduled meetings or reminders.

USE CASE 4

Drop a swipeable calendar view into a Swift app without writing any calendar layout logic from scratch.

What is it built with?

Objective-CSwiftCocoaPodsCarthageSwift Package ManagerXcode

How does it compare?

	wenchaod/fscalendar	magicalpanda/magicalrecord	jessesquires/jsqmessagesviewcontroller
Stars	10,656	10,717	11,086
Language	Objective-C	Objective-C	Objective-C
Setup difficulty	easy	easy	moderate
Complexity	2/5	2/5	2/5
Audience	developer	developer	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

So what is it?

FSCalendar is a calendar display component for iOS apps, written in Objective-C and usable in Swift projects as well. It provides a fully customizable calendar view that developers can drop into an iPhone or iPad app, then style and configure to match the rest of their design. The library handles the visual rendering of a calendar grid, including month and week views, date selection, and animated transitions between the two. Developers can switch the calendar between a full monthly layout and a compact weekly strip using a gesture or programmatic call. There is also support for marking specific dates with dots or custom indicators, which is useful for apps that track events, habits, or appointments. Installation is available through CocoaPods, Carthage, or Swift Package Manager, as well as by dragging the source files directly into an Xcode project. The README includes setup steps for Interface Builder (Xcode's visual layout editor) and for writing the setup entirely in code. Both Objective-C and Swift code examples are provided. Customization is a central feature. Developers can change fonts, colors, and cell appearance, and can build entirely custom calendar cells by subclassing the default cell class. The library calls back into the app through a delegate pattern, meaning the developer's code is notified when the user selects or deselects a date, when the calendar scrolls to a new month, or when the visible scope changes between weekly and monthly modes. According to the badge in the README, more than 10,000 apps have used this library and it has accumulated over 500,000 downloads through CocoaPods. The project supports iOS 7 and later, though some features require iOS 8 or above.

Copy-paste prompts

Prompt 1

I'm building an iOS app in Swift. Show me how to add FSCalendar to my view controller and mark specific dates with dot indicators for events.

Prompt 2

Write Swift code to switch FSCalendar between monthly and weekly scope programmatically when the user taps a button.

Prompt 3

Show me how to create a custom FSCalendarCell subclass that displays a colored ring around selected dates.

Prompt 4

I want FSCalendar to mark every date in an array of NSDate objects with a dot. Write the delegate method to do this.

Frequently asked questions