π― A modern, feature-rich Flutter application showcasing clean architecture, state management best practices, and beautiful Material Design. Perfect for learning Flutter development through a real-world, production-quality example.
-
π Task Management
- β Create, edit, and delete tasks
- β° Set due dates and priorities
- π Track progress
- π·οΈ Organize with categories and tags
- β Mark tasks as completed
-
π Note Taking
- π Rich text editor
- π¨ Color customization
- π± Grid/List view toggle
- π Search and filter
- π€ Share functionality
-
π― Goal Tracking
- π Set and track goals
- π Progress monitoring
- π Achievement system
- π Milestone tracking
- π Convert goals to achievements
-
π€ Profile Management
- π Dark/Light theme
- π Activity statistics
- β Favorite categories
- π¨ UI customization
This project demonstrates:
- ποΈ Clean Architecture in Flutter
- π State Management with Provider
- πΎ Local Data Persistence
- π¨ Modern UI/UX Design
- π§ͺ Code Organization
- π± Responsive Design
This project follows a clean, maintainable architecture that separates concerns and promotes scalability:
graph TD
A[Pages] --> B[Providers]
B --> C[Services]
B --> D[Models]
C --> D
subgraph UI Layer
A
end
subgraph Business Logic
B
end
subgraph Data Layer
C
D
end
lib/
βββ models/ # Data structures
β βββ task.dart # Task model
β βββ note.dart # Note model
β βββ goal.dart # Goal model
β βββ profile.dart # User profile model
β
βββ providers/ # State management
β βββ task_provider.dart # Task state & logic
β βββ note_provider.dart # Note state & logic
β βββ goal_provider.dart # Goal state & logic
β βββ theme_provider.dart # Theme state & logic
β
βββ pages/ # UI screens
β βββ tasks_page.dart # Task management
β βββ notes_page.dart # Note management
β βββ goals_page.dart # Goal tracking
β βββ profile_page.dart # User profile
β
βββ services/ # Business logic & data handling
β βββ storage_service.dart # Data persistence
β βββ file_service.dart # File operations
β
βββ main.dart # App entry point & configuration
-
UI Layer (Pages)
- Handles user interactions
- Displays data using widgets
- Communicates with Providers
-
State Management (Providers)
- Manages application state
- Handles business logic
- Coordinates between UI and Services
-
Services Layer
- Handles data persistence
- Manages file operations
- Implements business rules
-
Data Layer (Models)
- Defines data structures
- Implements data validation
- Handles data serialization
graph LR
A[UI Components] --> B[Provider]
B --> C[Services]
C --> D[Local Storage]
C --> E[File System]
style A fill:#f9f,stroke:#333,stroke-width:2px
style B fill:#bbf,stroke:#333,stroke-width:2px
style C fill:#dfd,stroke:#333,stroke-width:2px
The app uses Provider pattern for state management:
- Centralized state handling
- Reactive UI updates
- Efficient data propagation
- Clean separation of concerns
- π± Flutter SDK (>=3.0.0)
- β Dart SDK (>=3.0.0)
- Clone the repo:
git clone git@github.com:HappyFox001/organizer.git
- Get packages:
flutter pub get
- Run the app:
flutter run
- π± Flutter - UI Framework
- π Provider - State Management
- πΎ Shared Preferences - Local Storage
- π¨ Google Fonts - Typography
- πΈ Image Picker - Media Selection
- π URL Launcher - External Links
- π΄ Fork the Project
- π§ Create your Feature Branch
- πΎ Commit your Changes
- π€ Push to the Branch
- π Open a Pull Request
MIT License - feel free to use this project as a template! π
Β© 2025 Qian Zhang
- π Flutter Team
- π₯ Open Source Community
- π All Contributors