🌊 RoutineFlow

A Modern, Adaptive Habit Tracker & Daily Routine Planner for Android
Intelligent Schedules • Rolling Consistency Analytics • Streak Milestones • Micro-Interaction Celebrations

---

📑 Table of Contents

• 📥 Download & Releases
• 🌟 What is RoutineFlow?
• ✨ Key Features
• 📱 Feature Showcase
• 🏗️ Architecture & Tech Stack
• 🚀 Building from Source
• 📜 Attribution & License

---

📥 Download & Releases

You can install RoutineFlow directly on your Android device without needing the Google Play Store:

📦 Latest Release: v1.1.0 (Latest)

File	Version	Download Link
RoutineFlow-v1.1.0.apk	v1.1.0 (Latest)	⬇️ Download v1.1.0 APK
RoutineFlow-v1.0.0.apk	v1.0.0	⬇️ Download v1.0.0 APK
All Releases	Archives & Notes	📦 GitHub Releases Hub

💡 How to Install:

1. Download RoutineFlow-v1.1.0.apk to your Android phone.
2. Open the file from your downloads folder.
3. If prompted, enable "Install from unknown sources" for your browser/file manager.
4. Tap Install and launch RoutineFlow!

---

🌟 What is RoutineFlow?

Most habit trackers punish you harshly with broken streaks whenever life gets in the way. RoutineFlow is built on a fundamentally smarter principle: Adaptive Habit Tracking.

It combines a clean calendar agenda with an intelligent scheduling engine that understands real human life. Whether you track habits daily, 3 times a week on flexible days, or monthly goals, RoutineFlow accounts for non-due days, allows you to clear backlogs flexibly, and gives you deep visibility into your long-term consistency.

---

✨ Key Features

📊 1. Consistency Analytics & Streak Milestones (New)

• Rolling Consistency Score: Real-time calculated consistency rate percentage and animated progress indicator for every habit.
• Streak Milestone Badges: Unlock milestones as your consistency builds:
  • 🥉 7-Day Bronze Champion
  • 🥈 30-Day Silver Master
  • 🥇 100-Day Gold Legend
• Comprehensive Statistics: Detailed breakdown of active streaks, longest historical streak, and total completed sessions.

🎆 2. Habit Completion Celebrations (New)

• Micro-Interaction Particle FX: 60-FPS fluid particle burst celebration when checking off routines in your daily agenda.
• Dopamine-Positive Feedback: Instant visual reward designed to build positive habit loops.

🔄 3. Adaptive Scheduling Engine

• Intelligent Backlog Management: Missed a habit? RoutineFlow suggests resolving your backlog on the next non-due day without breaking your streak.
• Over-Completion Balancing: Completed a routine ahead of schedule? Next planned sessions automatically balance out.
• Flexible Frequencies: Full support for daily, weekly (any days or specific days of week), monthly, and alternate-day intervals.

📅 4. Agenda & Calendar Integration

• Clean Agenda View: Distraction-free daily task lists for any selected date.
• Long-term Planning Calendar: Visual calendar displaying completions, streaks, and future planning dates.

🎨 5. Advanced mpvEx-Style Theme Engine (New)

• Curated Color Palettes: Choose from iconic developer and designer palettes:
  • 🌊 RoutineFlow Teal (Default brand cyan & emerald)
  • 🐱 Catppuccin (Mocha dark & Latte light pastel vibes)
  • ❄️ Nord (Arctic frost Scandinavian aesthetics)
  • 🧛 Dracula (High-contrast vampire purple & pink)
  • 🌆 Tokyo Night (Neon cyberpunk dusk)
  • 🌅 Sunset Coral (Warm amber & coral glow)
  • 🔮 Material You / Monet (Wallpaper dynamic colors on Android 12+)
• Theme Modes: Seamless switching between Follow System, Light Mode, and Dark Mode.
• Pure Black (AMOLED): Pitch #000000 deep black mode for maximum OLED battery savings.

📱 6. Dynamic App Icon Switcher (New)

• Switch your home screen launcher icon directly inside Settings to match your phone's aesthetic:
  • 🌊 Default (Teal): Original clean ocean cyan & emerald progress rings.
  • 🔴 Nothing / NAM Edition: Nothing OS dot-matrix progress ring with iconic signature red accent dot (crafted for Nothing / NAM icon pack setups).
  • 🎨 Material You: Dynamic Monet soft pastel dual-tone adaptive icon.
  • 🖤 AMOLED Black: Ultra-minimalist pitch black with pure white geometry.

