RegistryInstall CalendarCN with the shadcn CLI

Getting Started

Changelog

What changed in each registry item, newest first, with breaking changes called out.

Every pull request merged to main goes live in the registry right away, so this page lists changes by the day they merged. Find the day you last ran add, read up from there, then update. Each entry names the items whose files changed. Changes to the docs, the demo and the tests are left out.

Entries marked Breaking can stop your code from compiling or change what it does after you update. Each one says what to change.

Unreleased

Live in the registry, but not in a tagged release yet.

November 17, 2026

  • Improved calendar-core, event-details, time-grid, month-view, details-sidebar, calendar-app: creating an event works the way it does in Notion Calendar. Double-click an empty slot for a 30-minute event, or press and drag to draw one of any length, up, down or across days; both ends snap to snapMinutes. The all-day row and the month view do the same for all-day events, and a long press does it on touch. The new event is a draft: a tinted range, selected, with its title focused, that isn't stored until its first edit. Naming it (Enter, or leaving the title) or changing any other field saves it, and the first title keystroke turns the tint into an event block. Esc leaves the title and then throws the draft away, as does a click elsewhere while nothing was typed, and Esc mid-drag drops it. C and "Create event..." start a draft too, drawn as an event block from the start, half an hour long, or all-day in month view. An event without a title shows its time in the title's place. useCalendar() adds eventDraft, startEventDraft() and updateEventDraft(), CalendarProvider adds defaultEventDuration, NewEventRange adds isAllDay, EventDetailPanel and EventDetailPopover add onTitlePreview, and EventDraftPopover, TimeGridEventDraft and AllDayEventDraft are new in @/components/event-draft. See Creating events. #92
    • Breaking: a single click on an empty slot no longer creates an event. It clears the selection; a double-click or a drag creates.
    • Breaking: an event created on the calendar is stored, and reported through onEventCreate and onEventsChange, when its first edit saves it, not when it appears. onEventCreate gets it with the title it was given, once. onEventSelect is called for the draft, with the id it keeps. addEventFromRange() still adds its event at once.
    • Breaking: new events start 30 minutes long, not 60, at the quarter hour nearest the pointer rather than the one before it. Pass defaultEventDuration={60} for hour-long ones.
    • Breaking: the default createEvent gives new events no title, not "New event". createEvent is also called for whole days, with isAllDay set on the range, and its event is made all-day. To keep a default title, return one from your own createEvent: Enter then saves the draft under it.
    • Breaking: addEventAtNextSlot(), and so C and "Create event...", start a draft instead of storing an hour-long event, and getNextSlotEventRange() takes defaultEventDuration in its config.
    • Breaking: WeekViewGrid's onEventCreate is called for a double-click, with an event selected or not. Empty space starts drags through the new onEventDrawPointerDown, on WeekViewGrid and WeekViewAllDayRow.
    • Breaking: useInlineEdit()'s onCommit gets a second argument, { textOnFocus, isEnter }. A handler that takes one argument keeps working.
    • If you render EventDetailPanel yourself for the provider's selected event, pass onTitlePreview while it is the draft, as Event Details shows. Without it, the first title keystroke saves the draft.
  • Added calendar-core, event-details, time-grid, month-view, agenda-view, command-menu: selecting several events, as in Notion Calendar. Shift- or ⌘-click adds an event to the selection (and takes a selected one out), and ⌘A or the command menu's "Select all visible" selects every event on screen. Delete, cut, copy, paste and duplicate on one of them act on them all, each as one undo step, with Notion's toasts ("2 events deleted", "2 events cut", "2 events copied to clipboard"); dragging one, or Alt↓, moves them all. A date of a repeating event among them changes alone, without asking which events, and a group dragged while the calendar draws in another timeZone moves each event by the same time. The full shortcut list (?) lists "Select all visible" under Calendar view. useCalendar() adds selectedEventIds, setSelectedEventIds, toggleEventSelection and selectAllVisible, and useIsEventInSelection() is new in calendar-core, with the helpers in @/lib/event-selection. See Calendar Core. #91
    • Breaking: useCalendarShortcuts() now handles ⌘A outside text fields, so it no longer selects the page's text there. If your app uses it, handle it in a keydown listener added before the hook's and call event.stopImmediatePropagation().
    • Breaking: while several events are selected, selectedEventId and selectedEvent are null. An object you type as CalendarContextValue yourself, like a test mock, needs the four new members.
  • Added calendar-core, time-grid, details-sidebar, calendar-sidebar, command-menu, calendar-app: scheduling, as in Notion Calendar. S, the sidebar's Scheduling row or "Share availability..." in the command menu start marking open times on the day and week grid: drag to mark, drag a marked time to move or resize it, and remove it with its ×. The details sidebar shows the scheduling panel with the meeting length, the text and the marked times, and Copy puts the text on the clipboard ("Would 30 min during any of these times (all in EDT) work for you?"). SchedulingProvider, useScheduling() and useSchedulingShortcuts() are new in calendar-core, with formatAvailabilityText() in @/lib/availability; AvailabilityPanel and AvailabilityHint in details-sidebar; AvailabilityLayer in time-grid. See Scheduling. #90
    • CalendarApp and SchedulingProvider take onCreateSchedulingLink: with it, the Scheduling row opens a menu and the command menu lists "Create recurring scheduling link..." and "Create one-off scheduling link...", which hand a SchedulingLinkRequest to your app. CommandMenu takes onShareAvailability and onCreateSchedulingLink.
    • Breaking: CalendarSidebar shows the Scheduling row only inside a SchedulingProvider, and the row is no longer disabled with a "Soon" badge. With showComingSoon, the command menu no longer lists the scheduling link commands as "Soon": they show when you pass onCreateSchedulingLink. calendar-sidebar and details-sidebar now need shadcn/ui's dropdown-menu.
  • Added calendar-settings, a new item, with calendar-app, command-menu, calendar-sidebar, details-sidebar and ics: Notion Calendar's account and app controls. CalendarSettingsDialog is a settings dialog laid out as Notion's: General (weekends, declined events, week numbers, number of days, time format, theme) and each calendar account's calendars, each setting shown when something can change it. CommandMenu adds onOpenSettings ("Go to settings"), onAddCalendarAccount, onManageCalendarAccounts, onSupport and onAbout, CalendarSidebar adds onAddCalendarAccount, and CalendarApp adds settingsDialog, onAddCalendarAccount (with importIcsCalendar(), which adds an .ics file as a calendar), onSupport and onAbout. toIcsCalendar() is new in @/lib/ics. #87
    • Breaking: without onAddCalendarAccount, CalendarSidebar no longer draws "Add calendar account" (it was disabled with "Soon"). "Add Google Calendar account" is now "Add calendar account", and the command menu and the useful shortcuts no longer list "Get CalendarCN mobile app", "Log out", "Check for update" or "Menu bar calendar", even with showComingSoon.
  • Added calendar-core, time-grid, calendar-sidebar, command-menu, details-sidebar, calendar-app, sample-data: meet with people and show a teammate's calendar, as in Notion Calendar. The sidebar's "Meet with..." field, F and "Meet with..." in the command menu add people from contacts: their events are drawn behind yours in the day and week views, hatched in their color, the times you're all free are highlighted, and an event created meanwhile invites them. P and "Show teammate calendar..." show a teammate's calendar without the meeting. The sidebar lists both, each removable. CalendarProvider adds meetWith, teammates (each with its default and on…Change), contactEvents and workingHours, EventContact adds color, and useCalendarPeople() is new. getSharedFreeTime() is new in @/lib/free-busy. CommandMenu adds onMeetWith and onShowTeammateCalendar, and useCalendarShortcuts() the same two options. The sample data adds generateContactEvents(), four teammates' weeks. See Meeting with people. #83
    • CalendarSidebar's "Meet with..." field is no longer disabled, and the "Useful shortcuts" list "Show teammate calendar" (P) without a "Soon" badge. Pass onShowTeammateCalendar to useCalendarShortcuts() so P does what the list says, or pass your own shortcuts. The full list (?) adds "Meet with..." and "Show teammate calendar" under Workflows, as SHORTCUTS.meetWith and SHORTCUTS.showTeammateCalendar.
  • Added people-picker, a new item: the dialog F and P open, to search your contacts and meet with someone or show their calendar. See People Picker. #83
  • Added calendar-core, time-grid, command-menu, calendar-header: the command menu's "Start week on...", "Set number of displayed days...", "Default hour size", "Zoom hours in" and "Zoom hours out" work, as in Notion Calendar. "Start week on..." and "Set number of displayed days..." open a second list in the menu. The week start is controllable like the number of days (weekStartsOn, plus defaultWeekStartsOn and onWeekStartsOnChange), and every view and the mini calendar follow it. The day and week views' hour height is provider state too (hourHeight, defaultHourHeight, onHourHeightChange; null fills the screen as before): ⇧⌘. and ⇧⌘, zoom through HOUR_HEIGHT_STEPS (24 to 160px) keeping the middle of the screen in place, and ⇧⌘0 goes back to the default. useCalendar() adds hourHeight, setWeekStartsOn, zoomHoursIn, zoomHoursOut and resetHourHeight; getZoomedHourHeight() and NUMBER_OF_DAYS_OPTIONS are new in calendar-core. See Calendar Core. #85
    • Breaking: useCalendarShortcuts() now handles ⇧⌘., ⇧⌘, and ⇧⌘0 (Ctrl on Windows and Linux), and onOpenSettings no longer runs on ⇧⌘,. An object you type as CalendarContextValue yourself, like a test mock, needs the five new members.
  • Added calendar-core, time-grid, month-view, year-view, agenda-view, calendar-header, command-menu, event-details, mini-calendar, calendar-sidebar, ics, sample-data: the view settings work in every view, as in Notion Calendar. With Weekends off, day and week view show weekdays only and step over the weekend (the day after Friday is Monday, a full week is Monday to Friday, a drag from Friday to the next column lands on Monday), and year view drops its weekend columns like month view. Week numbers show "Week 23" beside the title in day and week view, at each week's start in the agenda, and down the side of the mini calendar. Declined events hides the events you declined, and draws them struck through on a dashed outline while it's on. The command menu's "Hide weekends", "Hide declined events" and "Hide week numbers" toggle the same settings and read "Show …" while one is off. EventParticipant gains self, which marks you among an event's participants; isDeclinedByViewer(), filterDeclinedEvents(), getFirstShownDay(), addShownDays(), countShownDaysBetween() and getShownDays() are new in calendar-core, and parseIcs() and toIcs() read and write participants as ORGANIZER and ATTENDEE. #84
    • Breaking: day and week view's visibleDays and visibleRange leave the weekend out while it's hidden, and onVisibleRangeChange reports that shorter range. If you fetch events by range and hide weekends, nothing changes for weekdays; weekend events are simply not drawn.
    • Breaking: "Week 23" beside the title in week view now follows the Week numbers setting, which is off by default, and so does the mini calendar's week number column in CalendarSidebar. Pass defaultViewSettings={{ showWeekNumbers: true }} to keep them. A MiniCalendar you render yourself keeps them; pass showWeekNumber={false} to hide them.
  • Added calendar-core, event-details, time-grid, month-view, agenda-view, details-sidebar: changing or deleting one date of a repeating event asks "This event", "This and following events" or "All events", as in Notion Calendar. A drag, resize or menu change asks at once; changes in the details wait, marked with a dot, until you leave the event. "This and following events" ends the series the day before and starts a new one. updateEvent and deleteEvent take an optional scope that skips the question, editEvent changes an event the way the details do, and getSeriesEditChanges(), getSeriesDeleteChanges(), getEventChangeSummary() and EventSeriesScopeDialog are new. See Calendar Core. #89
    • Breaking: updateEvent or deleteEvent called on a date of a repeating event while a view is mounted now asks which events to change. Pass "this" as the second argument to keep changing that date only. Deleting the series' first date no longer deletes the whole series unless you answer "All events".
    • Breaking: an object you type as CalendarContextValue yourself, like a test mock, needs the new editEvent member.
  • Added calendar-core, command-menu, details-sidebar, calendar-app: Notion Calendar's Go to date, Create event, Search events and full keyboard shortcut list. . opens the command menu on Go to date, which reads typed dates ("tomorrow", "next friday", "dec 25", "12/25", "in 2 weeks") in the calendar's locale and week start, shows the day with its weekday, and goes there in the current view on Enter. C and "Create event..." create an event at the next half hour with its title focused. "Search events" (and "Search events for “…”" once you type) opens the details sidebar's search, focused. ? and "Show keyboard shortcuts" show every shortcut in the details sidebar, with a field to find one. useCalendar() adds navigateToDate and addEventAtNextSlot, useCalendarShortcuts() adds onGoToDate and onShowShortcuts, CommandMenu adds onSearchEvents, onShowShortcuts and defaultPage, and DetailsSidebar adds actionsRef and shortcutGroups. parseDateQuery() is new in @/lib/date-query (with command-menu), and KEYBOARD_SHORTCUT_GROUPS, SHORTCUTS and findKeyboardShortcuts() in @/lib/keyboard-shortcuts. #86
    • Breaking: useCalendarShortcuts() now handles C outside text fields. If your app uses it, handle it in a keydown listener added before the hook's and call event.stopImmediatePropagation(). An object you type as CalendarContextValue yourself, like a test mock, needs navigateToDate and addEventAtNextSlot.
  • Added calendar-core, time-grid, month-view, agenda-view, year-view, event-details, mini-calendar, details-sidebar, calendar-app: timeZone on CalendarProvider (so also on Calendar and CalendarApp) draws the calendar on one IANA zone's clock, as Notion Calendar's primary time zone. Events, today, the current-time line, the first day of each week, a click-created event and the details' times follow it, and the time axis is labeled with it. The events you pass in and get back stay instants. defaultTimeZone and onTimeZoneChange make it provider state like view. toZonedWallClock(), fromZonedWallClock(), getZonedNow(), toDisplayEvent(), fromDisplayEvent() and fromDisplayRange() are new in @/lib/time-zones; expandRecurringEvents() and findEventOrOccurrence() take the calendar's zone, and useNow(), useToday(), useIsPast(), useTimeZoneLabel() and useTimeZoneDisplayName() an optional zone. See Calendar Core. #88
  • Added calendar-core, time-grid, command-menu, event-details, calendar-app: Notion Calendar's time zone controls. secondaryTimeZones shows any number of additional zones beside the time axis (secondaryTimeZone is the one-zone form), with defaultSecondaryTimeZones and onSecondaryTimeZonesChange. Each zone's label opens a menu to change it, make it primary or secondary, or remove it, and a "+" left of "All-day" adds one. useCalendar() adds timeZones, changeTimeZones, travelTimeZone and travelToTimeZone, with addTimeZone(), removeTimeZone(), makeTimeZonePrimary(), makeTimeZoneSecondary() and replaceTimeZone() in @/lib/time-zones. The command menu's "Travel to time zone..." and "Show additional time zones..." work, plus "Make time zone primary..." and "Hide time zone...", each with a zone list searched by city, name or offset, and timeZoneCommand opens it on one. While travelling the zone travelled to is drawn as the primary one with your home zone beside it, until the x, "Travel back home" or Esc; Z travels, with useCalendarShortcuts({ onTravelToTimeZone }). When the calendar draws in another zone than an event's, the details' time zone row shows the calendar's zone and switches the times to the event's own. See Calendar Core. #88
    • Breaking: an object you type as CalendarContextValue yourself, like a test mock, needs the four new members, and one you type as CalendarConfig needs secondaryTimeZones.
    • Breaking: the time axis labels are buttons that open a menu, and secondaryTimeZone is now held like a controlled prop: removing that zone from its label calls onSecondaryTimeZonesChange, and the column stays until you drop the prop. Use defaultSecondaryTimeZones to let the labels change the zones.

