A highly customizable Flutter calendar widget with Day, Multi-day, Month and Schedule views. It supports drag-and-drop rescheduling, event resizing, timezones, and full control over appearance and behavior.

Live Demo · Benchmarks · Migration Guide

Features

• Four views, one widget. Day, Multi-day, Month and Schedule.
• Reschedule manually. Drag, resize and zoom, on mouse, stylus, trackpad or touch.
• Snapping you control. To an interval, the time indicator, other events, or your own rule.
• No fixed event model. Subclass KalenderEvent and read your own fields anywhere.
• Controllers and callbacks. Navigate from code, and react to taps, creation and changes.
• Replaceable, not just configurable. Swap any widget, or keep it and restyle it.
• Material 3 by default. Follows your app's theme with no setup.
• Timezone aware. Events stored as UTC, shown in any IANA location. Tested in six timezones.
• Localized. Day and month names from intl, and every string replaceable.

Installation

flutter pub add kalender

If you plan to use location/timezones support, also add:

flutter pub add timezone

If you plan to use locale support, also add:

flutter pub add intl

---

Quick Start

The minimal setup, using only the base KalenderEvent class with no custom fields:

import 'package:flutter/material.dart';
import 'package:kalender/kalender.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(body: MyCalendar()),
    );
  }
}

class MyCalendar extends StatefulWidget {
  const MyCalendar({super.key});

  @override
  State<MyCalendar> createState() => _MyCalendarState();
}

class _MyCalendarState extends State<MyCalendar> {
  final eventsController = DefaultEventsController();
  final kalenderController = KalenderController(
    viewConfiguration: MultiDayViewConfiguration.week(
      // Without this the day opens at midnight.
      initialTimeOfDay: const KalenderTime(hour: 7, minute: 0),
    ),
  );

  @override
  void dispose() {
    kalenderController.dispose();
    eventsController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return KalenderView(
      eventsController: eventsController,
      kalenderController: kalenderController,
      callbacks: KalenderCallbacks(
        onEventCreated: (event) => eventsController.addEvent(event),
      ),
    );
  }
}

For a real app you almost always want custom fields on your events. See Custom Events.

---

Examples

Runnable apps are in examples/. Start with example.

---

Documentation

The detailed guides live in doc/:

• Views. The multi-day, month and schedule views, and switching between them.
• Events. Custom event data, updates through the controller, and multi-day and all-day events.
• Interaction. Creating, rescheduling, resizing, snapping, locking and zoom.
• Controllers & Callbacks. Navigation, view switching, callbacks and a toolbar.
• Appearance. The theme and the replaceable components.
• Layout. Tile placement and custom layout strategies.
• Timezones & Locales. Timezones, locales and custom strings.

---

Contributing

Contributions are welcome. Please open an issue or pull request on GitHub.

License

This project is licensed under the MIT License. See the LICENSE file for details.