What’s new in DayFlow

• Taskscore

  Add items with kind: 'task' and a single due date or time. Click the circle to complete a task; priorities show as colored stripes. Set enableTasks: true to add the Event / Task switch to the built-in editors (off by default). setTaskCompleted and setTaskPriority update tasks from code.

• Single-Date Pickerui-range-picker

  mode: 'single' picks one date or time.

• Task Labelsplugin-localization

  Task and priority labels for every bundled language.

• Plugin Cleanupcore

  install() may return a cleanup function, which app.destroy() runs. The React, Vue and Angular useCalendarApp destroy the app they create.

• Jalali Calendarcoreui-range-picker

  New calendarSystem: 'gregorian' | 'jalali' option displays and navigates every view, the mini calendar and the range picker in the Persian solar calendar. Event data, callbacks, ICS and recurrence rules keep their ISO dates. Gregorian remains the default and keeps the existing locale behavior.

• Persian Localeplugin-localization

  Added fa (fa-IR).

• Accessibilitycoreplugin-sidebarui-range-picker

  • Navigation arrows, search controls and other icon-only buttons have translated accessible names, with new locale keys such as previousDay/nextWeek/previousPeriod, clearSearch and close. The arrows now name the unit they move by in each view.

  • Dialogs have dialog semantics, close on Escape, trap focus and restore it when closed. useDialogFocus is exported for custom dialogs.

  • The calendar picker, the sidebar's merge and import dropdowns, Year view grid days and the compact week header dates are keyboard-operable.

  • The range picker reads its labels (navigation, inputs, hour/minute, OK) from locale.messages.

• Event Notescore

  Click a note to edit it in place; links in the note still open. The event detail panel has a fixed width, stays inside the viewport while the notes field grows, and the meeting row no longer shifts when editing.

• Rich Event Notescore

  Notes in the default event detail panel and dialog now show as formatted text with clickable links, including HTML notes from providers such as Outlook. An edit button switches to a plain-text editor; saving an edited HTML note stores it as plain text.

• Meeting Links Detected in Notescore

  Events without a conference now show the "Join" button when their notes contain a Google Meet, Zoom, Teams, Webex, Whereby or Jitsi link. This also applies to ICS imports, and is available as extractConferenceFromDescription.

• Grouped Calendar Selectorscoreplugin-sidebar

  • Calendar pickers in the event detail panel, detail dialog and mobile drawer, the event context menu, and the sidebar's import and delete-calendar dialogs now group calendars under headers by their source (for example "Google Calendar" or "iCloud").

  • Calendars without a source are listed ungrouped, and the lists look the same as before when no calendar has one. The sidebar's dialogs list groups in the sidebar's own group order.

• Theme-Aware Context Menuscoreui-context-menu

  • Context menus take their colors from the calendar theme tokens (--df-color-*, with --df-color-card for the surface) instead of a built-in palette, so custom theme colors now apply to them.

  • ContextMenu accepts a style prop, merged with its computed position.

  • Used on its own, the menu falls back to the light palette. Its built-in dark palette has been removed, so define the --df-color-* tokens to style it for dark mode.

• Video Conference Integrationcore

  • Added native video conference support on calendar events via event.conference (EventConference), supporting Google Meet, Zoom, Microsoft Teams, Webex, Whereby, Jitsi, and custom meeting URLs.

  • Added utility functions (createEventConference, detectMeetingProvider, extractMeetingId, normalizeMeetingUrl, getEventConference, setEventConference) for provider auto-detection, URL normalization, meeting ID extraction, and backwards compatibility with legacy meta.meetingUrl.

  • Added EventConferenceField in the default event detail dialog and panel, featuring platform icons, a quick "Join" button, and 1-click meeting link copying with status feedback.

  • Added full localization keys for conference labels and actions.

• Sidebar Group Management & Reorderingplugin-sidebar

  • Added sidebar and group context-menu actions for creating, renaming, and deleting calendar groups.

  • Added the ability to create calendars directly inside a specific group.

  • Added drag-and-drop group reordering, persisting ordering through groups, and the asynchronous onGroupReorder(groups) callback.

