Payanam (பயணம்)

Your Progress, Your Privacy — Local-first life dimension manager for Android + Desktop

Latest Builds:

• 🔧 Dev (rolling): latest-dev — pre-release, multiple builds/day
• 🧪 Beta (rolling): latest-beta — pre-release, ~2 builds/week
• 🚀 Stable (rolling): latest-stable — stable, ~2 builds/month

Payanam is a privacy-first life dimension manager — tasks, habits, time tracking, journal, and insights across the dimensions of life you define. All data stays on your device. No cloud, no accounts, no tracking.

See VISION.md for philosophy and roadmap.

---

Screenshots

English (EN)

Tamil (தமிழ்)

---

Quick Start

# Build debug APK (requires Java 17 + Android SDK 35)
./gradlew assembleDebug

See INSTALL.md for sideload and verification steps. See docs/CONTRIBUTING.md for development setup and PR workflow. See CHANGELOG.md for what's new.

---

Features

Status	Feature
✅	Tasks — Full CRUD with priority scoring (9-factor weighted formula), templates, recurring, tags, reminders
✅	Habits — 8 life dimensions, binary + numeric types, score carry-forward
✅	Time Tracking — Per-dimension sessions with timeline view
✅	Insights — Charts, dimension scoring dashboard, daily stats
✅	Journal — Daily notes with dimension tagging
✅	Tamil (தமிழ்) — Full string parity in values-ta/
✅	Desktop foundation — Compose Desktop with Windows EXE/MSI
🔄	Export / Import — Auto-backup + manual export/import with passphrase
⏭️	Cross-device sync (planned)

---

Tech Stack

Layer	Choice
Language	Kotlin 2.0
UI	Jetpack Compose + Material3
Database	Room (SQLite, local-only)
DI	Hilt (Dagger)
Architecture	Multi-module, MVVM + Repository
Desktop	Compose Multiplatform
Min SDK	28 (Android 9)
Target SDK	35

---

Project Structure

payanam/
├── app/                    # Android app (UI, ViewModels, DI)
├── desktop/                # Compose Desktop foundation
├── core/
│   ├── shared/             # Cross-platform contracts (Android + Desktop)
│   ├── domain/             # Domain models, repository interfaces
│   ├── database/           # Room entities, DAOs, migrations, repositories
│   ├── scoring/            # Task priority scoring engine
│   └── common/             # Shared utilities, logging, sanitizer
├── build-tools/            # Build automation scripts (PowerShell)
├── config/                 # Detekt, Spotless quality config
├── gradle/                 # Gradle wrapper + version catalog
└── docs/                   # Vision, contributing guide, DB architecture

---

Build

# Debug APK
./gradlew assembleDebug

# Release APK (minified)
./gradlew assembleRelease

# Unit tests + coverage
./gradlew test coverageCheck

# Static analysis
./gradlew preCommitCheck

Windows users can also use .\build-tools\scripts\build-android.ps1 for the full pipeline (preflight checks, device install, smoke tests).

---

Credits

Inspiration from uHabits, SATT, and Google Stitch.
Third-party libraries: AndroidX, Compose, Hilt, Room, Coroutines, Vico Charts, Timber.

---

License

AGPL-3.0 — All modifications must be shared under the same terms.