dynamo_calendar

A powerful, multi-mode Flutter calendar widget designed for flexibility. Whether you need a simple date picker, a precise time picker, or a full-scale event scheduler, Dynamo Calendar handles the complexity so you can focus on your app's logic.

Optimized for desktop, tablets, and small-screen apps; android, iOS, and web.

🌟 Features

Four distinct modes:

Simple date selection
Time selection only
Combined date + time selection
Full scheduler with event visualization & interaction
📅 Date Picker: Selection of single dates with a clean, modern UI.
⏰ Time Picker: Precise hour and minute selection.
🌓 Date & Time: Combined picker for appointments and deadlines.
🗓️ Scheduler Mode: View and interact with a list of events assigned to specific dates.
📱 Responsive: Built-in support for both Mobile and Desktop/Web layouts.

📦 Installation

Add the dependency to your pubspec.yaml:

dependencies:
  dynamo_calendar: ^1.0.0

Or run:

flutter pub add dynamo_calendar

🚀 Usage

Import the library

import 'package:dynamo_calendar/dynamo_calendar.dart';

Datepicker Example

    showDialog(
      context: context,
      builder: (context) => Material(
        type: MaterialType.transparency,
        child: DynamoCalendar(
          calendarMode: CalendarMode.datePicker,
          selectedDate: selectedDate,
          onDateSelected: (datePicked) {
            selectedDate = datePicked;
            _updateText(selectedDate != null ? DateUtil.getStandardDate(selectedDate) : "");
          },
        ),
      ),
    );

Timepicker Example

    showDialog(
      context: context,
      builder: (context) => Material(
        type: MaterialType.transparency,
        child: DynamoCalendar(
          key: ValueKey(++_counter),
          calendarMode: CalendarMode.timePicker,
          selectedTime: selectedTimeOfDay,
          onTimeSelected: (timePicked) {
            selectedTimeOfDay = timePicked;
            _updateText(selectedTimeOfDay?.format(context) ?? "");
          },
        ),
      ),
    );

Date & Time Picker Example

    showDialog(
      context: context,
      builder: (context) => Material(
        type: MaterialType.transparency,
        child: DynamoCalendar(
          calendarMode: CalendarMode.dateAndTimePicker,
          selectedDate: selectedDate,
          onDateSelected: (datePicked) {
            selectedDate = datePicked;
            _updateText(selectedDate != null ? DateUtil.getStandardDate(selectedDate, verbose: true) : "");
          },
        ),
      ),
    );

Scheduler Example

      DynamoCalendar(
        calendarMode: CalendarMode.scheduler,
        selectedDate: selectedDate,
        calendarEvents: myCalendarEvents,
        onShowDetailsPressed: (events) => _showEventDetails(context, events),
        onDateSelected: (date) {
          // Navigator logic for new event
        },
      ),

Implementation Tips

ReadOnly TextFields: When using a TextField as a trigger, set readOnly: true. 
This prevents the system keyboard from overlapping your beautiful calendar.

Event Handling: In scheduler mode, the onShowDetailsPressed returns a list of events. 
You can use this to show a detail sheet or a custom popup with event description details.