🟩 7. 365-Day Consistency Heatmap (New)

• Year-long 52-week contribution punch card (GitHub-style) in Routine Details visualizing full annual habit consistency.
• Smooth horizontal panning across the entire past year with automatic completion day counts and color intensity tiers.

💾 8. Offline JSON Backup & Restore (New)

• One-tap JSON backup creation & restore via native Android Document Picker.
• Zero cloud lock-in: Keep complete offline control over your habits, schedules, and history.

📳 9. Tactile Haptic Feedback & Home Screen Widget (New)

• Tactile Haptics: Subtle mechanical vibrations on checking routines and milestone celebrations.
• Home Screen Widget: Glanceable Android AppWidget displaying today's habits and direct Agenda launcher.

🔤 10. Dynamic Font Engine & Custom Typography (New)

• Preset Font Styles: Google Sans, Nothing Dotted, Nothing Sans, Samsung One UI, Claude Serif, and Default System.
• Custom Font Import: Load any .ttf or .otf font file directly from your device storage into RoutineFlow.

🗑️ 11. Long-Press Multi-Select Batch Deletion (New)

• Long-press any habit card in the Agenda to trigger Selection Mode with checkboxes, Select All, and batch deletion.

🔒 12. 100% Offline & Private

• Zero Tracking: No telemetry, no third-party analytics, no tracking SDKs.
• No Account Required: Works completely offline. Your confidential habit data never leaves your device.
• 100% Free: No subscriptions, no ads, and fully open-source under GPL v3.

---

📱 Feature Showcase

Agenda View	Flexible Schedules	Habit Customization
Clean daily agenda with dynamic calendar bar	Adaptive weekly, monthly, and daily rules	Personalized targets, streak goals, and notifications

---

🏗️ Architecture & Tech Stack

RoutineFlow is engineered following Google's Now In Android modularization standards and CLEAN Architecture principles:

graph TD
    App[":app Application Module"] --> FeatureAgenda[":feature:agenda"]
    App --> FeatureDetails[":feature:routinedetails"]
    App --> FeatureAddEdit[":feature:addeditroutine"]
    
    FeatureAgenda --> CoreUI[":core:ui"]
    FeatureAgenda --> CoreDomain[":core:domain"]
    FeatureDetails --> CoreUI
    FeatureDetails --> CoreDomain
    FeatureAddEdit --> CoreUI
    FeatureAddEdit --> CoreDomain
    
    CoreDomain --> CoreData[":core:data"]
    CoreDomain --> CoreLogic[":core:logic"]
    CoreDomain --> CoreModel[":core:model"]
    
    CoreData --> CoreDatabase[":core:database (SQLDelight)"]
    CoreData --> CoreModel

Loading

Core Technologies:

• UI: 100% Jetpack Compose with Material 3 (Single Activity, zero Fragments).
• Architecture: MVVM + CLEAN with Repository and Use-Case patterns.
• Dependency Injection: Koin (configured for seamless Kotlin Multiplatform expansion).
• Database: SQLDelight for local SQLite storage with Flow extensions.
• Asynchronous Streams: Kotlin Coroutines & StateFlow.
• Date & Time Engine: kotlinx-datetime and com.kizitonwose.calendar.
• Build System: Gradle multi-module build with custom convention plugins in build-logic.

---

🚀 Building from Source

Prerequisites:

• Android Studio: Koala / Ladybug (2024.1+) or newer
• JDK: Java 17 or Java 21
• Android SDK: API level 34+ (minSdk 26)

Steps:

1. Clone the repository:

   git clone https://github.com/AizenIndex/RoutineFlow.git
   cd RoutineFlow

2. Open in Android Studio: Open the root project folder in Android Studio and let Gradle sync dependencies.

3. Build and install debug APK:

   ./gradlew :app:assembleMinSdk26Debug

   The APK binary will be generated at app/build/outputs/apk/minSdk26/debug/.

---

📜 Attribution & License

Important

RoutineFlow is an open-source evolution and modernized fork based on RoutineTracker created by Daniel Rendox.
We gratefully acknowledge and credit Daniel Rendox for the foundational scheduling concepts and clean architecture design.

License

This project is licensed under the GNU General Public License v3.0 (GPL v3).
You are free to use, modify, and distribute this software under the same license. See the LICENSE file for complete terms.