mmcal

A modern, interactive Myanmar (Burmese) calendar

Myanmar calendar with moon phases, traditional holidays, and astrological days — built for the web.

---

Screenshots

---

Features

• Month / Week / Year views — navigate with keyboard shortcuts or swipe
• Moon phases — full moon, new moon, waxing, and waning displayed on every cell
• Myanmar holidays — government holidays, traditional festivals, and notable days
• Astrological days — yatyaza, pyathada, sabbath, mahabote, nakhat, and nagahle
• Bilingual — full Myanmar and English interface with one-click toggle
• Dark mode — system-aware with manual override
• Command palette — Cmd+K to jump to any date or switch views
• Keyboard navigation — arrow keys, T for today, M/W/Y for views
• PWA — installable, works offline
• Responsive — optimized layouts for mobile, tablet, and desktop

Tech Stack

Category	Technology
Framework	React 19 + TypeScript
Styling	Tailwind CSS 4
Animations	Framer Motion
Components	Radix UI + shadcn/ui
Command Palette	cmdk
Build	Vite
Calendar Algorithm	Based on Cool Emerald's algorithm

Getting Started

# Clone the repository
git clone https://github.com/khzaw/mmcal.git
cd mmcal

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Run tests
pnpm test:run

# Build for production
pnpm build

Keyboard Shortcuts

Key	Action
← →	Previous / Next (month, week, or year)
T	Go to today
M	Month view
W	Week view
Y	Year view
Cmd+K	Open command palette

Algorithm

The calendar calculations are based on the Myanmar Calendar Algorithm by Cool Emerald. It handles:

• Gregorian ↔ Julian Day Number ↔ Myanmar date conversions
• Moon phase calculations (full moon, new moon, waxing, waning)
• Traditional holiday and astrological day lookups
• Sabbath day calculations
• Year type classification (common, little watat, big watat)

Author

Kaung Htet — @khzaw

License

MIT