4 |
5 |
6 | 
7 |
8 |
9 |
26 | [](https://flutter.dev) 27 | [](https://dart.dev) 28 | [](https://www.sqlite.org) 29 | [](https://opensource.org/licenses/MIT) 30 | 31 |
32 |
33 |
7 |
8 |
9 | Doable Todo List App
10 | 11 |
12 | 💡 An offline Flutter todo list app using Dart & SQLite Database with notification reminders & latest UI designs.
13 |
14 |
15 | Report Bugs
16 | ·
17 | Request Features
18 |
26 | [](https://flutter.dev) 27 | [](https://dart.dev) 28 | [](https://www.sqlite.org) 29 | [](https://opensource.org/licenses/MIT) 30 | 31 |
34 |
35 |
36 |
37 |
38 | 39 | 40 |
41 |
64 |
65 | Table of Contents
42 |-
43 |
-
44 | About The Project
45 |
-
46 |
- Built With 47 |
49 | -
50 | Getting Started
51 |
-
52 |
- Prerequisites 53 |
- Installation 54 |
56 | - Usage 57 |
- Roadmap 58 |
- Contributing 59 |
- License 60 |
- Contact 61 |
- Acknowledgments 62 |
66 | 67 | 68 | # About Doable: Todo List App 69 | An offline, single‑device to‑do app built with Flutter and SQLite. Features task management with reminders, date/time pickers, and filtering capabilities. 70 |
71 | 72 | ## 📱 Features 73 | 74 | - ✅ **Task Management** - Create, edit, delete tasks with title and optional description 75 | - ⏰ **Smart Scheduling** - Date and time pickers with reminder notifications 76 | - 🔄 **Repeat Rules** - Daily, Weekly, Monthly options with custom weekday selection 77 | - 🔍 **Advanced Filtering** - Filter by date, time, completion status, repeat rules, and reminders 78 | - 📱 **Intuitive UI** - Swipe-to-delete completed tasks, clean Material Design 79 | - 💾 **Offline First** - Local SQLite storage, no network required 80 | - 🗑️ **Data Management** - Clear all data option in settings 81 | 82 | 83 | 84 | 85 | 86 | ### Built With Flutter 87 | 88 | Flutter is an open source framework developed and supported by Google. App Developers use Flutter to build mobile apps for multiple platforms (iOS/android) with a single codebase.
89 |
90 |
91 |
92 |
93 |
94 |
95 |
96 | ## Getting Started
97 |
98 | This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.
99 |
100 | ### Prerequisites
101 |
102 | - [Flutter SDK](https://flutter.dev/docs/get-started/install) (3.0+)
103 | - [Dart SDK](https://dart.dev/get-dart) (3.2.6+)
104 | - Android Studio or VS Code with Flutter extension
105 |
106 | Make sure you have `git` installed, type `git --version` in your cmd. (git official download page: https://git-scm.com/downloads)
107 |
108 | ```
109 | git --version
110 | ```
111 |
112 | ### Installation
113 |
114 | Steps to install code and app into your local device (and run app on emulator or mobile device)
115 |
116 | 1. Fork this repository (and leave a star if you like) by click on the `fork` button on the top right side.
117 | 2. From your copy of this repo located `yourname/doable-todo-list-app`, copy the code link: `https://github.com/your-user-name/doable-todo-list-app.git`
118 | 3. Create a folder named `doable` in your local device to store these files.
119 | 4. Open terminal and type `cd path/to/doable` (replace `/path/to/doable` with the real path to the new `doable` folder we created in step 3)
120 |
121 | ```
122 | cd path/to/doable
123 | ```
124 | 125 | 5. Clone your copy of this repo using `git clone link-you-copied-in-step-2` 126 | 127 | ``` 128 | git clone https://github.com/your_username_/doable-todo-list-app.git 129 | ``` 130 |
131 | 132 | 6. Open the folder `doable/doable-todo-list-app` in your code editor (I use VS Code) & start coding. 133 | 7. Run `emulator` or connect your mobile device with cable to run app on mobile. 134 | 135 | 136 | 137 | 138 | ## 🏗️ Tech Stack 139 | 140 | | Technology | Purpose | Version | 141 | |------------|---------|---------| 142 | | [Flutter](https://flutter.dev) | UI Framework | 3.0+ | 143 | | [SQLite](https://www.sqlite.org) | Local Database | via sqflite ^2.4.0 | 144 | | [SharedPreferences](https://pub.dev/packages/shared_preferences) | Settings Storage | ^2.3.2 | 145 | | [flutter_svg](https://pub.dev/packages/flutter_svg) | Vector Graphics | ^2.0.10 | 146 | | [intl](https://pub.dev/packages/intl) | Date Formatting | ^0.20.2 | 147 | | [url_launcher](https://pub.dev/packages/url_launcher) | External Links | ^6.3.0 | 148 | 149 | 150 | ## 📂 Project Structure 151 | 152 | lib/
153 | ├── main.dart # App entry point
154 | ├── screens/ # UI screens
155 | │ ├── home_page.dart # Main task list
156 | │ ├── add_task_page.dart # Create new tasks
157 | │ ├── edit_task_page.dart # Modify existing tasks
158 | │ └── settings_page.dart # App settings
159 | ├── data/ # Data layer
160 | │ ├── database_service.dart # SQLite management
161 | │ └── task_dao.dart # Database operations
162 | ├── models/ # Data models
163 | │ └── task_entity.dart # Task data structure
164 | └── task_repository.dart # Repository pattern facade
165 | 166 | 167 | ## 🗄️ Database Schema 168 | 169 | ### Tasks Table 170 | 171 | ``` 172 | CREATE TABLE tasks( 173 | id INTEGER PRIMARY KEY AUTOINCREMENT, 174 | title TEXT NOT NULL, 175 | description TEXT, 176 | time TEXT, -- Display format: "11:30 AM" 177 | date TEXT, -- Display format: "26/11/24" 178 | has_notification INTEGER NOT NULL DEFAULT 0, 179 | repeat_rule TEXT, -- "Daily" | "Weekly" | "Monthly" | "Weekly:" 180 | completed INTEGER NOT NULL DEFAULT 0, 181 | created_at TEXT DEFAULT CURRENT_TIMESTAMP, 182 | updated_at TEXT 183 | ); 184 | ``` 185 | 186 | ## 🎨 Architecture 187 | 188 | The app follows a clean layered architecture: 189 | 190 | ``` 191 | graph TB 192 | A[Presentation Layer] --> B[Repository Layer] 193 | B --> C[Data Access Layer] 194 | C --> D[SQLite Database] 195 | ``` 196 | 197 | ``` 198 | A --> E[SharedPreferences] 199 | 200 | subgraph "Presentation Layer" 201 | A1[HomePage] 202 | A2[AddTaskPage] 203 | A3[EditTaskPage] 204 | A4[SettingsPage] 205 | end 206 | 207 | subgraph "Data Layer" 208 | C1[TaskDao] 209 | C2[DatabaseService] 210 | end 211 | ``` 212 | 213 | 214 | ### Key Components 215 | 216 | - **Presentation Layer**: Stateful/Stateless widgets managing UI state 217 | - **Repository Layer**: TaskRepository as a facade for future extensibility 218 | - **Data Access Layer**: TaskDao + DatabaseService for SQLite operations 219 | - **Domain Model**: TaskEntity for data serialization 220 | 221 | ## 🔧 Configuration 222 | 223 | ### Android Setup 224 | ``` 225 | android { 226 | compileSdk 34 227 | defaultConfig { 228 | minSdk 21 229 | targetSdk 34 230 | } 231 | compileOptions { 232 | sourceCompatibility JavaVersion.VERSION_17 233 | targetCompatibility JavaVersion.VERSION_17 234 | } 235 | } 236 | ``` 237 | 238 | 239 | ### Build Variants 240 | - **Debug**: Development with debug symbols 241 | - **Release**: Optimized production build 242 | 243 | ## 🎯 Usage Examples 244 | 245 | ### Creating a Task 246 | ``` 247 | final task = TaskEntity( 248 | title: "Complete project documentation", 249 | description: "Write comprehensive README", 250 | time: "2:30 PM", 251 | date: "27/01/25", 252 | hasNotification: true, 253 | repeatRule: "Daily", 254 | completed: false, 255 | ); 256 | 257 | await TaskDao.insert(task); 258 | ``` 259 | 260 | ### Filtering Tasks 261 | ``` 262 | // Filter by completion status 263 | final incompleteTasks = tasks.where((t) => !t.completed).toList(); 264 | 265 | // Filter by date 266 | final todayTasks = tasks.where((t) => t.date == "27/01/25").toList(); 267 | 268 | // Filter by repeat rule 269 | final weeklyTasks = tasks.where((t) => 270 | t.repeatRule?.startsWith("Weekly") == true 271 | ).toList(); 272 | ``` 273 | 274 | ## 📱 Screenshots 275 | 276 |
277 | 
278 |
319 | 320 |
How to get access to my project:
321 | 322 | 1. Fork this repository (and leave a star if you like) by click on the `fork` button on the top right side. 323 | 2. From your copy of this repo located `yourname/doable-todo-list-app`, copy the code link: `https://github.com/your-user-name/doable-todo-list-app.git` 324 | 3. Create a folder named `doable` in your local device to store these files. 325 | 4. Open terminal and type `cd path/to/doable` (replace `/path/to/doable` with the real path to the new `doable` folder we created in step 3) 326 | 327 | ``` 328 | cd path/to/doable 329 | ``` 330 |331 | 332 | 5. Clone your copy of this repo using `git clone [link you copied in step 2]` 333 | 334 | ``` 335 | git clone https://github.com/your_username_/doable-todo-list-app.git 336 | ``` 337 |
338 | 339 | 6. Navigate to the root folder of this project 340 | 341 | ``` 342 | cd /path/to/doable-todo-list-app 343 | ``` 344 |
345 | 346 | 7. DO **NOT** MAKE CHANGES TO THE main BRANCH, create your own branch and name it your name 347 | 348 | ``` 349 | git branch my-user-name 350 | ``` 351 |
352 | 353 | 8. Confirm that your new branch `my-user-name` is created 354 | 355 | ``` 356 | git branch 357 | ``` 358 |
359 | 360 | 9. Select your new branch `my-user-name` and work on that branch only 361 | 362 | ``` 363 | git checkout my-user-name 364 | ``` 365 |
366 | 367 | 10. Confirm that you are in your branch `my-user-name` and **NOT** on `main` 368 | 369 | ``` 370 | git branch 371 | ``` 372 |
373 | 374 |
Staying up-to-date with original code:
375 | 376 | 1. You have to shift to `main` branch first but do **NOT** `push` to `main` branch 377 | 378 | ``` 379 | git checkout main 380 | ``` 381 |382 | 383 | 2. Perform a `pull` to stay updated. It must show `Already up-to-date` 384 | 385 | ``` 386 | git pull 387 | ``` 388 |
389 | 390 | 3. Now you have to shift back to your branch `my-user-name` again before you can continue editing code 391 | 392 | ``` 393 | git checkout my-user-name 394 | ``` 395 |
396 | 397 | 4. Perform a `pull` again in `my-user-name` your own branch 398 | 399 | ``` 400 | git pull 401 | ``` 402 |
403 | 404 |
Once you are ready to push the changes, follow these steps:
405 | 406 | 1. Confirm you are in `my-user-name` your own branch 407 | 408 | ``` 409 | git branch 410 | ``` 411 |412 | 413 | 2. Push the changes 414 | 415 | ``` 416 | git add . 417 | git commit -m "issue #24 fixed" 418 | ``` 419 |
420 | 421 | 3. Choose `git push origin HEAD`, do **NOT** choose `git push origin HEAD:master` 422 | 423 | ``` 424 | git push 425 | git push origin HEAD 426 | ``` 427 |
428 | 429 | 430 | 431 | 432 | 433 | 434 | 435 | ## License 436 | 437 | Distributed under the MIT License. Click [LICENSE.md](https://github.com/theakhinabraham/doable-todo-list-app/blob/main/LICENSE.md) for more information. 438 | 439 | 440 | 441 | ## 🙏 Acknowledgments 442 | 443 | - [Flutter Team](https://flutter.dev) for the amazing framework 444 | - [SQLite](https://www.sqlite.org) for reliable local storage 445 | - [Material Design](https://material.io) for design inspiration 446 | 447 | 448 | ## 📞 Support 449 | 450 | Akhin Abraham - [instagram.com/akhinabr](https://instagram.com/akhinabr) - theakhinabraham@gmail.com 451 | 452 | Repository Link: [https://github.com/theakhinabraham/doable-todo-list-app](https://github.com/theakhinabraham/doable-todo-list-app) 453 | 454 | 455 | 456 | 457 | 458 | 459 | ## Acknowledgments 460 | 461 | Here are some resource links to help with this project and it's contribution: 462 | 463 | * [Flutter Docs](https://docs.flutter.dev/) 464 | * [Flutter Packages](https://pub.dev/) 465 | 466 | 467 | 468 | -------------------------------------------------------------------------------- /lib/screens/add_task_page.dart: -------------------------------------------------------------------------------- 1 | import 'package:flutter/material.dart'; 2 | import 'package:flutter_svg/flutter_svg.dart'; 3 | import 'package:intl/intl.dart'; 4 | 5 | // Data layer 6 | import 'package:doable_todo_list_app/models/task_entity.dart'; 7 | import 'package:doable_todo_list_app/repositories/task_repository.dart'; 8 | import 'package:doable_todo_list_app/services/notification_service.dart'; 9 | 10 | class AddTaskPage extends StatefulWidget { 11 | const AddTaskPage({super.key}); 12 | 13 | @override 14 | State