Developer Guide

Documentation

Complete documentation for the Santali Calendar system — from astronomical mathematics to API reference.

Guides

Calculation Guide

Understand the astronomical mathematics behind the Santali lunar calendar — Metonic cycle, leap years, Chandradarshan, and the 19-year cycle.

Calendar System

How the Santali lunisolar calendar works — months, year structure, date mapping to Gregorian, and the continuous Metonic chain.

API Reference

Complete function-by-function reference for the @wesantal/santali-calendar library — types, functions, constants, and usage examples.

npm Package

View the @wesantal/santali-calendar package on npm — installation, versions, and repository links.

Quick Reference

Santali Months

The 12 base months with Ol Chiki names, day counts, and Gregorian ranges.

Leap Year Logic

How the 19-year Metonic cycle determines which years have 13 months.

Festival Calendar

Santali cultural festivals and observances for 2026.

Library

The @wesantal/santali-calendar package is a framework-independent JavaScript/TypeScript library that powers this website. It provides astronomical calendar generation, bidirectional date conversion, moon phase calculations, festival data, and Ol Chiki numeral conversion.

npm install @wesantal/santali-calendar

Base Months

Year Metonic Cycle

Leap Years / Cycle

~2h

Drift / 19 Years