The Short Version
Start with daily Panchang for today screens and use monthly or yearly responses when your platform needs upcoming observances, vrat calendars, or annual festival planning. Festival and regional data should be presented with enough context for users to understand why dates can vary across traditions.
For reminder systems, keep DevDarsha calls on your backend, cache upcoming schedules, and store the resolved location and request ID with any user-visible event generated from the API.
Common Devotional Workflows
- Daily worship: show Tithi, Nakshatra, sunrise, sunset, and relevant day context on home screens.
- Vrat reminders: schedule observance notifications from monthly or yearly calendar data.
- Puja planning: combine Muhurat windows, festival context, and location-specific dates.
- Temple schedules: prepare upcoming festival lists and special-day content for a region or city.
Regional Observance Design
Devotional audiences often expect local calendar behavior. If your product serves multiple regions, make region or city selection explicit and keep the chosen context visible in account settings, reminder setup, and support logs.
When a festival appears on a different date than another publisher, compare location, timezone, calendar tradition, and regional rule before treating it as an error. Your help text should make this easy to explain.
Hard-coded dates age badly and hide rule differences. Use API-backed schedules, then cache the generated reminders or editorial lists in your own backend.
Choosing Endpoints
Use daily calls for a user's current day experience. Use monthly calls for upcoming vrat lists, calendar screens, and content planning. Use yearly calls when you need a full annual festival list, but budget quota carefully and refresh on a deliberate schedule.
For public widgets and high-traffic pages, avoid calling the API directly from the browser. Generate and cache the relevant devotional schedule server-side, then render it from your own application.
Reminder and Notification Rules
Reminder systems should store the calculated event date, location context, source response metadata, and the version of your reminder rule. When a user changes region or city, regenerate their future reminders instead of reusing the old schedule.
When users ask why a vrat reminder fired on a specific day, support should be able to see the selected region, calculation date, API version, and request ID.
Launch Testing Checklist
- Test Ekadashi, Amavasya, Purnima, Navratri, Diwali, Holi, and major regional observances your platform highlights.
- Verify one-day and multi-day festival display states.
- Check reminder regeneration after city or region changes.
- Confirm plan-gated behavior for monthly, yearly, Muhurat, regional, and all-layer festival data.