November 16, 2026

  • Added calendar-core, event-details, time-grid, month-view, details-sidebar, calendar-app: delete, duplicate, cut, copy and paste events from the right-click menu, the details' "..." menu and the keyboard (Delete, ⌘X, ⌘C, ⌘D, ⌘V), and undo or redo every change with ⌘Z and ⇧⌘Z. useCalendar() adds deleteEvent, duplicateEvent, copyEvent, cutEvent, pasteEvent, undo, redo, canUndo and canRedo, CalendarProvider adds onEventDelete, and EventDetailPanel adds onCut, onCopy, onDuplicate and onDelete. #78
    • Breaking: useCalendarShortcuts() now handles Delete, ⌫, ⌘X, ⌘C, ⌘V, ⌘D, ⌘Z and ⇧⌘Z whenever they have something to act on. If your app uses one outside a text field, handle it in a keydown listener added before the hook's and call event.stopImmediatePropagation(). An object you type as CalendarContextValue yourself, like a test mock, needs the nine new members.
  • Added calendar-core, time-grid, month-view, agenda-view, details-sidebar, ics: a repeating event is drawn on every date of its rule in the day, week, month and agenda views, and event search lists each date. The occurrences are generated for the dates on screen and never added to your events. Dragging, resizing or editing one date stores it as an event of its own with seriesId and originalStart, reported through onEventCreate, and excludedDates leaves dates out. parseIcs() and toIcs() read and write them as RECURRENCE-ID and EXDATE. expandRecurringEvents(), findEventOrOccurrence() and applyRecurringEdit() are new in @/lib/recurrence. See Calendar Core. #79
    • On a repeating event's dates, Delete and Cut leave that date out of the series (excludedDates), reported through onEventUpdate, and the series' own first date still deletes the whole series. Editing a generated date is one undo step that removes the stored date again, and Duplicate and Paste on one of its dates add a single event on that date, which doesn't repeat.
    • Breaking: an event with a recurrenceRule (or an RRULE in recurrence) now shows on every date. If you also store each occurrence as an event of its own, drop the rule from those, or give them seriesId and originalStart so they replace the generated ones.
    • Breaking: the series arrows select the next occurrence without adding a copy, so stepping no longer calls onEventCreate. The first edit of an occurrence does.
    • Breaking: parseIcs() names an edited occurrence <UID>-<yyyy-MM-dd> instead of <UID>_<RECURRENCE-ID>, and turns a cancelled occurrence into an excluded date of its series instead of dropping it. Remove events imported under the old ids before importing the same file again.
    • Breaking: findSeriesOccurrence() builds a series from its event and the events that name it with seriesId, no longer from every event with the same title, calendar and rule. An event whose recurrence is display text, alone in its series, has no previous or next occurrence.
    • Breaking: if your event type already has an excludedDates, seriesId or originalStart field of another type, it no longer fits DetailedCalendarEvent. Rename your field.
  • Added calendar-toaster, a new item, with calendar-core and calendar-app: Notion Calendar's toasts. Deleting an event shows "Event deleted" with its title and Undo, cutting shows "Event cut" with Undo, and copying shows "Event copied to clipboard". Calendar App shows them at the bottom right of the calendar; elsewhere, render CalendarToaster. useCalendarNotice() is new in calendar-core, to show the notices with a toast library of your own or show your own. See Calendar Toaster. #82
  • Added calendar-core, time-grid: secondaryTimeZone on CalendarProvider (so also on Calendar and CalendarApp) shows a second time zone's hours in a column left of the day and week views' time axis, with each zone's short label at the top and the now line's one badge staying in the viewer's column. Zones half an hour or 45 minutes off show their minutes ("7:30 PM"). getTimeZoneOffsetDifference() and getSecondaryTimeAxisInstant() are new in @/lib/time-zones, and formatTimeOfDayLabel() and formatNowLineTime() in @/lib/event-utils. #80
  • Added year-view, a new item, with calendar-core, calendar-header, command-menu, calendar and calendar-app: the year as twelve month grids, like Google Calendar's year view, with today in red and a dot on each day that has events. Y, the view switcher and the command menu open it, previous and next move a year, and a click on a day opens its week. ViewType gains "year", monthName is empty in year view so a title reads "2026", and countEventsByDay() is new in calendar-core. #81
    • Breaking: a Record<ViewType, …> or an exhaustive switch over ViewType in your code needs a "year" entry.

