Flask Task Manager Development

Dariush Samari

Completed work

Software Engineer

Website CSS

Web Developer

Bootstrap

Flask

SQLite

Computer Software

Flask Task Manager

A combined Flask API and built‑in web UI for creating, reading, updating, and deleting to‑do tasks.

Features

REST API for tasks (/tasks): create, list, view, update, delete.

Web UI served at /: add, edit, complete, and remove tasks with a modern Bootstrap design.

Single origin—no CORS required: back end and front end run together.

SQLite persistence in tasks.db, auto‑initialized on first launch.

Tech Stack

Python 3.x

Flask (2.2.2)

SQLAlchemy (2.0.x)

SQLite

Bootstrap 5 + Bootstrap Icons (front‑end)

Project Structure

.
├── app.py             # Entry point: configures Flask, serves static UI, registers routes
├── database.py        # DB engine, session setup & init_db()
├── models.py          # SQLAlchemy Task model
├── routes.py          # Blueprint: API endpoints (GET/POST/PUT/DELETE /tasks)
├── services.py        # TaskService: business logic & ORM calls
├── static/            # Front‑end assets
│   └── index.html     # Single‑page UI, interacts with API
├── requirements.txt   # Python dependencies
└── test_routes.py     # Pytest suite for API endpoints

Note: tasks.db is created automatically via init_db() when you start the app.

Prerequisites

Git (for cloning & updates)

Ubuntu/Debian: sudo apt-get update && sudo apt-get install git

macOS (Homebrew): brew install git

Windows: Download Git

Python 3.8+

Setup & Git Commands

# Clone the repo (first time)
git clone https://github.com/binarynectar/task-manager.git
cd task-manager

# Pull latest changes
git pull origin main

# (Optional) Virtual environment
python3 -m venv venv
source venv/bin/activate

# Install Python dependencies
pip install -r requirements.txt

Running Locally

python app.py

Opens server on http://127.0.0.1:5000/

API at /tasks

UI at / (renders static/index.html)

Web UI Usage

Navigate to http://127.0.0.1:5000/ in your browser.

Add a new task via the input field and + button.

Toggle a task’s completion with the checkbox.

Edit a task title with the ✏️ Edit button.

Remove a task with the 🗑️ Delete button.

API Endpoints

All endpoints accept and return JSON.

| Method | Endpoint      | Description                                      | Request Body                                                           | Response                                 |
| ------ | ------------- | ------------------------------------------------ | ---------------------------------------------------------------------- | ---------------------------------------- |
| GET    | `/tasks`      | List all tasks                                   | *None*                                                                 | `[{id, title, deadline, completed}, …]`  |
| GET    | `/tasks/<id>` | Retrieve a single task                           | *None*                                                                 | `{id, title, deadline, completed}`       |
| POST   | `/tasks`      | Create a new task                                | `{"title": string, "deadline"?: "YYYY-MM-DD"}`                         | `{id, title, deadline, completed}` (201) |
| PUT    | `/tasks/<id>` | Update title, deadline, and/or completion status | `{"title"?: string, "deadline"?: "YYYY-MM-DD", "completed"?: boolean}` | `{id, title, deadline, completed}`       |
| DELETE | `/tasks/<id>` | Delete a task                                    | *None*                                                                 | *Empty body* (204)                       |

Example cURL

# Create with deadline
echo '{"title":"Buy milk","deadline":"2025-07-31"}' \
  | curl -X POST http://127.0.0.1:5000/tasks \
         -H "Content-Type: application/json" \
         -d @-

# Create without deadline
echo '{"title":"Walk dog"}' \
  | curl -X POST http://127.0.0.1:5000/tasks \
         -H "Content-Type: application/json" \
         -d @-

# Update title & deadline
echo '{"title":"Pay bills","deadline":"2025-08-05"}' \
  | curl -X PUT http://127.0.0.1:5000/tasks/1 \
         -H "Content-Type: application/json" \
         -d @-

# Mark complete
echo '{"completed":true}' \
  | curl -X PUT http://127.0.0.1:5000/tasks/1 \
         -H "Content-Type: application/json" \
         -d @-

# Delete task
curl -X DELETE http://127.0.0.1:5000/tasks/1