Flask To-Do List App

A simple To-Do List web application built with Flask, featuring user authentication, database migrations, and task management. This project is ideal for beginners learning Flask or anyone who wants a starter template for a CRUD-based web app.

Table of Contents

• About

• Tech Stack

• Getting Started

  • Install Dependencies
  • Set Up the Database
  • Run the Application

• Run with Docker

• License

About

This is a lightweight Flask-based To-Do List application supporting:

• User registration & login
• Secure password hashing
• Each user manages their own tasks
• Database migration workflow (Flask-Migrate)

It can be used as a simple productivity tool or as a base project to learn Flask fundamentals.

Tech Stack

• Python 3
• Flask
• Flask-Login
• Flask-Migrate
• SQLAlchemy
• HTML / Bootstrap

Getting Started

Follow these steps to set up and run the project locally.

1. Install Dependencies

Make sure Python and pip are installed.

pip install -r requirements.txt

2. Set Up the Database

Use Flask-Migrate to initialize and manage migrations:

flask db init       # Run once, creates migrations folder
flask db migrate    # Generate migration scripts after model changes
flask db upgrade    # Apply latest migrations

3. Run the Application

Windows:

py app.py

MacOS / Linux:

python3 app.py

The app should now be accessible at: http://localhost:5000

Run with Docker

Build the Docker image:

docker build -t flask-todo-app .

Run the container:

docker run -d -p 5000:5000 flask-todo-app

License

This project is open-source and available under the MIT License.