Skip to content

resurrectdev1/Grove

Repository files navigation

Grove

Visualize your growth.

Whether you're maintaining sobriety, breaking harmful habits, or building positive routines, Grove helps you stay focused on consistent progress. Watch your streaks grow, track meaningful milestones, and cultivate a forest of procedurally generated fractal trees that evolve alongside your journey. Every day of progress helps something beautiful take root.

How does it work?

Simply open Grove and click the "Plant a Tree" button then select your tracking mode, color & name of your habit! Once you give your tree a name and color, click "Plant Tree" to see it come to life on your home screen :) You can then click on any habit to open a menu showing you your total relapses (or check-ins), your best record, and your current streak. There is also additional information, such as a "time since last relapse" or "check-in details) tracker and an interactive calendar where you can report a relapse (or check-in), add notes, and even edit past or present times. Just under that, you will find a full history of your recorded relapses (or check-ins) along with the reasons why!

Tracking Modes

🌱 Abstinence Mode: for quitting something. Track your current streak, your all-time best, and every relapse with notes on what happened.

📅 Check-In Mode: for building something. Check in daily to build your streak, mark days as excused (rest days, vacations, etc.) without breaking it, and freeze your streak for when life gets in the way.

Features

🌳 Grow your forest: Each habit is a unique, procedurally generated fractal tree that grows through real stages as you stay consistent.

🌀 Dynamic Layouts: Experience your forest your way. Switch between a 3D vertical drum roll, a smooth horizontal carousel, a compact grid, or a streamlined list.

🎨 Customizability: A tree hex color picker and a built-in theme engine supporting custom accent themes and Android 12+ Material You, allowing you to adjust your app's palette to your exact liking.

📈 Analytics: Beyond simple streaks, Grove tracks your peak record, total relapses, and time you've spent clean since your last relapse as well as the reasons why logged across an interactive monthly calendar.

❄️ Streak Freeze & Excused Days: Take a planned break without losing your progress, freeze a streak or mark a day as excused in Check-In Mode.

🗂️ Full Habit Management: Rename, reorder, recolor or delete habits at any time, within the homescreen or detailed habit view.

🪟 Home Screen Widgets: Keep your journey visible at a glance with a live tree widget and a calendar widget integrated right into your home screen.

🔔 Reminders: Get notified as your tree hits each growth milestone, keeping you motivated to stay on track.

🔒 Privacy-Focused: Keep your journey private with biometric, fingerprint, or PIN authentication, plus local backup options for peace of mind.

🌐 Fully Offline: Fully functional without an internet connection. No cloud, no tracking. Your data stays where it belongs: solely on your device.

🌎 Localization: Grove is available in 14 languages being: English, Arabic, German, Spanish, French, Hindi, Italian, Japanese, Korean, Portuguese, Urdu, Vietnamese, and Chinese (Simplified & Traditional) aswell as automatically adapting to your device's current language settings.

What's New

Grove is under active development. See CHANGELOG.md for the full release history.

Download

Get it on GitHub OpenAPK.net Get it on Obtainium Get it on F-Droid

Press & Mentions

🗣️ 少数派 (SSPAI): Featured in a roundup of noteworthy apps, covering both tracking modes, Material You theming, and the drum roll layout.

🍦 Material You App List: Listed under Habit Tracker as an MDY FOSS app.

📱 阿呆的博客: Included in a curated list of Android apps worth using.

Support The App

Grove is free forever: no subscriptions, no ads, and no data harvesting. Just you and your trees. If Grove has helped you or someone you know stay clean and build better habits, consider supporting its continued development so it can keep growing.

Buy me a Coffee

Development

Grove is built using Flutter, pinned to a specific version (see flutter in pubspec.yaml) to keep builds consistent. Install Flutter at that version, or use FVM to manage it (fvm install && fvm use ).

Before your first build, make sure you also have:

JDK 21 installed (e.g. Eclipse Temurin 21), with JAVA_HOME pointed at it. This is the most common source of build failures - if Gradle fails with a Java-related error, check this first. The Android SDK licenses accepted. Run sdkmanager --licenses (without sudo - see the troubleshooting note in CONTRIBUTING.md if you hit a permissions error here). Then clone the repository, enter the project directory, and run flutter pub get (or fvm flutter pub get), followed by connecting your phone with USB debugging enabled, granting the necessary permissions, and finally running flutter run --release (or fvm flutter run --release).

See CONTRIBUTING.md for more on the project structure, code style, and setup details.

License

This software is licensed under the GNU General Public License 3.0.

GNU GPLv3 Image

Sponsor this project

Contributors