• Calendar Sync Video Meeting Supportgoogle-syncoutlook-sync

  • @dayflow/google-sync: Maps Google Calendar conferenceData (Google Meet entries, meeting codes, passcodes) and hangoutLink into DayFlow event.conference.

  • @dayflow/outlook-sync: Queries online meeting metadata from Microsoft Graph (isOnlineMeeting, onlineMeetingProvider, onlineMeeting, onlineMeetingUrl) and maps Teams/Skype meetings into event.conference.

• Half-Hour Grid Linescore

  • Added showHalfHourLines configuration option to DayViewConfig and WeekViewConfig (createDayView, createWeekView) to display dashed divider lines at every half-hour interval.

• Event Recurrence Editor

  Added a recurrence editor with a custom repeat dialog for building RRULE-backed repeating events, including multi-language translations.

• Appointment Schedule Plugin

  Introduced the @dayflow-pro/appointment-schedule plugin for booking availability management and schedule windows. Includes comprehensive multi-language documentation (EN/ZH/JA) and interactive video demos.

• Time Grid Background Layer APIs

  Added time grid background layer slots and extension APIs (time-grid background & quick-create), allowing plugins to inject background availability layers, interactive deletion actions, and custom grid UI with accessibility support.

• Native MouseEvent in Event Callbacks

  Passed the native triggering MouseEvent to event callbacks (onEventClick, onEventContextMenu, etc.) and context menu slots for precise mouse coordinate and modifier key access.

• Scheduling i18n

  Added multi-language translation support for scheduling labels, appointment statuses, and time slot indicators.

• Added CalDAV and Google Calendar sync support, plus new Outlook Sync and shared Sync Core packages.

• Added source-based calendar grouping and loading states to the sidebar.

• Added minDate and maxDate constraints to the Range Picker.

• Added the monthDateNumberContent slot for customizing Month View date cells.

• Added runtime plugin configuration APIs with getPluginConfig and updatePluginConfig.

• Added programmatic sidebar controls for collapsing, expanding, and reading the current state.

• Added programmatic keyboard-shortcut controls for enabling, disabling, and reading the current state.

• Added configurable eventHeight for Month View events.

• Agenda List View

  Added a new createAgendaView factory for a scrollable agenda-style list layout. Events are grouped by day with configurable options including daysToShow, showEmptyDays, and timeFormat (12h/24h). Supports both timed and all-day events, multi-day event continuation indicators, and full Content Slot integration.

• Grid Date Click Callbacks

  Added gridDateClick and gridDateDoubleClick callbacks to Month and Week views, enabling click and double-click handlers on empty date/time grid cells.

• Mobile Event Detail as Content Slot

  Migrated the internal MobileEventDetailComponent to the Content Slot system, making the mobile event detail panel fully customizable via framework render props.

• Keyboard Shortcuts Callbacks

  Added lifecycle callbacks to the keyboard-shortcuts plugin (onKeyDown, onKeyUp, and per-action hooks) for programmatic integration and custom shortcut handling.

• Sidebar onReorder Callback

  Added an onReorder callback to the sidebar plugin, fired whenever the user drags calendars to reorder them in the list.

• Multi-calendar Events

  Added native calendarIds support on events. A single event can now belong to multiple calendars, stays visible as long as any linked calendar is visible, and renders with DayFlow's built-in multi-color striped styling.

• Global Calendar Time Zone

  Added timeZone to useCalendarApp / CalendarAppConfig as the primary display and editing timezone for all views. Day, Week, Month, and Year views now share the same calendar timezone semantics.

• Secondary Timeline Refinement

  Kept secondaryTimeZone for Day and Week views as a dedicated secondary timeline display setting, independent from the calendar's primary timezone.

• Mini Calendar Event Dots

  Added richer mini calendar event dot support, including calendar-color-aware dots with up to four unique indicators per day.

