Getting Started
Roadmap
What's being built next, what's planned for later, and what shipped recently.
CalendarCN is built in the open. This page lists the planned work, roughly in priority order. Plans change as people use the calendar, so treat it as a direction rather than a promise.
Up next
List in the shadcn registry directory
Submit CalendarCN to the shadcn/ui registry directory, so it shows up next to the other community registries and installs under the @calendarcn namespace.
Later
Not scheduled yet, roughly in priority order.
- More views: a resource view with people or rooms side by side.
- Large calendars: virtualized rendering for thousands of events.
- Theming: event colors as CSS variables, so you can add your own next to the seven built in, and shading for business hours.
- Right-to-left layouts.
- More blocks: more ready-made layouts next to Calendar App, in the style of the shadcn/ui sidebar blocks.
Recently shipped
The highlights. The Changelog lists every change item by item, with breaking changes called out.
- Creating events like Notion Calendar: double-click an empty slot, or press and drag to draw an event of any length, in the day, week and month views and the all-day row. The new event is a draft until you name it or change it, and Esc throws it away. See Creating events.
- Selecting several events: Shift- or ⌘-click events, or press ⌘A to select all visible, then delete, cut, copy, paste, duplicate or drag them together, each as one undo step with Notion Calendar's toasts. See Calendar Core.
- Scheduling: press S or click Scheduling in the sidebar, mark the times you're free on the day or week grid, and copy them as a message worded like Notion Calendar's ("Would 30 min during any of these times work for you?"). Scheduling links go to your app through
onCreateSchedulingLink. See Scheduling. - Settings and accounts: a settings dialog like Notion Calendar's, for the calendar view, time format, theme and each account's calendars, opened with ⌘,. "Add calendar account", "Support & feedback" and "About CalendarCN" call your app's handlers; the live demo adds an .ics file as a calendar. See Calendar Settings and Calendar App.
- Meet with people: type a name in the sidebar's "Meet with..." field, or press F, and that person's events show beside yours, with the times you're all free highlighted. An event you create meanwhile invites them. P shows a teammate's calendar the same way, without the meeting. Their events come from your app, from Google Calendar's free/busy for example. See Meeting with people.
- Week start and hour size: start the week on any day and set the number of days from the command menu, and zoom the day and week views' hours in and out with Notion Calendar's keys. See Calendar Core.
- View settings in every view: hide weekends, show week numbers and hide the events you declined from the view switcher or the command menu, in every view. Day and week view step over a hidden weekend, and declined events are struck through on a dashed outline, as in Notion Calendar. See Calendar Header.
- Go to date, search and every shortcut: press . and type a date ("next friday", "dec 25", "in 2 weeks") to go there, C to start an event at the next half hour, and ? to see every keyboard shortcut, grouped as Notion Calendar groups them. The command menu also searches events. See Keyboard shortcuts and the Command Menu.
- Time zones: draw the calendar in any zone with
timeZone, add zones beside the time axis from their labels or "Show additional time zones...", and travel to a zone for a while with Z, as in Notion Calendar. See Calendar Core. - Year view: Year View shows the year as twelve month grids, with today and the days that have events marked, like Google Calendar's. Press Y to open it.
- Event actions and undo: delete, duplicate, cut, copy and paste events from the right-click menu, the details' menu or the keyboard, and undo or redo every change with ⌘Z and ⇧⌘Z. A toast confirms each delete, cut and copy, with Undo, as in Notion Calendar: see Calendar Toaster. See Keyboard shortcuts.
- Repeating events: a repeating event is drawn on every date of its rule in every view and in event search, and editing one date changes only that date. .ics files bring their edited and cancelled dates along. Changing or deleting one date asks whether it's this event, this and following events, or all events. See Calendar Core.
- The live demo as a block: Calendar App installs the whole live demo with one command: both sidebars, the header, every view, the command menu, theme switching and .ics files. The live demo renders this block, so the two stay the same. Each part installs on its own too, from the Calendar Sidebar and Details Sidebar to the Command Menu and the Sample Data.
- Notion-style event details: the details panel matches Notion Calendar section by section: time and date, time zone, repeat, participants and rooms, conferencing, location, links and attachments, description, calendar, availability and reminders. It works the same in Radix and Base UI projects, and each section can be used on its own. See Event Details.
- Base UI styles: the registry installs into shadcn/ui projects set up with Base UI as well as Radix. The event details render their own popover, so they no longer rely on Radix-only features. See Installation. DContributed by @doneumark in #43
- Import and export:
parseIcs()andtoIcs()read and write .ics files from Google Calendar, Apple Calendar and Outlook, and a recipe syncs with the Google Calendar API. See Import and Export. - Agenda view: Agenda View lists the next 30 days' events by day, which suits phones better than a time grid.
- Loading data by range:
onVisibleRangeChangereports the dates on screen as people navigate, so you can fetch events for them, andloadingshows a progress bar while they arrive. See Loading Events.
The groundwork that turned the demo into a library:
- Install with the shadcn CLI: the calendar ships as shadcn registry items, from the full Calendar block down to Calendar Core. See Installation.
- Shared state:
CalendarProvideranduseCalendar()hold events, the view, the date and the selection, so views no longer depend on the demo page. See Calendar Core. - Standalone views: Day View, Week View, Month View and Time Grid each work with only a provider around them.
- Your own event type: views are typed with your event type, and render slots let you draw event content and details yourself.
- Configuration: snap interval, visible hours, 12 or 24 hour clock, a date-fns locale, week start, calendars, and the hour the grid opens on.
- Touch: drag, resize and create work on phones and tablets. Long-press to start, so a normal swipe still scrolls.
- Accessibility: every event has a descriptive label, Alt↑ and the other arrows move the focused event, adding Shift resizes it, and time changes are announced to screen readers.
- Tests: an end-to-end suite covers drag, resize, create, navigation and views on every pull request.
Suggest something
Missing something you need? Open an issue on GitHub and describe what you're building.