November 10, 2026

  • Added calendar-app, calendar-core, calendar-list, calendar-sidebar: in Calendar App, the eye beside a calendar hides its events from every view and shows them again on a second click. The .ics export still writes every event. filterShownEvents() and mergeShownEvents() are new in calendar-core, to do the same in a layout of your own. #76
    • Breaking: CalendarList drops visibilitySoon and CalendarSidebar drops calendarVisibilitySoon, both added earlier the same day in #74. If you installed in between and set either one, remove it.
  • Fixed command-menu: the hints beside "Go to next week" and "Go to previous week" now show K and J, the keys that do it. #75
  • Improved calendar-app, calendar-header, calendar-list, calendar-sidebar, details-sidebar: controls that did nothing are disabled with a "Soon" badge: Scheduling, Meet with… and Add calendar account in the sidebar, the view settings a view doesn't read, and the useful shortcuts nothing handles (DetailsSidebarShortcut takes soon). #74
  • Fixed calendar-core, time-grid: an event that ends at midnight, like 11 PM to 12 AM, stays on its own day in the hour grid and month view, and dragging it no longer saves an end before its start. #70
  • Fixed ics: toIcs() writes a repeating timed event in its time zone, with a TZID, instead of in UTC, so it repeats at the same clock time when the clocks change. parseIcs() keeps a repeating event's IANA TZID as its timeZone. One-off events are still written in UTC. #73
  • Improved calendar-app, calendar-core, calendar-header, event-details: Cut, Copy, Duplicate and Delete in the event menus, and "Declined events" in the view settings, are disabled with a "Soon" badge, since nothing handled them. ⇧⌘D goes back to the browser. #72
  • Fixed calendar-core: an event whose timeZone the runtime doesn't know, like a typo or a Windows zone name, no longer takes the calendar down. It shows in the viewer's zone. isKnownTimeZone() is new in @/lib/time-zones. #71
  • Fixed calendar-core: on the days the clocks change, the day and week grids draw events on the right hour, a click on an empty slot creates the event at that row's time, and Alt with an arrow key moves an event by clock time. #69
  • Fixed calendar-core, event-details: shortcuts no longer run while typing in a contenteditable element or with a <select> focused, Alt with an arrow key is left to the browser unless an event has focus, and the Enter that confirms an IME composition no longer commits the event title. #68
  • Fixed time-grid, month-view: four gestures that saved the wrong dates. Nudging an all-day bar in day view keeps the days off screen, resizing an all-day event to one or two days keeps it all-day, an overnight event can't be resized to end before it starts, and a month bar dragged by its second day lands on the right days. #65

