Back to Projects
package

Flutter MMCalendar

A comprehensive Flutter package for Myanmar calendar with date conversions, astrological calculations, and multi-language support

Flutter MMCalendar Logo

A Flutter-first UI toolkit for Myanmar calendar apps, powered by myanmar_calendar_dart.

Flutter CI/CDpub packageLicense: MIT

Highlights#

  • Accurate Myanmar ↔ Western date conversion via myanmar_calendar_dart
  • Calendar UI with single, range, and multi selection modes
  • Dialog and fullscreen date pickers with responsive action footer
  • Scrollable long-range year selector in picker year mode
  • Horoscope + summary widgets for rich date insights
  • Reusable moon phase widgets using CustomPainter
  • Theme and localization support (Myanmar, English, Mon, Shan, Karen, Zawgyi)
  • Accessibility helpers (semantics, keyboard, focus, text scaling)
  • Performance helpers and cache support from the core package

Installation#

dependencies:
  flutter_mmcalendar: ^3.3.0
flutter pub get

Quick Start#

import 'package:flutter_mmcalendar/flutter_mmcalendar.dart';
 
void main() {
  // Optional runtime configuration.
  MyanmarCalendar.configure(
    language: Language.myanmar,
    timezoneOffset: 6.5,
  );
 
  final today = MyanmarCalendar.today();
  print(today.formatMyanmar());
 
  final complete = MyanmarCalendar.getCompleteDate(DateTime.now());
  print(complete.allHolidays);
}

Core API#

You get both data APIs and Flutter widgets from the same import:

import 'package:flutter_mmcalendar/flutter_mmcalendar.dart';

Common data operations:

final fromWestern = MyanmarCalendar.fromWestern(2026, 3, 2);
final fromMyanmar = MyanmarCalendar.fromMyanmar(1387, 12, 15);
 
final complete = MyanmarCalendar.getCompleteDate(DateTime.now());
final valid = MyanmarCalendar.isValidMyanmar(1387, 12, 15);

Widgets#

MyanmarCalendarWidget

MyanmarCalendarWidget(
  initialDate: DateTime.now(),
  language: Language.myanmar,
  selectionMode: CalendarSelectionMode.range,
  showHolidays: true,
  showAstrology: true,
  onDateSelected: (date) {
    // date is CompleteDate
  },
  onRangeSelected: (start, end) {},
)

MyanmarDatePickerWidget (inline)

MyanmarDatePickerWidget(
  initialDate: DateTime.now(),
  language: Language.english,
  showHolidays: true,
  showAstrology: true,
  onDateChanged: (date) {},
)

Dialog / fullscreen picker#

final selected = await showMyanmarDatePicker(
  context: context,
  initialDate: DateTime.now(),
  firstDate: DateTime(1900),
  lastDate: DateTime(2200),
  language: Language.myanmar,
);
 
final fullscreenSelected = await showMyanmarDatePickerFullscreen(
  context: context,
  language: Language.shan,
);

Form integration#

MyanmarDatePickerFormField(
  language: Language.myanmar,
  onChanged: (value) {
    // value is MyanmarDateTime?
  },
)

Moon Phase Widgets (CustomPainter)#

Generic moon phase view#

MoonPhaseView(
  phase: 0.25, // 0.0..1.0
  size: 44,
  animate: true,
)

Daily moon phase from Myanmar date data#

final complete = MyanmarCalendar.getCompleteDate(DateTime.now());
 
DailyMoonPhaseWidget.fromCompleteDate(
  complete,
  language: Language.myanmar,
  size: 40,
  showLabel: true,
  showIllumination: true,
)

Math helpers#

final phase = MoonPhaseMath.phaseFromDailyMyanmarData(
  moonPhase: complete.myanmar.moonPhase,
  fortnightDay: complete.myanmar.fortnightDay,
  monthLength: complete.myanmar.monthLength,
);
 
final illumination = MoonPhaseMath.illumination(phase); // 0..1

Theme Customization#

final theme = MyanmarCalendarTheme.fromColor(
  const Color(0xFF0F766E),
).copyWith(
  dateCellBorderRadius: 10,
  holidayIndicatorColor: const Color(0xFFDC2626),
);
 
MyanmarCalendarWidget(theme: theme)

New Picker UX#

The current picker includes:

  • Responsive action footer (prevents overflow in longer localized labels)
  • Scrollable long-range year selector via wheel picker
  • Month availability rules based on firstDate / lastDate

Accessibility & Performance#

The core widgets include built-in semantics, keyboard/focus helpers, and performance-oriented rendering defaults (RepaintBoundary, cache-backed date lookups, and constrained rebuild surfaces).

Example App#

Run the showcase app:

cd example
flutter run

Showcase includes:

  • Calendar screen (selection modes)
  • Picker screen (inline/dialog/fullscreen + form)
  • Insights screen (toolbar, summary, horoscope, moon timeline)

Migration Notes#

If you are migrating from older flutter_mmcalendar versions:

  • Core dependency is now myanmar_calendar_dart 2.x
  • Picker and calendar internals are fully refactored
  • Moon widgets are now CustomPainter-based (MoonPhaseView, DailyMoonPhaseWidget)
  • Some legacy docs/examples from older versions were removed in favor of current APIs

Related Projects

Myanmar Calendar Dart CLI Logo
package

Myanmar Calendar Dart CLI

Myanmar calendar utility CLI powered by myanmar_calendar_dart.

Myanmar Calendar Dart Logo
package

Myanmar Calendar Dart

A comprehensive dart package for Myanmar calendar with date conversions, astrological calculations, and multi-language support

App Permissions Logo
package

App Permissions

Centralized permission management system with automatic requests, status tracking, rationale dialogs, and graceful degradation.