Skip to content

Latest commit

Β 

History

128 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Habitly

A beautiful, modern habit tracking app built with Flutter

Flutter Dart Firebase MIT License

Features β€’ Tech Stack β€’ Architecture β€’ Contributing

🌟 Key Features

Core Functionality

  • πŸ“± Track daily, weekly, and monthly habits
  • πŸ“Š Visual progress tracking with intuitive metrics
  • πŸ”₯ Streak monitoring with detailed statistics
  • 🎯 Smart categorization and priority management
  • πŸ”„ Seamless offline/online synchronization
  • πŸ”” Customizable reminders and notifications

User Experience

  • 🎨 Modern, clean interface with smooth animations
  • πŸŒ“ Beautiful dark and light themes
  • πŸ“± Responsive design across all screen sizes
  • ⚑ Optimized performance and instant feedback
  • πŸ” Powerful search and filtering capabilities

Data & Analytics

  • πŸ“ˆ Detailed progress visualization
  • πŸ“Š Comprehensive habit statistics
  • πŸ“… Interactive calendar view
  • 🎯 Goal tracking and achievements
  • πŸ“± Cross-device synchronization

πŸ’» Tech Stack

Frontend

  • Framework: Flutter 3.x
  • State Management: Provider
  • Local Storage: SharedPreferences
  • Notifications: flutter_local_notifications
  • UI Components: Material Design & Custom Widgets

Backend

  • Authentication: Firebase Auth
  • Database: Cloud Firestore
  • Analytics: Firebase Analytics
  • Cloud Functions: Firebase Cloud Functions

Development

  • Language: Dart 3.x
  • Architecture: Clean Architecture
  • Testing: Unit & Widget Tests
  • CI/CD: GitHub Actions

πŸ— Architecture

lib/
β”œβ”€β”€ models/
β”‚   β”œβ”€β”€ habit.dart              # Core habit data model
β”‚   └── task.dart               # Task management model
β”œβ”€β”€ screens/
β”‚   β”œβ”€β”€ dashboard/
β”‚   β”‚   β”œβ”€β”€ habit_dashboard.dart    # Main dashboard
β”‚   β”‚   └── widgets/                # Dashboard components
β”‚   β”œβ”€β”€ calendar/
β”‚   β”‚   └── habit_calendar.dart     # Calendar view
β”‚   └── settings/
β”‚       └── settings_screen.dart    # App settings
β”œβ”€β”€ services/
β”‚   β”œβ”€β”€ auth_service.dart       # Authentication
β”‚   β”œβ”€β”€ firebase_sync.dart      # Cloud sync
β”‚   └── notification_service.dart    # Local notifications
β”œβ”€β”€ repositories/
β”‚   β”œβ”€β”€ habit_repository.dart   # Habit data handling
β”‚   └── task_repository.dart    # Task data handling
└── providers/
    β”œβ”€β”€ theme_provider.dart     # Theme management
    └── navigation_state.dart   # Navigation state

πŸš€ Implementation Highlights

Authentication & Sync

  • Seamless Google & Apple Sign-In
  • Secure token management
  • Efficient data synchronization
  • Offline capability with local persistence

State Management

  • Reactive state updates with Provider
  • Efficient UI rebuilds
  • Clean separation of concerns
  • Robust error handling

Data Persistence

  • Local data caching
  • Automatic cloud backup
  • Conflict resolution
  • Data migration support

πŸ›  Technical Features

Performance Optimization

  • Lazy loading of data
  • Efficient list rendering
  • Image caching
  • Background task handling

Security

  • Secure data storage
  • Firebase Authentication
  • Data encryption
  • Privacy protection

πŸ”œ Future Roadmap

  • Advanced Analytics Dashboard
  • Social Features & Sharing
  • Custom Widget Support
  • AI-Powered Insights
  • Extended Theme Customization
  • Public API

πŸ‘₯ Contributing

We welcome contributions! Here's how you can help:

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

πŸ“« Contact & Support

πŸ“„ License

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


Made with ❀️ by Artan

Website β€’ Documentation β€’ Support

About

A modern Flutter app for habit tracking and task management, featuring streak monitoring, visual progress analytics, customizable reminders, and seamless cloud synchronization across devices.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages