Kovoit – Carpooling Application

Kovoit is a carpooling web application built with Vaadin and Spring Boot.
It provides a clean authentication system, a modern UI, and a scalable architecture ready for new features.

Main Features

• Modern UI built with Vaadin Flow
• User authentication (students)
• Data persistence with JPA / Hibernate
• Secure password management using BCrypt
• Responsive navigation with a main layout and sidebar

Technologies

• Java 21
• Spring Boot 3
• Vaadin 24+
• H2 Database (default for development)
• Maven

How to Run

The project includes a default Dockerfile and a Makefile to simplify build and run operations.

Requirements

• Docker installed and running
• (Optional) make command available

Steps

Using Makefile (recommended)

make start

This will:

1. Build the Docker image(s) if needed
2. Create and start the services defined in docker-compose.yml
3. Expose port 8080 and stream the container logs

Manual commands

If you prefer not to use make, you can run:

docker compose up --build

Then open http://localhost:8080/login