| # ✦ TaskMaster — Flask Task Manager |
|
|
| A clean, fully functional personal task manager built with Flask. |
| No database required — works out of the box! |
|
|
| --- |
|
|
| ## 🚀 Quick Start |
|
|
| ```bash |
| # 1. Install Flask |
| pip install flask |
| |
| # 2. Run the app |
| python app.py |
| |
| # 3. Open browser |
| # → http://127.0.0.1:5000 |
| ``` |
|
|
| --- |
|
|
| ## 🗂 Project Structure |
|
|
| ``` |
| taskmaster/ |
| ├── app.py ← Flask app + REST API |
| ├── requirements.txt ← Dependencies (just Flask) |
| └── templates/ |
| └── index.html ← Beautiful single-page UI |
| ``` |
|
|
| --- |
|
|
| ## 🔌 REST API |
|
|
| | Method | Endpoint | Description | |
| |--------|-----------------------|-----------------------| |
| | GET | `/api/tasks` | List tasks (filterable)| |
| | POST | `/api/tasks` | Create a new task | |
| | PATCH | `/api/tasks/<id>` | Update a task | |
| | DELETE | `/api/tasks/<id>` | Delete a task | |
| | GET | `/api/stats` | Get summary stats | |
|
|
| ### Query params for GET /api/tasks |
| - `?done=true/false` |
| - `?priority=high/medium/low` |
| - `?category=work/personal/learning/general` |
|
|
| ### POST /api/tasks body |
| ```json |
| { |
| "title": "My task", |
| "priority": "high", |
| "category": "work", |
| "due_date": "2026-06-30" |
| } |
| ``` |
|
|
| --- |
|
|
| ## ✨ Features |
|
|
| - Add tasks with title, priority, category, and due date |
| - Mark tasks as done / pending |
| - Delete tasks |
| - Filter by status, priority, or category |
| - Live stats dashboard (total / done / pending / urgent) |
| - Toast notifications |
| - Fully responsive design |
| - Zero database — pure Python in-memory store |
|
|
| --- |
|
|
| ## 🛠 Tech Stack |
|
|
| - **Backend:** Python + Flask |
| - **Frontend:** Vanilla HTML/CSS/JS (no frameworks) |
| - **Storage:** In-memory (dict) — add SQLite easily if you want persistence |
|
|
