Elegant month view with seamless event transitions
\nElegant month view with seamless event transitions
\n![\"Buy](\"https://ko-fi.com/img/githubbutton_sm.svg\")
\n\n---\n\n## Features\n\n### Core Views\n- **Multiple Perspectives**: Month, Week, Day, and Year views.\n- **Fluid Navigation**: Smooth transitions between dates and views.\n- **Business Hours**: Customizable working hours with support for split shifts.\n\n### Resource Management\n- **Resource Timeline**: Visualize and manage events across multiple resources (rooms, people, equipment).\n- **Vertical & Horizontal Layouts**: Flexible resource views to fit any application design.\n- **Resource-Aware Validation**: Ensure events are correctly assigned and don't overlap where prohibited.\n\n### Recurring Events (RFC 5545)\n\nOpt-in via the recurrence plugin (`plugins={[recurrencePlugin()]}` from `@ilamy/calendar/plugins/recurrence`).\n\n- **Full RRULE Support**: Daily, Weekly, Monthly, Yearly patterns with complex frequencies.\n- **Smart CRUD**: Google Calendar-style operations—edit \"this event\", \"this and following\", or \"all events\".\n- **Exclusion Dates**: Robust handling of EXDATE and modified instances within a series.\n- **iCalendar Export**: Export events to `.ics` files with strict RFC 5545 compliance.\n\n### Plugin System\n- **Opt-in capabilities**: The core ships no plugins. Add behavior through the `plugins` prop, each from its own subpath: `@ilamy/calendar/plugins/recurrence` (RFC 5545 recurring events) and `@ilamy/calendar/plugins/agenda` (agenda list view).\n\n### Internationalization & Timezones\n- **Timezones**: Full timezone support via `dayjs.tz` with automatic DST handling.\n- **Internationalization**: Support for 100+ locales with configurable week start days.\n\n### Interactions\n- **Drag & Drop**: Move and resize events with precision using `@dnd-kit`.\n- **Responsive**: Adaptive layouts designed for desktop, tablet, and mobile.\n\n### Developer Experience\n- **Type Safety**: Written in TypeScript with comprehensive type definitions and IntelliSense support.\n- **Reliability**: 100% test coverage for all mission-critical date and recurrence logic.\n- **Theming**: Built on Tailwind CSS 4 variables for effortless branding and customization.\n- **Modern Stack**: Zero-config integration with React 19 and modern build tools.\n\n---\n\n## Installation\n\nInstall the library and its peer dependencies using your preferred package manager:\n\n```bash\n# npm\nnpm install @ilamy/calendar dayjs\n\n# bun\nbun add @ilamy/calendar dayjs\n\n# pnpm\npnpm add @ilamy/calendar dayjs\n```\n\n> **Note**: This library requires **React 19+** and **Tailwind CSS 4+**. Peers: `dayjs`, `react`, `react-dom`, `tailwindcss` (v4), `tailwindcss-animate`. `dayjs` is in the command above because the calendar's API uses `dayjs` objects and shares your app's instance/locale.\n\n---\n\n## Quick Start\n\n```tsx\nimport { IlamyCalendar } from '@ilamy/calendar';\n\nconst MyApp = () => {\n const events = [\n {\n id: '1',\n title: 'Project Kickoff',\n start: '2026-05-01T10:00:00Z',\n end: '2026-05-01T11:30:00Z',\n color: 'blue'\n }\n ];\n\n return (\n