> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lokpanchang.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Documentation for the Lok Panchang WhatsApp Panchangam notification service

## 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](http://localhost:3000)**.

Production docs are served at **docs.lokpanchang.com** via Caddy and the `docs` Docker service (port 5003).