Getting Started

How do I add a person?

Tap the + button on the People tab. You can add someone manually by entering their name and birthday, or tap "Import from Contacts" to pull birthdays directly from your address book.

How do I set up my family tree?

First, add yourself and mark "This is me". Then add family members and assign relationship types (Spouse, Child, Parent, Sibling, Grandparent). The Family tab shows everyone organized by relationship with dual age cards.

What's the difference between Gregorian and Hijri age?

The Gregorian calendar is the standard solar calendar (365 days/year). The Hijri calendar is the Islamic lunar calendar (354 days/year). Because lunar years are shorter, a person's Hijri age is always slightly higher than their Gregorian age. This matters for Islamic milestones like the age of prayer.

Islamic Milestones

When should my child start praying?

Many scholars recommend teaching children to pray at 7 lunar (Hijri) years old, and encouraging regular prayer by age 10. MoonAge calculates the exact Hijri age and shows a countdown to these milestones so you never miss them.

What milestones does MoonAge track?

Over 20 milestones including: Age of Discernment (7 Hijri), Prayer Discipline (10 Hijri), Age of Responsibility (15 Hijri), Age of Prophet Isa (33 Hijri), Age of Wisdom (40 Hijri), Age of Prophet Muhammad (63 Hijri), plus secular milestones like school age, driving age, and decade birthdays.

Widgets

How do I add a widget?

Long-press your iPhone home screen, tap the + button in the top corner, search for "MoonAge". Choose from small, medium, large, or lock screen sizes. The widget shows upcoming birthdays with both calendar ages.

Can I customize what the widget shows?

Yes. Long-press the widget and tap "Edit Widget". You can choose to show All People, Favorites only, or Family only. Tap any person on the widget to jump directly to their profile in the app.

Sharing & Search

How do I share a birthday card?

Open a person's profile and tap the share button (top-right corner). MoonAge generates a beautiful card image showing both Gregorian and Hijri ages. Share it via WhatsApp, iMessage, Instagram, or any app.

Can I search for people from the home screen?

Yes. Swipe down on your home screen to open Spotlight search and type a name. MoonAge indexes all your people so they appear in system search. Tap a result to open their profile directly.

Contacts & Sync

Does MoonAge sync with my Contacts?

Yes, bidirectionally. When you import someone from Contacts, they stay linked. If you update their birthday in the Contacts app, MoonAge updates automatically on next launch. If you edit them in MoonAge, changes sync back to Contacts.

Is my data backed up?

If iCloud is enabled on your device, your data syncs automatically across all your Apple devices (iPhone and iPad) via CloudKit. No setup required.

Premium

What does Premium include?

Premium ($0.99, one-time purchase) unlocks: unlimited people, family tree, groups, widgets, calendar export, advanced reminders, lunar calendar details, and iCloud sync. Free users can track up to 5 people.

How do I restore my purchase?

Go to Settings > Upgrade to Premium and scroll down to tap "Restore Purchases". Make sure you're signed in with the same Apple ID used for the original purchase.

Reminders & Calendar

How do birthday reminders work?

Go to Settings > Notification Settings. Choose when to be reminded: on the day, 1 day, 3 days, 7 days, or 14 days before. Tap any notification to jump directly to that person's profile.

How do I export birthdays to my calendar?

Open a person's profile and tap "Add to Calendar" in Quick Actions. This creates a recurring birthday event in your Apple Calendar.

Coming Soon

Apple TV Coming Soon

MoonAge for Apple TV is in development. View your family's ages and upcoming birthdays on the big screen. Stay tuned for updates.

Siri Shortcuts Coming Soon

Ask Siri "When is Ahmad's birthday?" and get an instant answer. App Intents integration is coming in a future update.

Contact Us

Have a question, suggestion, or found a bug?

We usually respond within 24 hours.