React / Django Task Manager App

Description

This repository contains a full-stack task management platform application.

Technologies Used

• Backend: Python with Django (REST framework)
• Frontend: TypeScript with React and Vite middleware (custom Express server)
• Database: PostgreSQL

Additinal features include:

• Mailhog - email testing tool;
• Backend Unit Testing;
• Frontend Logger - winston debug & error logger with rotating file handlers;
• Dockerized: Easy setup and deployment

---

Prerequisites

Ensure you have the following installed on your machine:

• Docker (latest version)
• Docker Compose (latest version)

---

Installation

Docker Setup

1 . Clone The Repository:

git clone https://github.com/GGurol/react-django-task-app.git

2. Navigate to the root directory:

cd react-django-task-app

3. Build and start the Docker containers:

docker compose up --build -d

4. Run database migrations:

docker compose exec backend python website/manage.py migrate

5. Create Django Superuser (* OPTIONAL )

docker compose exec backend python website/manage.py createsuperuser

Access the application:

By default:

• The frontend will be available at http://localhost:3000
• The backend will be available at http://localhost:8000
• The mailHog service will be available at http://localhost:8025

Try creating an account and logging in.

---

Additional Information:

• Mailhog:
  Mailhog is included in the Docker setup to catch outgoing emails. ( Contact Us ) Access it at http://localhost:8025.

• Database:
  The Docker setup includes a PostgreSQL database. Configure the connection in the .env file.

By default, the copied .env files should work when you run docker compose up.
However, if any errors occur, ensure the correct hostnames, ports, and credentials are specified for PostgreSQL and Mailhog.
Also, check the frontend and backend hostnames and ports.