🌱 FlowHabit - Smart Habit Tracker

A beautiful and motivating habit tracking app built with Flutter that helps you build lasting habits through streaks, insights, and smart tracking.

🎯 What is FlowHabit?

FlowHabit is your personal habit-building companion that makes consistency fun and rewarding. Track your daily habits, build streaks, unlock achievements, and gain insights into your progress over time.

📱 Screenshots

✨ Key Features

🔥 Streak System - Build Momentum

What is a Streak? A streak is the number of consecutive days you've completed a habit. It's the most powerful motivator for building lasting habits because it creates momentum and makes you want to keep going.

How it Works:

• Complete your habit today → Your streak increases by 1
• Miss a day → Your streak resets to 0
• The longer your streak, the more motivated you'll be to keep it alive!

Streak Features:

• Live Streak Counter: See your current streak with a 🔥 fire icon on each habit card
• Best Streak Tracking: Your longest streak is always saved automatically. It acts as your "Personal Best" or "High Score" for each habit.
• Streak Protection (Freeze): Life happens! Use 2 freeze days per month to protect your streak.
  • What is it? A safety net that prevents your streak from resetting to 0 if you miss a day.
  • How to use? If you missed a habit yesterday, go to the Habit Detail screen and tap "Use Freeze".
  • Automatic Reset: Freezes reset every month, so you always have a fresh start.
  • Visual Indicator: A blue snowflake (❄️) icon shows how many freezes you have remaining.

🔍 How it Works: The Details

🏆 Best Days (Automatic High Score)

You don't need to set your "Best Days" manually. The app automatically tracks your progress:

1. Every time you complete a habit, the app calculates your current streak.
2. If your current streak is higher than your previous record, the app updates your Best Days instantly.
3. Even if you break a streak and start over, your Best Days record stays saved until you beat it again!

❄️ Streak Freeze (Manual Protection)

Think of a Streak Freeze as an "insurance policy" for your consistency:

1. Missed a day? Don't panic. Your streak won't reset immediately if you have freezes available.
2. Apply it: Open the habit you missed, and you'll see a "Streak Freeze" section. Tap "Use Freeze" to apply it to yesterday.
3. Result: Your streak stays alive as if you had completed the habit!
4. Limit: You get 2 freezes per month per habit. Use them wisely for emergencies, travel, or sick days.

🏆 Milestone Achievements

Unlock special achievements as you build consistency:

• 🔥 7-Day Warrior - Complete 7 days in a row
• ⚡ Two Week Champion - Complete 14 days in a row
• 💪 Monthly Master - Complete 30 days in a row
• 🌟 Halfway Hero - Complete 50 days in a row
• 👑 Century Champion - Complete 100 days in a row
• 🏆 Year-Long Legend - Complete 365 days in a row

Each milestone unlocks with a celebration animation to keep you motivated!

📊 Progress Tracking & Insights

Visual Progress:

• Weekly View: See your last 7 days at a glance on each habit card
• Annual Heatmap: GitHub-style calendar showing your entire year (click any day to see details!)
• Circular Progress: Real-time percentage of monthly completion
• Trend Charts: Visualize your consistency over time

Smart Insights:

• "Consistency King" - Identify your most consistent day of the week
• "Early Bird Trend" - Track morning vs. evening habit completion
• "Streak Master" - See which habits have the longest streaks
• Monthly completion rates and statistics

Streak Insights Dashboard:

• Total Streaks: Sum of all your active habit streaks
• Longest Ever: Your all-time best streak across any habit
• Average Streak: Mean streak length across all habits
• Top Streak Habit: Highlighted display of your most consistent habit
• Achievement Gallery: View all unlocked milestone badges
• Freezes Available: See how many streak protections you have left

🎨 Habit Customization

Personalize Your Habits:

• 🎨 Choose from 7 beautiful colors
• 🎭 Select from 12+ category icons
• 📅 Set frequency: Daily, Weekly, or Custom
• ⏱️ Add duration tracking (e.g., "20 minutes of meditation")
• 📝 Add descriptions and notes
• 🏷️ Organize by categories: Health, Fitness, Mindfulness, Productivity, etc.

📱 Beautiful Design

• Modern 2025 Design: Clean, minimalist interface
• Smooth Animations: Delightful micro-interactions on every tap
• Dark Mode Support: Easy on the eyes day or night
• Intuitive Navigation: Bottom tab bar for quick access
• Celebration Effects: Confetti animations for achievements

🔔 Smart Reminders

• Daily notifications to keep you on track
• Customizable reminder times
• Gentle nudges: "Don't break your 15-day streak!"

📈 Detailed Habit View

Tap any habit to see:

• Full completion history
• Progress rings and charts
• Journal entries and notes
• Streak timeline
• Best performance days

🎮 How to Use

1. Create Your First Habit

   • Tap the + button
   • Choose a name, icon, and color
   • Set your goal (daily, weekly, custom)
   • Add optional duration tracking

2. Complete Daily

   • Check off habits as you complete them
   • Watch your streak grow with each completion
   • See the satisfying checkmark animation

3. Track Progress

   • View your weekly completion pattern
   • Check the annual heatmap for long-term trends
   • Monitor streak statistics

4. Use Streak Freezes Wisely

   • Save them for when you really need them
   • They reset monthly (2 per month)
   • Protect your hard-earned streaks

5. Unlock Achievements

   • Build consistency to unlock milestones
   • Celebrate each achievement
   • Challenge yourself to reach 365 days!

🌟 Why FlowHabit?

Psychology-Backed Design:

• Streaks create positive momentum
• Visual progress provides instant feedback
• Achievements make the journey rewarding
• Freezes reduce stress and guilt

Perfect For:

• Building morning routines
• Establishing fitness habits
• Learning new skills daily
• Practicing mindfulness
• Tracking health goals
• Improving productivity

📊 Categories Available

• 🏃 Fitness - Exercise, running, yoga
• 🥗 Nutrition - Healthy eating, water intake
• 🧘 Mindfulness - Meditation, journaling, gratitude
• 💼 Productivity - Deep work, planning, reading
• 💰 Finance - Budgeting, saving, investing
• 🎨 Creativity - Drawing, writing, music
• 👥 Social - Connecting with friends and family
• 😴 Sleep - Consistent sleep schedule
• 📚 Learning - Study, courses, languages
• ❤️ Health - Taking vitamins, self-care
• 🎮 Hobby - Personal interests

🛠️ Technical Stack

• Framework: Flutter 3.x
• Language: Dart
• State Management: Provider
• Local Storage: Shared Preferences
• Notifications: Flutter Local Notifications
• Platforms: iOS, Android, Web, macOS, Windows, Linux

🚀 Getting Started

Prerequisites

• Flutter SDK (3.0 or higher)
• Dart SDK (3.0 or higher)
• Android Studio / Xcode (for mobile development)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/flowhabit.git
   cd flowhabit

2. Install dependencies:

   flutter pub get

3. Run the app:

   flutter run

Building for Production

• Android: flutter build apk --release
• iOS: flutter build ios --release
• Web: flutter build web --release
• Windows: flutter build windows --release

🚀 Coming Soon

• Cloud sync across devices
• Social features - share achievements with friends
• Habit templates library
• Apple Watch & Android Wear support
• Home screen widgets
• Advanced analytics and reports
• AI-powered habit suggestions

---

Built with ❤️ to help you build better habits

🌱 Start your journey today - every day counts!

Remember: It's not about being perfect. It's about being consistent.