🚀 Health Tracker - Quick Start Guide

Get up and running with Health Tracker in 5 minutes!

⚡ Quick Setup (Linux/Mac)

# 1. Clone and navigate
git clone https://github.com/AndrewTr0612/DjangoTestingHealthApp.git
cd DjangoTestingHealthApp/project

# 2. Create virtual environment
python3 -m venv .venv
source .venv/bin/activate

# 3. Install dependencies
pip install -r src/requirements.txt

# 4. Setup database
cd src
python manage.py migrate

# 5. Start server
python manage.py runserver

# 6. Open http://localhost:8000 in your browser

⚡ Quick Setup (Windows)

# 1. Clone and navigate
git clone https://github.com/AndrewTr0612/DjangoTestingHealthApp.git
cd DjangoTestingHealthApp\project

# 2. Create virtual environment
python -m venv .venv
.venv\Scripts\activate

# 3. Install dependencies
pip install -r src\requirements.txt

# 4. Setup database
cd src
python manage.py migrate

# 5. Start server
python manage.py runserver

# 6. Open http://localhost:8000 in your browser

📋 Step-by-Step Instructions

Step 1: Clone Repository

git clone https://github.com/AndrewTr0612/DjangoTestingHealthApp.git
cd DjangoTestingHealthApp

Step 2: Navigate to Project

cd project

Step 3: Create Virtual Environment

Linux/Mac:

python3 -m venv .venv
source .venv/bin/activate

Windows:

python -m venv .venv
.venv\Scripts\activate

Step 4: Install Requirements

pip install -r src/requirements.txt

Dependencies installed:

Django 5.2.7
python-decouple 3.8
Other core libraries

Step 5: Setup Environment (Optional)

cd src

Create .env file (optional - has defaults):

SECRET_KEY=django-insecure-development-key
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1,0.0.0.0

Step 6: Run Database Migrations

python manage.py migrate

This creates:

User tables
UserProfile
WeightEntry
WeightGoal
ChatMessage

Step 7: Create Admin User (Optional)

python manage.py createsuperuser

Follow prompts to create admin account.

Step 8: Start Development Server

python manage.py runserver

You should see:

Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Step 9: Open in Browser

Navigate to: http://localhost:8000

🎯 First Steps in the App

1. Register Your Account

Click "Register" button
Choose username and password
Enter email (optional)
Click "Sign Up"

2. Setup Your Profile

Enter your height (cm)
Select gender
Enter date of birth (optional)
Click "Save Profile"

3. Add First Weight Entry

Click "Add Weight" in navbar
Enter current weight (kg)
Add notes if desired
Click "Add Weight Entry"

4. Set Your Goal

Click "Set Goal" in navbar
Choose goal type:
- Lose Weight
- Gain Weight
- Maintain Weight
Enter target weight
Select pace (slow/moderate/fast)
View timeline calculation
Click "Set Goal"

5. View Dashboard

See current weight & BMI
View progress to goal
Check weight trend chart
Monitor timeline

6. Try the Chatbox

Click blue chat button (bottom-right)
Ask questions:
- "What should I eat?"
- "Give me workout tips"
- "Show meal prep ideas"
- "I need motivation"

🛠️ Troubleshooting

Port Already in Use

# Use different port
python manage.py runserver 8080

# Or kill process on port 8000
# Linux/Mac:
lsof -ti:8000 | xargs kill -9

# Windows:
netstat -ano | findstr :8000
taskkill /PID <PID> /F

Module Not Found

# Make sure virtual environment is activated
# Linux/Mac:
source .venv/bin/activate

# Windows:
.venv\Scripts\activate

# Reinstall requirements
pip install -r src/requirements.txt

Database Errors

# Delete database and recreate
rm db.sqlite3
rm -rf account/migrations/0*.py
rm -rf chatbox/migrations/0*.py

# Recreate migrations
python manage.py makemigrations
python manage.py migrate

Static Files Not Loading

# Collect static files
python manage.py collectstatic --noinput

🔑 Admin Panel Access

Create superuser (if not done):
```
python manage.py createsuperuser
```
Access admin panel:
```
http://localhost:8000/admin
```
Login with superuser credentials
Manage:
- Users
- Profiles
- Weight Entries
- Goals
- Chat Messages

📦 What's Included

Features

✅ User authentication & registration
✅ Profile management (name, email, height, DOB)
✅ Weight tracking with history
✅ Automatic BMI calculation
✅ Goal setting with timeline calculator
✅ Progress tracking dashboard
✅ Interactive weight trend charts
✅ Health advice chatbox (no API needed!)
✅ Responsive design (mobile-friendly)
✅ Floating chat widget

🎨 Customization

Change Theme Colors

Edit templates/base.html:

:root {
    --primary-color: #667eea;  /* Change this */
    --secondary-color: #764ba2; /* And this */
}

Modify Health Tips

Edit chatbox/gpt.py:

self.diet_tips = [
    "Your custom diet tip here",
    # Add more...
]

Add New Features

Create view in account/views.py
Add URL in account/urls.py
Create template in templates/accounts/
Update navbar in templates/base.html

📚 Resources

Django Docs: https://docs.djangoproject.com/
Bootstrap Docs: https://getbootstrap.com/docs/
Chart.js Docs: https://www.chartjs.org/docs/

🐛 Common Issues

Issue: "No module named 'decouple'"

Solution:

pip install python-decouple

Issue: "CSRF verification failed"

Solution: Make sure you're using {% csrf_token %} in all forms

Issue: Charts not showing

Solution: Check browser console for JavaScript errors. Make sure Chart.js CDN is accessible.

Issue: Login redirects to profile setup repeatedly

Solution: Complete all required profile fields (height, gender)

✅ You're All Set!

Your Health Tracker is now running at http://localhost:8000

Next Steps:

✅ Register your account
✅ Setup your profile
✅ Add your first weight entry
✅ Set a goal
✅ Start tracking your progress!

💡 Pro Tips

Track daily for best results
Set realistic goals (0.5-1kg/week)
Use the chatbox for motivation
Check dashboard weekly
Try meal prep ideas from chatbox
Follow YouTube channels recommended

🎉 Happy Tracking!

You're ready to start your health journey! 💪

For detailed documentation, see README.md

Questions? Open an issue on GitHub!

FilesExpand file tree

QUICKSTART.md

Latest commit

History