About 吉日曆
Open the app and see “what today is good for” — that is what 吉日曆 (JiLi, “Lucky Day Calendar”) is.
I built this because my elders flip through a paper Chinese almanac every morning to see what today is auspicious for, what to avoid, which zodiac sign should be careful, whether the solar term has arrived, and whether it is a good day to move house or open a business. There are plenty of Chinese almanac apps on the market, but most are stuffed with ads, the text is tiny, and the navigation is layered three menus deep. I wanted a version simple enough that they would use it without asking me how.
Big text, no fluff, everything on one page. Runs entirely on your device with no backend server. A single banner ad at the bottom supports the work.
Home Screen: Yesterday / Today / Tomorrow at a Swipe
The top row shows today’s Gregorian and lunar dates. Below that: the auspicious-day marker, what today is good for, what to avoid, which zodiac signs are in conflict, and today’s auspicious hours. Swipe left or right to jump to yesterday or tomorrow — no menus, no buttons.
This is the page elders open most. They do not need to learn any gestures — “just swipe” is the whole instruction.
Calendar: Solar Terms, Holidays, Makeup Workdays at a Glance
Built on table_calendar with custom cells that compress lunar dates, solar terms, Taiwanese national holidays (in red), auspicious-day gold dots, and makeup workday markers into a single grid square. Tap any day to jump to its detail page.
Taiwan national holidays for 2024, 2025, and 2026 are bundled in — sourced from the open-source ruyut/TaiwanCalendar project. The 2027 holidays will be added once the official Taiwanese government announcement is published.
Day Detail: Full 宜忌 with Plain-Language Explanations
On a single day’s detail page, you get:
- Three pillars (year, month, day) of Heavenly Stems and Earthly Branches
- Full 宜忌 entries — every auspicious/inauspicious item annotated with a plain-language explanation, not just three opaque classical characters
- Zodiac clash with a “your family’s signs” indicator that tells you who in your household should be careful today
- Twelve traditional hours with auspicious/inauspicious markings
- Pengzu’s hundred taboos (彭祖百忌)
- Pregnancy-spirit direction, sound element, building category, and Heavenly Way label (胎神／納音／建除／黃道)
The design goal: every classical term on this page has its explanation directly underneath. Elders do not need to Google anything.
Date Selection: Picking Days for Major Life Events
Supports the four major occasions — wedding, moving house, opening a business, and entering a new home — plus secondary items like cesarean delivery, bed placement, travel, and burial. Enter your zodiac sign and your family members’ signs, and the App automatically filters out clashing days, then ranks the remaining candidates by their 宜 entries.
All results are shown in full, with no unlock requirements and no Pro subscription. Date selection is a folk tradition; it should not be behind a paywall.
Zodiac Fortune: 12 Signs Daily
Daily fortune for all 12 zodiac signs, computed deterministically and offline — the same day and same sign yields the same result on any device. No “watch another ad to unlock” tricks.
Reminders: Solar Terms, Lunar Birthdays, Anniversaries
Reminder types you can set inside the App:
- Solar terms: pushed at 9:00 AM the day before each solar term
- Lunar birthdays: family and friends’ lunar birthdays; the App converts them to the current year’s Gregorian date automatically
- Anniversaries: weddings, memorials, or any custom event
- Custom: any date, any text
All reminder data is stored locally in Hive on your device, scheduled through flutter_local_notifications — no server, no login.
Settings: Elder-Friendly by Design
- Font size: small, medium, large — default medium, easy to bump up
- Theme: follow system, light, dark
- First day of week: Sunday or Monday
- Holiday / solar term display toggles
- Notification toggle
- My zodiac sign, family members’ signs — drives the clash warnings
- Clear cache, reset, rate, share, privacy policy
Ads: Bottom Banner Only
吉日曆 serves ads through Google AdMob — a single adaptive banner at the bottom. No interstitials, no app-open ads, no rewarded ads, no native ads.
On iOS 14.5+, Apple’s App Tracking Transparency (ATT) prompt appears on first launch; EU users see the Google UMP consent dialog. It is fine to decline either: non-personalized ads will be served instead, and the App works in full.
Full data disclosure is in the privacy policy.
Who It’s For
- People whose elders flip through a paper Chinese almanac every morning
- People who want to look up auspicious dates, solar terms, or zodiac fortune without bookmarking websites or flipping paper almanacs
- People who have tried other Chinese almanac apps and are tired of ad-spam, paid unlocks, and tiny text
- Anyone interested in traditional Taiwanese folk-calendar customs
Technology
吉日曆 is built with Flutter. Lunar-calendar calculations use the open-source lunar package (which outputs Simplified Chinese internally; a bundled OpenCC s2tw mapping table converts all output to Traditional Chinese, with full-year scanning tests in CI to ensure no Simplified characters leak through). Local storage is Hive plus SharedPreferences; notifications run through flutter_local_notifications with timezone.
Ads are integrated via google_mobile_ads 5.3.x, with UMP consent management and iOS ATT. The App contains no analytics, no tracking, and no crash-reporting SDKs, and no backend server — every calculation happens on your device.
Full data-collection disclosure is in the privacy policy.
Get Started
吉日曆 is available on the iOS App Store. Download on the App Store.
Developed by Steven Huang at Atlantis Kid. Made for Taiwanese families.