# 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](/docs/components/calendar-app), in the style of the shadcn/ui sidebar blocks.

## Recently shipped

The highlights. The [Changelog](/docs/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](/docs/components/calendar-core#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](/docs/components/calendar-core#selecting-several-events).
- **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](/docs/components/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](/docs/components/calendar-settings) and [Calendar App](/docs/components/calendar-app#settings-and-accounts).
- **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](/docs/components/calendar-core#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](/docs/components/calendar-core#hour-size).
- **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](/docs/components/calendar-header#calendarviewswitcher).
- **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](/docs/keyboard-shortcuts) and the [Command Menu](/docs/components/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](/docs/components/calendar-core#time-zone).
- **Year view**: [Year View](/docs/components/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](/docs/components/calendar-toaster). See [Keyboard shortcuts](/docs/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](/docs/components/calendar-core#repeating-events).
- **The live demo as a block**: [Calendar App](/docs/components/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](/docs/components/calendar-sidebar) and [Details Sidebar](/docs/components/details-sidebar) to the [Command Menu](/docs/components/command-menu) and the [Sample Data](/docs/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](/docs/components/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](/docs/installation). Thanks to [@doneumark](https://github.com/doneumark) ([#43](https://github.com/vmnog/calendarcn/pull/43)).
- **Import and export**: `parseIcs()` and `toIcs()` 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](/docs/import-export).
- **Agenda view**: [Agenda View](/docs/components/agenda-view) lists the next 30 days' events by day, which suits phones better than a time grid.
- **Loading data by range**: `onVisibleRangeChange` reports the dates on screen as people navigate, so you can fetch events for them, and `loading` shows a progress bar while they arrive. See [Loading Events](/docs/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](/docs/components/calendar) block down to [Calendar Core](/docs/components/calendar-core). See [Installation](/docs/installation).
- **Shared state**: `CalendarProvider` and `useCalendar()` hold events, the view, the date and the selection, so views no longer depend on the demo page. See [Calendar Core](/docs/components/calendar-core).
- **Standalone views**: [Day View](/docs/components/day-view), [Week View](/docs/components/week-view), [Month View](/docs/components/month-view) and [Time Grid](/docs/components/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](https://github.com/vmnog/calendarcn/issues/new) and describe what you're building.
