Skip to content

Repository files navigation

⚡ Discipline Tracker

Forge Unwavering Consistency, Defend Your Streaks & Master Your Productivity

An offline-first, production-grade productivity mobile application built with Flutter, Riverpod 2.x, Firebase, and Hive following Clean Architecture.

Flutter Dart Riverpod Firebase License: MIT PRs Welcome


💡 Why Discipline Tracker?

#test 9

"Motivation gets you going, but discipline keeps you growing."

Most habit trackers feel like boring spreadsheets. Discipline Tracker transforms routine building into an engaging, visual, and intelligent experience:

  • 🟩 Visual GitHub Heatmap: See your consistency in real-time just like your GitHub commit activity.
  • 🤖 AI Behavioral Coach: Identifies your peak focus hours (morning focus vs. night owl) and warns you before missed habits break your momentum.
  • ⚡ Offline-First & Lightning Fast: Sub-millisecond local reads powered by Hive DB with automatic cloud backup to Firestore.
  • 🛡️ Streak Freeze Protection: Real life happens—safeguard your streak tokens so a single emergency doesn't reset your hard-earned progress.

📱 App Highlights & UI Showcase

🗓️ Task Planner & Heatmap 🤖 AI Behavioral Coach 📊 Analytics & Badges
(Add your screenshot here) (Add your screenshot here) (Add your screenshot here)

💡 Tip: Replace the placeholders above with screenshots or a 10-second demo GIF of your app!


✨ Key Features

1. 🗓️ Daily Planner & Task Engine

  • 6 Core Productivity Domains: Coding, Study, Gym, Reading, Work, and Personal.
  • Priority Matrix: Low (+15 XP), Medium (+25 XP), High (+40 XP) with distinct color accents.
  • Instant Optimistic Toggles: Haptic feedback, sound cues, and instantaneous offline persistence.
  • Smart Date Strip: One-tap navigation between daily schedules with real-time completion progress rings.

2. 🟩 Interactive GitHub-Style Heatmap

  • Consistency Matrix: 5 color intensity tiers (Level 0 through 4) based on daily task completion percentages.
  • Yearly & Monthly Views: 52-week horizontal scroll view to visualize whole-year dedication.
  • Drilldown Inspection: Tap any cell to view tasks completed and missed on that specific date.
  • 30-Day Discipline Index: Mathematically scores consistency over rolling 30-day windows.

3. 🤖 AI Behavioral Coach & Diagnostics

  • Pattern Detection: Evaluates drop-off categories (e.g. "You missed coding tasks 3 times this week").
  • Golden Focus Window: Discovers when your cognitive energy is highest (Morning 8:00 AM – 11:30 AM vs. Evening Night Owl).
  • Actionable Micro-Tips: Practical psychological nudges to eliminate friction.

4. 🏆 Gamification & Progression

  • XP Engine: Earn XP based on task priority, daily reflection, and streak multipliers (up to +50% bonus).
  • Tiered Level Ranks: Novice → Apprentice → Consistent → Iron Will → Discipline Master.
  • Milestone Badges: Unlock badges for streaks (7-Day Week Warrior, 30-Day Habit Master, 100 Centurion).

5. 📖 Daily Reflection Journal & PDF Progress Report

  • Evening 3-Question Guided Journal: Celebrate wins, diagnose obstacles, and set tomorrow's non-negotiables.
  • One-Tap PDF Export: Generates clean, professional PDF progress reports ready for printing or sharing.

🏗️ Architecture & Tech Stack

The project strictly follows Clean Architecture with a feature-first folder organization:

lib/
├── app.dart                    # App initialization, MaterialApp & theme routing
├── main.dart                   # Service bootstrap (Hive, Firebase, Notifications)
│
├── core/                       # Shared modules across features
│   ├── constants/              # AppColors, AppStrings, AppTheme
│   ├── services/               # AI Coach, Notification, Hive Cache, PDF Export
│   ├── utils/                  # DateTime utilities, Gamification XP engine
│   └── widgets/                # Reusable UI components (Buttons, Inputs, Badges)
│
└── features/                   # Independent feature slices
    ├── auth/                   # Firebase Auth, Google Sign-in & profile
    ├── tasks/                  # Task CRUD, Priority matrix, Hive repos
    ├── heatmap/                # GitHub-style activity grid & 30-day index
    ├── ai_coach/               # Behavioral analytics & insight cards
    ├── analytics/              # Productivity gauge & FL Chart trends
    ├── gamification/           # Badges, XP levels & streak freeze
    ├── reflection/             # Evening journal entries & star ratings
    └── settings/               # Dark/Light theme, backup sync & PDF exporter

🧰 Dependencies & Tools


🚀 Quick Start

Get the app running locally in less than 3 minutes:

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/baadaldev/To-Do-App-For-Me.git
    cd To-Do-App-For-Me
  2. Install dependencies:

    flutter pub get
  3. Run the application:

    # Launch on Chrome / Web
    flutter run -d chrome
    
    # Launch on Android / iOS Simulator
    flutter run

🗺️ Roadmap

  • Complete daily task planner with categories and priorities
  • GitHub-style contribution heatmap with year & month views
  • Rule-based AI behavioral coach engine
  • Gamification, XP multiplier, and Streak Badges
  • Daily Evening Reflection journal
  • PDF summary export & printing
  • Direct Google Gemini AI Live Coach integration
  • Home screen interactive widgets (iOS & Android)
  • Habit sound effects & haptic feedback customization
  • Social Leaderboard & friend accountability circles

🤝 Contributing

Contributions make the open-source community an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated!

Check out our Contributing Guidelines to get started.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'feat: Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.


⭐ Support the Project

If you find this project helpful or inspiring, please consider giving it a Star!
It helps the project gain visibility and motivates ongoing improvements.

GitHub Stars

🚀 Getting Started

Clone the repository and open index.html in your favorite web browser.

Releases

Packages

Contributors

Languages