A simple and functional Django-based To-Do List application built to help users manage tasks efficiently. It features task creation, deletion, completion tracking, and is deployed live using Render.
👉 Visit the Live App on Render
(Replace with your actual Render URL)
- Add new tasks with a title and optional description
- Mark tasks as completed or pending
- Delete tasks
- Task list organized by status
- Simple, clean UI using Django templates
- Persistent storage using SQLite
- Python 3.x
- Django (latest stable version)
- SQLite (development database)
- HTML + Django Templates
- Hosted on Render
todo-list-app/ │ ├── config/ # Main Django project folder │ ├── settings.py # Project settings │ ├── urls.py # URL routing │ ├── asgi.py / wsgi.py # Deployment configs │ ├── todo/ # App containing task logic │ ├── models.py # Task model │ ├── views.py # View logic (add, delete, mark complete) │ ├── urls.py # App-level URL routing │ ├── templates/ # HTML templates for task pages │ └── admin.py, apps.py # Admin and app config │ ├── db.sqlite3 # SQLite database ├── manage.py # Django management script ├── requirements.txt # Project dependencies ├── Procfile # Deployment entry point for Render ├── runtime.txt # Specifies Python version for Render └── README.md # Project documentation
This guide helps you set up and run the Django project on your local machine.
- Python 3.x installed
pip
installed (comes with Python)- Git (optional, if you're cloning the project)
To set up and run this Django project locally, follow the steps below:
-
Make sure you have Python 3.x and pip installed on your system.
-
(Optional) Clone this repository using:
git clone https://github.com/your-username/your-django-project.git
Then navigate into the project folder:
cd your-django-project
-
Create a virtual environment:
python -m venv venv
-
Activate the virtual environment:
- On macOS/Linux:
source venv/bin/activate
- On Windows:
venv\Scripts\activate
- On macOS/Linux:
-
Install all required dependencies:
pip install -r requirements.txt
-
Run database migrations to set up the SQLite database:
python manage.py migrate
-
Start the Django development server:
python manage.py runserver
-
Open your browser and go to
http://127.0.0.1:8000/
to see the application running.
Notes:
- To deactivate the virtual environment later, run:
deactivate
- To update the
requirements.txt
file after adding new packages:pip freeze > requirements.txt
- If using environment variables, create a
.env
file and load it withpython-decouple
ordjango-environ
.
You are now ready to start building and running your Django project locally. Happy coding!