November 9, 2026

  • Added calendar-app, a new block: the whole live demo as one component, with both sidebars, the header, every view, the ⌘K menu, theme switching and .ics import and export. See Calendar App. #62
  • Added calendar-sidebar, details-sidebar, mini-calendar, calendar-list, theme-toggle and sidebar-overlay, new items: the live demo's sidebars, part by part. In calendar-core, CalendarInfo gains isSubscribed, which the calendar list marks with a feed icon. #61
  • Added calendar-header and command-menu, new items: the live demo's header and ⌘K menu. useCalendarShortcuts() in calendar-core takes optional onToggleCommandMenu, onToggleSidebar, onToggleContextPanel, onCycleTheme and onOpenSettings. calendar now builds its toolbar from the header's parts, so updating it installs calendar-header, which ships view-dropdown.tsx at the same path. #60

November 7, 2026

  • Added conference-providers and sample-data, two new items: placeholder Google Meet, Zoom and Microsoft Teams to pass to conferenceProviders, and the live demo's events, calendars, contacts, rooms and places. See Sample Data. #58
  • Fixed event-details: in a narrow details panel, the time row shortens the duration instead of cutting off the end time. #56
  • Added event-details, calendar-core, month-view, agenda-view, ics: a calendar picker, busy/free, visibility and reminders in the details panel. Calendars take defaultReminders, and resolveEventColor, moveEventToCalendar and addReminder are new helpers. .ics export now writes "1 week before" reminders correctly. #51
    • Breaking: an event without a color takes its calendar's color, and falls back to blue only when the calendar has none. Set color on an event to keep it blue.
    • Breaking: an event moved to another calendar gets that calendar's email, or none, instead of keeping the old one.
  • Added event-details, calendar-core: participants and rooms, conferencing, AI meeting notes and location in the details panel. CalendarProvider takes contacts, rooms, conferenceProviders and locationSuggestions to fill their menus. The Conferencing row shows once you pass conferenceProviders. Installs the shadcn/ui avatar. #53
  • Added event-details: links you can copy and remove, "Paste link…" and "Attach file", and a description edited in place. Only http: and https: links become clickable. #52
  • Added event-details, calendar-core, time-grid, ics: editable time zone and repeat rows. Changing the zone keeps the wall-clock time, repeat offers presets and a custom rule, and arrows step through a series (previousInSeries and nextInSeries in useCalendar()). @/lib/recurrence and @/lib/time-zones are new in calendar-core. Installs the shadcn/ui command and dialog. #50
    • Breaking: parseIcs() reads RRULE into recurrenceRule. The raw recurrence string is now kept only for rules it can't parse.
    • Breaking: EventItemPopoverProps drops onPrevWeek and onNextWeek, since the series arrows no longer navigate by period.
  • Added event-details, calendar-core: Notion Calendar's time menu in 15-minute steps, which also reads typed times (7, 930) and durations, plus a date picker and an all-day switch. Installs the shadcn/ui calendar and popover, and react-day-picker. #54

