Build streaks. Break bad patterns. One tap to log Water, Exercise, Sleep, and Meditation — with real stats that actually tell you something.
📱 Features • 🏗️ Architecture • 🚀 Getting Started • 🎯 Future Goals • 🔗 Live Demo
Splash Dashboard Habit Stats
Log Entry Entry Detail Date Filter
📂 All high-resolution screenshots are available in the
screenshots/directory.
Most people want to build better health habits — drink more water, exercise regularly, sleep enough, meditate daily. The problem? Habit apps are either:
- Too complex — bloated with features nobody uses, requiring setup that feels like a project.
- Too shallow — basic streak counters with no real insight into your actual patterns.
- Not local-first — requiring accounts, subscriptions, or cloud sync before you can log a single glass of water.
I built Wellora to fix that.
Wellora is a focused, offline-first native Android app that makes habit tracking effortless. Log your Water 💧, Exercise 🏃, Sleep 😴, and Meditation 🧘 in seconds — and get back genuinely useful stats: daily totals, weekly averages, monthly summaries, and consecutive-day streaks. No account. No subscription. No internet required.
One app. Four habits. Complete clarity on how consistent you actually are.
- 2×2 category grid with today's logged total and unit displayed per habit.
- Streak badge (🔥 Nd) automatically surfaces on any card where you have an active consecutive-day streak.
- Dynamic greeting with today's date — the app always feels current.
- One-tap FAB to quickly log any entry without navigating to a specific category first.
- Dedicated stats page for each of the 4 habit types.
- Summary cards showing: total today, total this week, total this month, and weekly average.
- Animated progress bar visualising today's total against the week's best.
- Full scrollable history of every logged entry for that habit.
- Date range filter — tap the calendar to drill into any single day's history.
- Quick-filter chips to toggle between custom date ranges and the default "this week" view.
- Inline delete with a confirmation dialog to prevent accidental removal.
- Supports all 4 habit types from a single form — the unit label auto-updates (ml / min / hrs) as you switch.
- Numeric input with built-in validation: blank and zero values are rejected with clear inline error messages.
- Date picker restricted to today or past dates only — no future logging.
- Optional free-text notes field for context (e.g., "post-gym session", "woke up at 3am").
- Full edit support: pre-populates all fields when editing an existing entry.
- Full read-only breakdown of a single logged entry: habit type, value + unit, date, timestamp, and notes.
- Direct shortcut to edit the entry from the detail screen.
- Calculates consecutive-day streaks per habit type independently using epoch-day arithmetic.
- Streak resets if no entry was logged on either today or yesterday — accurate and honest.
- Streak count displayed live on the dashboard and in the stats screen.
- Built entirely with Jetpack Compose + Material 3.
- Each habit has its own accent colour and icon — Water (blue), Exercise (green), Sleep (indigo), Meditation (purple).
- Animated splash screen with the Wellora logo on launch.
- Snackbar feedback for every create, update, and delete action.
- Fully offline — all data lives in a local Room (SQLite) database.
Wellora is built using the MVVM (Model-View-ViewModel) architectural pattern, with a Repository layer for clean separation between the database and the UI:
wellora/
├── README.md # This file
├── LICENSE # CC BY-NC 4.0 open-source rights
├── screenshots/ # High-res UI captures and GIFs
│ ├── screen_splash.gif
│ ├── screen_dashboard.png
│ ├── screen_stats.png
│ ├── screen_add_edit.png
│ ├── screen_detail.png
│ └── screen_date_filter.png
├── app/
│ ├── build.gradle.kts # App-level build configurations
│ └── src/main/
│ ├── AndroidManifest.xml # App manifest (permissions, components)
│ └── java/com/wellness/habitlog/
│ ├── MainActivity.kt
│ ├── AppNavigation.kt # Sealed routes + NavHost graph
│ ├── data/
│ │ ├── HabitEntry.kt # Room @Entity — core data model
│ │ ├── HabitDao.kt # DAO: queries, aggregates, streak data
│ │ ├── HabitDatabase.kt # Room database singleton
│ │ └── HabitRepository.kt # Abstracts all DAO access
│ ├── viewmodel/
│ │ └── HabitViewModel.kt # State, filters, streak engine, summaries
│ └── ui/
│ ├── screens/
│ │ ├── SplashScreen.kt
│ │ ├── MainScreen.kt # Dashboard grid
│ │ ├── HabitStatsScreen.kt # Per-habit analytics + history
│ │ ├── AddEditScreen.kt # Log / edit entry form
│ │ └── DetailScreen.kt # Read-only entry view
│ ├── components/
│ │ ├── HabitCard.kt # Reusable history list item
│ │ ├── SummaryCard.kt # Animated stats card
│ │ └── HabitUtils.kt # Colour, icon, format helpers
│ └── theme/
│ ├── Color.kt
│ └── Theme.kt # Material 3 colour scheme
├── gradle/ # Gradle wrapper and version catalog
│ └── libs.versions.toml # Centralized dependency management
├── build.gradle.kts # Project-level build configurations
├── settings.gradle.kts # Project settings and module definitions
├── gradlew # Linux/macOS build script
└── gradlew.bat # Windows build script
| Layer | Technology |
|---|---|
| Language | Kotlin 2.0.21 |
| UI Framework | Jetpack Compose + Material 3 |
| Navigation | Navigation Compose 2.7.7 (string-route based) |
| State Management | ViewModel + StateFlow + SharedFlow |
| Local Database | Room 2.6.1 (SQLite) |
| Async / Reactive | Kotlin Coroutines + Flow |
| Annotation Processing | KSP 2.0.21-1.0.25 |
| Architecture Pattern | MVVM + Repository |
| Build System | Gradle KTS + Version Catalog |
| Min SDK | API 26 (Android 8.0 Oreo) |
| Target SDK | API 34 (Android 14) |
The streak algorithm runs entirely in the ViewModel using epoch-day arithmetic — no third-party library required:
// Streak logic — HabitViewModel.kt
private suspend fun calculateStreak(habitType: String): Int {
val epochDays = repository.getDistinctEpochDaysForHabit(habitType).sortedDescending()
if (epochDays.isEmpty()) return 0
val todayEpochDay = (System.currentTimeMillis() / 86_400_000L).toInt()
if (epochDays.first() < todayEpochDay - 1) return 0 // gap > 1 day → streak dead
var streak = 0
var expected = epochDays.first()
for (day in epochDays) {
if (day == expected) { streak++; expected-- } else break
}
return streak
}A streak breaks immediately if the last logged day is more than one calendar day before today — no grace periods, no artificial inflation.
| Screen | What It Does |
|---|---|
| Splash | Animated Wellora logo on launch |
| Dashboard (Main) | 2×2 grid of habit categories — daily totals, streak badges, quick-add FAB |
| Habit Stats | Full analytics for one habit: summary cards, animated progress bar, date-filtered history, inline delete |
| Add / Edit Entry | Single form to log or update any entry — type selector, value input, date picker, notes |
| Detail | Read-only view of a single log entry with edit shortcut |
- Android Studio Hedgehog or later
- JDK 11+
- Android device or emulator (API 26+)
git clone https://github.com/meel-ayush/wellora.git
cd welloraOpen the project in Android Studio → select your device → click ▶ Run
No API keys, no internet connection, no backend required. The app runs fully offline using a local Room database.
Wellora v1.0 stores all data locally using Room (SQLite). Entries persist across app restarts on the same device indefinitely. There is no cloud sync, no user account, and no network dependency — this was a deliberate design decision to ensure the app is instant, private, and dependency-free while the core tracking engine and UX were being validated.
Here's what's planned for upcoming versions:
- Daily targets & progress rings — Set a daily goal per habit (e.g., 2000ml water) and see a progress ring fill in real time.
- Bar / line charts — Visual weekly and monthly trend charts using a charting library.
- Push notifications & reminders — Configurable daily reminders per habit with custom times.
- Cloud sync & multi-device support — Firebase Firestore backend for syncing across devices.
- Custom habit types — Allow users to define their own habits beyond the built-in four.
- Export to CSV — One-tap export of the full history for personal data analysis.
- Widgets — Home screen widgets showing today's totals and streak counts.
- Dark mode — Full Material 3 dynamic colour theming with dark/light toggle.
Most wellness apps are either overkill or oversimplified. Wellora finds the productive middle ground: enough structure to build real habits, enough simplicity to actually use it every day.
This project demonstrates:
- End-to-end native Android development with Jetpack Compose and Material 3.
- Production-grade Room database integration with complex DAO queries (aggregates, date-range filtering, epoch-day streak arithmetic).
- Reactive UI architecture using StateFlow and coroutine-based data pipelines.
- Clean MVVM + Repository separation that is genuinely ready to scale — plug in a Firestore backend and nothing in the ViewModel or UI layer needs to change.
Ayush Meel
This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0).
In short: You are free to download, modify, and use this code privately for local learning or school projects. However, if you share this project or any modifications publicly, you must give clear credit to the original author. You are strictly prohibited from using this project, its code, or its concepts for commercial purposes, generating revenue, or business operations without explicit written permission.