javed-78/ai_box

✦ TaskMaster — Flask Task Manager

A clean, fully functional personal task manager built with Flask. No database required — works out of the box!

---

🚀 Quick Start

# 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

{
  "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