November 6, 2026

  • Added event-details, calendar-core: the details panel rebuilt on Notion Calendar's layout, one file per section. DetailedCalendarEvent gains optional kind, timeZone, recurrenceRule, participants, rooms, conference, aiMeetingNotes, links and attachments. Without onEventChange the panel is read-only, and Esc restores a field without deselecting the event. #49
    • Breaking: the event type picked in the panel's header is now saved on the event as kind, through onEventChange. Save kind with your events to keep it.
    • Breaking: if your event type already has a kind, participants or links field of another type, it no longer fits DetailedCalendarEvent. Rename your field.
    • Deprecated: timezone, a display label. Set timeZone to an IANA zone instead.

November 5, 2026

  • Added calendar-core, event-details, time-grid, month-view, agenda-view: support for shadcn/ui projects set up with Base UI, as well as Radix. The details popover positions itself with @floating-ui/react-dom, and on Radix, picking an event type no longer closes it. DContributed by @doneumark in #43
  • Fixed calendar-core: calendar-provider.tsx type-checks and lints in projects without @types/node, like a stock Vite app. DContributed by @doneumark in #46
  • Fixed time-grid, month-view: scrolling an event into view no longer shifts the week columns away from their headers, or the month rows. #44

November 2, 2026

  • Added ics, a new item: parseIcs() and toIcs() read and write .ics files from Google Calendar, Apple Calendar and Outlook. #36
  • Added agenda-view, a new item, with calendar-core and calendar: the next 30 days' events grouped by day, as the "agenda" view with the A shortcut. #35
    • Breaking: ViewType gains "agenda". A switch that handles every view needs a case for it.
  • Added calendar-core, time-grid, month-view: onVisibleRangeChange reports the dates on screen as people navigate, and loading shows a progress bar while events arrive. #34

November 1, 2026

  • Added: the registry's first items, calendar, calendar-core, time-grid, day-view, week-view, month-view and event-details, served from calendarcn.xyz/r for shadcn/ui projects set up with Radix. #37, on the library groundwork from #31.

On this page