Tasks, habits and notes. Free, open-source, 100% offline.
No accounts, no ads, no tracking, no servers. Your data never leaves your phone.
-3DDC84?logo=android&logoColor=white){kind=icon}
Get the latest APK :
- Download the APK (Android 12 or newer).
- Open it and tap Install — Android will ask you to allow installs from your browser once.
- That's it. Updates install on top of the previous version and the data remains.
Tasks
- Create, edit and delete tasks with sub-tasks, priorities and due dates
- Swipe actions and drag & drop reordering
- Auto-save while editing and reminders
Habits
- Boolean and numeric habits (kilometers, glasses of water, minutes…)
- Streaks and progress statistics
- Home-screen widgets
Notes, checklists & ideas — quick capture built in
Calendar view of your schedule
Make it yours
- Material 3 Expressive design with Material You dynamic colors
- Pure black/white theme options and system font support
- Reorderable category tabs — organize the app your way
- English & Spanish
Privacy by design
- 100% offline: no accounts, no analytics, no tracking
- Local database only, with backup & restore
- More widgets
- Mood tracking
- Your suggestions → open an issue
I wanted to build a fully-featured Android app that is completely free, ad-free and privacy-focused — no servers, no tracking, no data collection, working 100% offline. This project was also a way for me to learn modern Kotlin (coming from a Java-only background) while creating something truly customizable that others can easily modify, extend and adapt.
Build from source
- Android Studio
- Android SDK 31 (Android 12)
- Clone the repository
git clone https://github.com/Markel15/flowstate.git cd flowstate - Open in Android Studio → Open an Existing Project → select the cloned directory.
- Build and Run on a device or emulator running API 31+.
Architecture & tech stack
FlowState follows Clean Architecture with a clear separation of concerns:
UI Layer (Presentation)
├── ViewModels
├── Composable Screens
└── UI State Management
Domain Layer (Business Logic)
├── Use Cases (Interactors)
├── Repository Interfaces
└── Domain Models (Task, SubTask, Habit)
Data Layer (Infrastructure)
├── Repository Implementations
├── Local Data Source (Room)
└── Data Models (Entities)
| Component | Technology |
|---|---|
| UI Framework | Jetpack Compose |
| Architecture | Clean Architecture + MVVM |
| Database | Room |
| DI | Hilt |
| Async | Kotlin Coroutines |
| Navigation | Navigation 3 |
| Animations | Compose Animation APIs |
Contributions are welcome!
- Found a bug? Check the Issues to avoid duplicates, then open one with a clear description, steps to reproduce, expected vs actual behavior, and screenshots/device info if possible.
- Have an idea? Open an issue describing the use case (mockups welcome).
- Want to code? Fork the repo, create a feature branch (
git checkout -b feature/amazing-feature), make your changes (tests and docs when possible), and open a Pull Request.
FlowState is open-source software licensed under the Apache License 2.0.
You can verify the downloaded APK with this SHA-256 signing certificate fingerprint:
96:D8:09:A2:9E:23:CA:55:F8:A3:45:A5:12:50:6B:63:05:96:B1:25:CE:6F:7E:B5:1E:A5:53:98:4F:80:E6:FD