Filament Buddhist Date Picker Laravel Package

Product Decisions This Supports

• Localization & Compliance: Enables support for Buddhist-era calendars (e.g., Thailand, Myanmar, Cambodia, Laos) in Filament admin panels, aligning with regional legal/regulatory requirements (e.g., government forms, financial systems).
• Market Expansion: Critical for products targeting Southeast Asian markets where Buddhist calendars are standard (e.g., real estate, healthcare, or public-sector SaaS).
• Build vs. Buy: Avoids custom development of date-picker logic for Buddhist-era conversions, reducing technical debt and maintenance overhead.
• User Experience (UX): Eliminates manual calculations for users accustomed to Buddhist dates, improving adoption rates in localized workflows (e.g., leave requests, event scheduling).
• Roadmap Prioritization: Justifies investment in Filament-based admin panels for regions where Gregorian-to-Buddhist conversions are non-trivial (e.g., Thailand’s fiscal year starts in Buddhist April).

When to Consider This Package

• Adopt When:
  • Your product serves Southeast Asian markets (primary use case: Thailand, Myanmar, Cambodia, Laos).
  • You use Filament v4 for admin panels and need date/time inputs with Buddhist-era support.
  • Your team lacks bandwidth to build custom calendar conversion logic (e.g., 2566-01-01 → 2022-12-31).
  • You require MIT-licensed, open-source solutions with minimal dependencies.
• Look Elsewhere If:
  • Your app uses Filament v3 (requires v1.x of this package; consider upgrading or alternative solutions).
  • You need multi-calendar support (e.g., Hijri, Chinese) beyond Buddhist—evaluate fullcalendar or custom builds.
  • Your audience is global but not region-specific (Gregorian-only Filament fields suffice).
  • You require deep customization of date-picker UI (this package extends Filament’s native components).

How to Pitch It (Stakeholders)

For Executives:

"This package lets us seamlessly integrate Buddhist-era dates into our Filament admin panels with a one-line code change (->buddhist()). For markets like Thailand—where Buddhist dates are legally mandated for official records—this eliminates manual conversions, reduces errors, and accelerates compliance. It’s a low-risk, high-impact fix for regional expansion, costing ~$0 in development and maintaining MIT license flexibility."

For Engineering:

*"We’re adding Buddhist-era support to Filament’s DatePicker/DateTimePicker via zenepay/filament-buddhist-date-picker. Key benefits:

• Zero custom JS/PHP: Leverages Filament’s existing components with a simple method call.
• Automatic conversion: Handles Gregorian ↔ Buddhist math (e.g., 2566-01-01 ↔ 2022-12-31).
• Filament v4 only: Requires no migration work if already using v4.
• Lightweight: MIT license, 21 GitHub stars, last updated 2025. Implementation: Add composer require zenepay/filament-buddhist-date-picker, then call ->buddhist() on date fields. Example:

DatePicker::make('birth_date')->buddhist(); // Renders Buddhist-era picker.

Risks: None critical—package is stable, and Filament’s core team actively maintains v4."*