TodoList X
A modern todo list application built with ❤️ using Flutter and Riverpod.
📌 About
TodoList X is a modern, feature-rich todo list application built with Flutter and Riverpod for state management.
Note: This is an educational project created for learning Flutter development and modern app architecture.
This app provides a complete task management experience with a beautiful UI and smooth animations, including:
- 📱 Modern Flutter: Built with Flutter 3.24+ and Material Design 3
- 🎯 Riverpod State Management: Clean and efficient state management with Riverpod
- 💾 Local Storage: Persistent data storage using Hive database
- 🌙 Dark Mode: Full dark mode support with smooth theme switching
- 📊 Task Statistics: Track your productivity with detailed statistics
- �️ Task Categories: Organize tasks with custom categories
- ⏰ Due Dates: Set and track task deadlines
- 🎨 Beautiful UI: Modern, responsive design with smooth animations
Whether you're managing daily tasks or tracking project milestones, TodoList X provides the tools you need for effective task management.
✨ Features
- 📱 Cross-Platform: Works on Android, iOS, and Web
- 🎯 Task Management: Create, edit, delete, and complete tasks
- 🏷️ Categories: Organize tasks with custom categories (Work, Personal, Shopping, etc.)
- ⏰ Due Dates: Set deadlines and track overdue tasks
- � Priority Levels: Set task priority (Low, Medium, High)
- 🌙 Dark Mode: Beautiful dark theme with automatic system detection
- � Statistics: View task completion rates and productivity metrics
- � Offline Support: All data stored locally with Hive
- 🔍 Search: Find tasks quickly with search functionality
- 📱 Responsive Design: Optimized for both mobile and tablet devices
- 🎨 Smooth Animations: Beautiful transitions and micro-interactions
🚀 Installation
-
Clone the repository:
git clone https://github.com/your-username/todo_list_x.git
-
Navigate to the project directory:
cd todo_list_x -
Install dependencies:
flutter pub get
-
Run the app:
flutter run
⚙️ Configuration
The app includes the following configurable options:
- App Settings: Theme preference, profile management
- Task Settings: Default priority, categories, and due date reminders
- Data Management: Export/import functionality, backup options
🏗️ Project Structure
lib/
├── core/
│ ├── constants/ # App constants and colors
│ ├── theme/ # App themes and styling
│ └── utils/ # Utility functions and animations
├── data/
│ ├── models/ # Data models (Task, Profile)
│ └── services/ # Data services (HiveService)
├── providers/ # Riverpod state management
├── screens/ # App screens
│ ├── home/ # Home screen with task list
│ ├── profile/ # Profile screen
│ └── main_navigation.dart
├── widgets/ # Reusable widgets
│ ├── task_dialog.dart
│ ├── task_item.dart
│ └── empty_state.dart
└── main.dart # App entry point
🧑💻 Technologies Used
- Flutter 3.24+: Cross-platform UI framework
- Riverpod: State management solution
- Hive: Lightweight and fast key-value database
- Iconsax: Beautiful icon library
- Material Design 3: Modern design system
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
📜 License
This project is licensed under the MIT License.
Feel free to use, modify, and distribute it — just don't forget to give appropriate credit ❤️.
🙏 Acknowledgments
- Flutter team for the amazing framework
- Riverpod community for excellent state management
- Iconsax for beautiful icons
- Material Design team for design guidelines
