Running the Project Locally

This project contains:

• Backend: Django + Django REST Framework + SQLite
• Frontend: Next.js + React + TypeScript

Prerequisites

Make sure you have installed:

• Python 3
• Node.js
• npm

---

1. Run the Backend

From the project root:

On macOS/Linux:

cd backend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python manage.py migrate
python manage.py seed_users
python manage.py runserver

On Windows:

cd backend
python3 -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python manage.py migrate
python manage.py seed_users
python manage.py runserver

2. Run the Frontend

Open a second terminal from the project root and navigate to the frontend:

cd frontend
npm install
npm run dev

3. Run Both Applications

The backend and frontend need to run at the same time. Then open http://localhost:3000