Skip to content

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.

Notifications You must be signed in to change notification settings

MuthoniGathiithi/Django_To_Do_APP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📝 Django To-Do List App

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.

🌐 Live Demo

👉 Visit the Live App on Render
(Replace with your actual Render URL)


🚀 Features

  • 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

🛠️ Tech Stack

  • Python 3.x
  • Django (latest stable version)
  • SQLite (development database)
  • HTML + Django Templates
  • Hosted on Render

🗂️ Project Structure

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


🚀 Django Project Setup Guide

This guide helps you set up and run the Django project on your local machine.


✅ Prerequisites

  • Python 3.x installed
  • pip installed (comes with Python)
  • Git (optional, if you're cloning the project)

Django Project Setup

To set up and run this Django project locally, follow the steps below:

  1. Make sure you have Python 3.x and pip installed on your system.

  2. (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

  3. Create a virtual environment:
    python -m venv venv

  4. Activate the virtual environment:

    • On macOS/Linux: source venv/bin/activate
    • On Windows: venv\Scripts\activate
  5. Install all required dependencies:
    pip install -r requirements.txt

  6. Run database migrations to set up the SQLite database:
    python manage.py migrate

  7. Start the Django development server:
    python manage.py runserver

  8. 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 with python-decouple or django-environ.

You are now ready to start building and running your Django project locally. Happy coding!

About

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.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published