• Interactive Demo Controls

  Updated the website interactive calendar controls to expose both the global timezone and the Day/Week secondary timezone with clearer guidance.

• Grid Year View

  Added a new grid mode for createYearView, providing a compact month-grid layout with heatmap intensity colors for event density visualization.

• @create-dayflow CLI

  Introduced the npm create dayflow@latest scaffolding tool. Interactively configures a new project with framework selection (React, Vue, Angular, Svelte), TypeScript support, and Tailwind CSS integration.

• renderSidebarHeader

  Added a renderSidebarHeader render prop to the sidebar plugin, allowing full customization of the sidebar header area (e.g. user avatar, collapse toggle).

• Drag & Drop Improvements

  • Added onEventDrop and onEventResize callbacks to the drag plugin for better event handling.

  • Updated Month and Year View all-day event drag indicators for better visual feedback.

• View Enhancements

  • Added secondaryTimeZone label support for Day and Week Views.

  • Added timeFormat configuration for Day and Week Views.

  • Updated configuration options for monthView and yearView.

• Developer Experience

  • Introduced oxlint for faster linting and improved code quality.

  • Added pre-commit hooks and format:check scripts to ensure code consistency.

  • Migrated to pnpm workspace catalog for better dependency management.

  • Added .editorconfig and improved VSCode settings/extensions recommendations.

This release introduces a new plugin-based architecture, further reducing the core bundle size and providing greater flexibility. Core features have been extracted into independent, optional packages.

New Plugin Packages (v1.0.0)

• @dayflow/plugin-drag

  Handles all drag-and-drop interactions (move, resize, and create).

• @dayflow/plugin-keyboard-shortcuts

  Provides keyboard navigation and shortcuts support.

• @dayflow/plugin-localization

  Dedicated package for multi-language support and internationalization.

• @dayflow/plugin-sidebar

  Extracts the sidebar UI and logic into a standalone plugin.

• Enhanced Visibility Control

  • Added onVisibleRangeChange callback with a reason parameter (scroll vs. navigation).

  • Marked onVisibleMonthChange as deprecated in favor of the more flexible range change callback.

• Improved API

  Simplified framework wrappers by removing the sidebarConfig attribute (now handled via the sidebar plugin).

• UI Refresh

  Updated the view switching button styles for a more modern look and feel.

• Feature Extraction

  Drag-and-drop, keyboard shortcuts, and the sidebar are no longer included in @dayflow/core by default. You must install and register the corresponding plugins to retain these features.

• Sidebar Configuration

  The sidebarConfig prop has been removed from framework adapters. Configuration is now passed directly to the @dayflow/plugin-sidebar during initialization.

This version marks a complete rewrite of the DayFlow internal architecture, moving from a React-only library to a framework-agnostic monorepo structure.

New Package Structure

• @dayflow/core

  The new heart of DayFlow. Powered by Preact, it handles all state management, layout algorithms, and the core rendering engine (~3KB gzipped).

• @dayflow/react

  High-performance React adapter.

• @dayflow/vue

  Brand new adapter for Vue 3.

• @dayflow/svelte

  Brand new adapter for Svelte 5 (with full SSR support).

• @dayflow/angular

  Brand new adapter for Angular (v14+).

• Framework Agnostic

  Core logic and UI are now decoupled from specific frameworks.

• Improved Content Injection

  New Content Slots system allowing users to inject native framework components (React/Vue/Svelte/Angular) into the Preact-driven calendar.

• SSR Ready

  • Svelte: Provided dedicated SSR bundles (dist/index.ssr.js) to avoid DOM reference errors during server-side rendering.

  • React/Vue: Enhanced hydration safety.

• Package Names

  If you were using the old dayflow package, you should now migrate to framework-specific packages (e.g., @dayflow/react).

• Import Paths

  • Components and hooks are now exported from @dayflow/[framework].

  • Core types and utilities are exported from @dayflow/core.

• External Dependencies

  To maintain framework-agnosticism, the built-in color picker (react-color) has been removed. Users should now provide their own color picker via Content Slots.