Skip to content

CodeArcadia-fastest/TodoListX

Repository files navigation

TodoList X Logo

Flutter Version Project Version License

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

  1. Clone the repository:

    git clone https://github.com/your-username/todo_list_x.git
  2. Navigate to the project directory:

    cd todo_list_x
  3. Install dependencies:

    flutter pub get
  4. 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

About

TodolistX for all devices

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors