Family Todo App

A cozy task management app for households — track chores, celebrate wins, and keep everyone accountable.

---

Demo Video

👉 Watch Family Todo App in Action on YouTube

---

What It Does

Feature	Description
Smart Task Organization	Auto-sorted by urgency: Overdue > Today > Tomorrow > Backlog
Household Sharing	Create a household, invite family with a code
Proof of Completion	Upload photos when you finish a task
Progress Analytics	See who's contributing with charts and stats
Email Notifications	Get notified when tasks are completed
"Crime" Mode	Tag playful favors separately (with special alerts!)

---

Quick Start

1. Clone & Setup

git clone https://github.com/sqqstellar/Family-todo-app.git
cd Family-todo-app

# Create virtual environment
python -m venv .venv

# Activate it
# Windows:
.\.venv\Scripts\Activate
# Mac/Linux:
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

2. Configure Environment

cp .env.example .env

Edit .env:

SECRET_KEY=your-secret-key
DEBUG=True
EMAIL_HOST_USER=your-email@gmail.com
EMAIL_HOST_PASSWORD=your-app-password

Gmail users: You need an App Password, not your regular password.

3. Run

python manage.py migrate
python manage.py runserver

Open http://127.0.0.1:8000

---

Project Structure

Family-todo-app/
├── manage.py
├── requirements.txt
├── .env.example
│
├── to_do_list/          # Django settings
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
│
└── tasks/               # Main app
    ├── models.py        # User, Household, Task, Category, Comment
    ├── views.py         # All page logic
    ├── urls.py          # Routes
    ├── templates/       # HTML pages
    └── static/          # CSS

---

Design Philosophy

Concept	Why?
Urgency-first layout	Reduces decision paralysis — overdue tasks demand attention
"Crime" tagging	Adds humor to favors, making them trackable without friction
Completion photos	"Done" is subjective — photos prove it
Comments on tasks	Brings gratitude back into chores ("Thanks!" goes a long way)

---

Tech Stack

• Backend: Django 5.2, Python 3.10+
• Database: SQLite (dev) / PostgreSQL (prod)
• Frontend: Bootstrap 4, Chart.js
• Email: Gmail SMTP
• Deploy: Render, Gunicorn, WhiteNoise

---

Deploy to Render

1. Push to GitHub
2. Connect repo on Render
3. Set environment variables
4. Build command: ./build.sh
5. Start command: gunicorn to_do_list.wsgi:application

---

License

MIT — use it however you like!

---

Made with love for families who want less chaos and more teamwork