calendar_picker_ghe

A lightweight, customizable Flutter date picker supporting:

🗓️ Gregorian Calendar
🌙 Hijri (Islamic) Calendar
🗿 Ethiopian Calendar

Easily switch between calendars using a unified API with a clean, customizable dialog interface.

✨ Features

🔁 Easy month/year navigation via dropdowns and arrows
✅ Highlights for today’s date and selected date
📆 Configurable year range: firstYear, lastYear, and initialYear
🎯 Unified function: showUnifiedDatePicker(...)
🌍 Clean, extensible codebase for integrating other calendars
Responsive for small devices

📸 Screenshots

📅 Gregorian Calendar

On Small Screen	On Big Screen

🗿 Ethiopian Calendar

On Small Screen	On Big Screen

🌙 Hijri Calendar

On Small Screen	On Big Screen

🚀 Getting Started

📦 Installation

Run this command in your Flutter terminal:

flutter pub add calendar_picker_ghe

📥 Import the Package

In your Dart file:

import 'package:calendar_picker_ghe/calendar_picker.dart';

🧪 Usage

 

import 'package:calendar_picker_ghe/calendar_picker.dart';

final pickedDate = await showUnifiedDatePicker(
  context: context,
  calendarType: CalendarType.ethiopian, // or CalendarType.hijri / .gregorian
  initialYear: 2015,
  firstYear: 2000,
  lastYear: 2030,
);

The calendarType can be one of: CalendarType.gregorian, CalendarType.hijri, or CalendarType.ethiopian.

initialYear, firstYear, and lastYear define the visible year range and default year in the dropdown.

To set the initialYear to today’s year:

 

initialYear: DateTime.now().year, // Gregorian calendar

For Hijri and Ethiopian calendars, use:

 

initialYear: Hijri.now().year,     // Hijri calendar
initialYear: Ethiopian.now().year, // Ethiopian calendar

(Requires appropriate date converter utilities from calendar_converter.dart)

📝 License

This project is licensed under the terms of the Apache License 2.0.

📬 Contact

For questions, feedback, or contributions: