Running the project on your machine

Prerequisites

Node.js (version 22 or compatible), npm (version 10 or compatible), Java JDK (version 21), and Docker (version 24.0.7 or compatible).

Backend Setup

Navigate to the backend directory:

cd backend

Run the docker containers:

docker-compose up

Set up continuous build:

Mac/Linux:

./gradlew build -t -x test

Windows:

gradlew.bat build -t -x test

Run the backend:

Mac/Linux:

./gradlew bootRun

Windows:

gradlew.bat bootRun

Frontend Setup

Navigate to the frontend directory:

cd frontend

Set up the necessary environment variables:

Mac/Linux:

cp .env.example .env

Windows:

copy .env.example .env

Install dependencies:

npm install

Run the frontend in development mode:

npm run dev

You can access the backend at http://localhost:8080, the frontend at http://localhost:5173, and the Mailhog SMTP server UI at http://localhost:8025.

The database hostname is 127.0.0.1, the port is 3306, and the root password is root.