Skip to content

Repository files navigation

Kalora Logo

Kalora

A beautiful and minimalist Hindu Calendar, Panchang & Sacred Festival Reminder app for Android.
Built with Jetpack Compose, Material 3, Material You dynamic colors, and the "Inverted Corner" design language.

Kotlin Compose Android License


📝 About Kalora

Kalora is a powerful, offline-first Android Hindu calendar application that brings accurate Panchang calculations, tithis, Nakshatras, and sacred festival details right to your fingertips. Built with an emphasis on cultural reverence, elegant typography, and Material 3 design, Kalora lets you stay connected with traditional observances and schedule custom festival reminders with sacred audio chimes (Temple Bell, Sacred Shankh).

Part of the Ora Suite by developer Maheswara660.


🛠️ Technology Stack

Component Technology Version Description
Core Language Kotlin 2.0.0 Modern, null-safe, and high-performance programming language.
UI Framework Jetpack Compose Material 3 Declarative UI engine with custom Inverted Corner panels.
Theme System Material You Dynamic Wallpaper-based dynamic color schemes (Android 12+) with AMOLED dark mode.
Calendar Engine Custom Panchang Native On-device calculation of Tithi, Paksha, Masa, Nakshatra, and Vikram Samvat.
Reminders AlarmManager & Local Notifications AndroidX Precise scheduled alerts with custom audio chimes.

✨ Key Features

📅 Panchang & Lunar Calendar

  • Accurate Tithis: View daily Gregorian dates alongside Hindu tithis (Shukla and Krishna Paksha).
  • Vikram Samvat Era: Displays current Vikram Samvat year and Masa details for any chosen date.
  • Month Navigation: Easily jump between past, current, and future months with full calendar grid rendering.

🚩 Sacred Festival Repository

  • Rich Observance Guides: Access detailed festival guides containing spiritual significance and sacred ritual instructions.
  • Multilingual Descriptions: Instant localized festival names and descriptions in English, Hindi (हिन्दी), and Telugu (తెలుగు).

🔔 Custom Event & Festival Reminders

  • Scheduled Alerts: Set custom reminders for any calendar date or festival with custom trigger times.
  • Sacred Chimes: Choose between Temple Bell, Sacred Shankh, or default system notification sounds.
  • Active Reminder Management: Manage and toggle your active reminders with clean Material 3 controls.

📸 Interactive UI Gallery

📱 Home Calendar & Reminders

Home Calendar & Panchang New Reminder Dialog Active Reminders

📖 Festival Details & Sacred Rituals

Spiritual Significance & Rituals Guide Holiday Details

🌐 Multilingual Support (English, Hindi, Telugu)

English Interface हिन्दी (Hindi) తెలుగు (Telugu)

🚀 Installation & Requirements

System Requirements

  • OS: Android 7.0 (Nougat) or higher (Min SDK 24).
  • Architecture: Universal APK support (arm64-v8a, armeabi-v7a, x86, x86_64) including 16KB page-size support.
  • Bluestacks Compatibility: Fully compatible with Bluestacks 5 and Android emulators.

🏗️ Build from Source

Ensure you have Android Studio Ladybug (or later) and JDK 17/21 configured.

# Clone the repository
git clone https://github.com/maheswara660/Kalora.git

# Enter the project directory
cd Kalora

# Build debug and release APKs
./gradlew assembleDebug assembleRelease -x lint

❤️ Support & Community


📜 License

Kalora is open-source software licensed under the GNU General Public License v3.0. See the LICENSE file for details.

Kalora — Sacred Panchang & Festival Companion.
Made with ❤️ by Maheswara660

About

A beautiful, modern Hindu Calendar & Panchang app for Android built with Jetpack Compose & Material 3. Features tithi calculations, sacred festival guides, custom event reminders, sacred chimes, Material You dynamic themes, and multilingual support (English, Hindi, Telugu).

Topics

Resources

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

Sponsor this project

Contributors

Languages