A beautiful and intuitive habit tracking app built with Jetpack Compose. Track your daily habits, monitor your progress with visual indicators, and build better routines. The app features a GitHub-like contribution graph, weekly calendar view, customizable habit categories with different colors, and a clean Material Design interface with dark/light theme support.
- Track daily habits with progress indicators
- Weekly calendar view with completion status
- GitHub-like contribution graph (182 days / 6 months view)
- Customizable habit categories and colors
- Dark/Light theme support
- Settings with various customization options
- Multiple completions per day support
- Habit description and notes
- Random data generator for screenshots/demos
- Create, edit, and delete habits
- Set target count for habits (1+ completions per day)
- Habit frequency options (Daily, Weekly, Monthly, Custom)
- Category-based organization
- Habit templates/presets (common habits like exercise, meditation, reading)
- Archive functionality for inactive habits (keep history but hide from main view)
- Habit reordering by drag and drop (priority sorting)
- Search and filter UI for habits (by name, category, streak)
- Display streaks prominently on habit cards (current streak and longest streak badges)
- Analytics dashboard screen with charts (completion rates, trends, best days)
- Habit detail screen showing full statistics and completion history
- Yearly/monthly overview screens with calendar heatmap
- Habit chains visualization (visual chain showing consecutive days)
- Weekly/monthly reports with insights (best performing habits, areas to improve)
- Habit streaks tracking (backend implemented)
- Completion statistics and progress tracking
- Notification system for habit reminders (WorkManager + NotificationManager)
- Reminder time setting (UI ready, notifications not implemented)
- Add ability to edit/add notes when completing habits (tap completion to edit)
- Undo completion feature (swipe to undo recent completions)
- Quick actions (complete all habits for today, quick add common habits)
- Onboarding tips/tutorial for first-time users
- Custom icon picker for habits (use existing icon field)
- Streak freeze feature (allow skipping days without breaking streak)
- Achievement badges/milestones system (7-day streak, 30-day streak, 100 completions)
- Motivational quotes or encouraging messages when completing habits
- Backup and restore functionality (export/import JSON/CSV)
- Data export options (share progress as image, export to CSV for Excel)
- Progress photos/attachments to habit completions
- Habit sharing (share progress graphs as images to social media)
- Random data generator for creating demo screenshots
- Home screen widget showing today habits and completion status
- Dark mode scheduling (auto-switch based on time of day)
- Language: Kotlin
- UI Framework: Jetpack Compose
- Architecture: MVVM (Model-View-ViewModel)
- Database: Room Database
- Dependency Injection: Manual DI (can be upgraded to Hilt/Koin)
-
Clone the repository
git clone https://github.com/yourusername/HabitQuest.git
-
Open in Android Studio
- Make sure you have Android Studio Hedgehog or later
- Ensure Kotlin plugin is installed
-
Build and run on your device
- Connect an Android device or start an emulator
- Click Run or press
Shift+F10
Add screenshots of your app here
See the Features section above for a complete list of planned features. Priority items include:
- Notification system implementation
- Analytics dashboard
- Home screen widget
- Backup and restore functionality
Contributions are welcome! Please feel free to submit a Pull Request.
Add your license here
Built by Mohammad Faizan
Note: Features marked with [x] are implemented, while [ ] indicates planned features. This is an active project with ongoing development.