So when's the lunar date..?

June 10, 2023

https://www.lunarsolaralerts.com

Overview

My parents are first-generation Korean immigrants and they've always celebrated their Lunar calendar birthdays. This has always been difficult to track since their birthdays would never fall on the same Gregorian (solar) calendar date. Their birthday might fall on August 25th one year and August 27th the next.

In order to help myself and others keep track of these important dates, I created a web app that converts solar dates to lunar dates and vice versa. The app also has the option to setup email alerts for upcoming lunar dates.

System Overview

This system was designed to be both simple and cost-effective, with a primary focus on accurately converting solar dates to lunar dates and vice versa. To streamline development, I opted to use Google's Firebase Auth rather than rolling with my own auth. This led me to leverage other Google services such as Firestore and Cloud Functions. With Firebase's generous free tier and the fact that each date entry is only about 5 bytes of data, the Spark plan is more than sufficient to meet the system's needs at no cost.

A brief overview of the design architecture is shown below:

lunarsolaralerts Architecture