Skip to main content

​
Overview

Lok Panchang is a WhatsApp-based daily Panchangam (Hindu calendar) notification service. It sends personalized panchangam messages to users at 6:30 AM in their local timezone.

​
What you’ll find here

  • Getting started — This overview and how to run the project.
  • Guides — Step-by-step guides for testing routes, deployment, and more.

​
Key concepts

  • Panchangam — Daily Hindu almanac data (tithi, nakshatra, yoga, sun/moon times, etc.) computed for a location and date.
  • Webhook — WhatsApp Cloud API sends events to our API; we respond with template messages.
  • JIT scheduling — Celery Beat and workers schedule sends per timezone so each user gets panchangam at 6:30 AM local time.

​
Running locally

  • Main API: see the repo root README.md for Flask, Celery, Redis, Postgres.
  • Admin portal: admin_portal/ — separate frontend and backend.
  • Docs (this site): run mint dev from the docs/ directory. The preview runs at http://localhost:3000.
Production docs are served at docs.lokpanchang.com via Caddy and the docs Docker service (port 5003).