Travel Guide

Travel Guide is simple web application for exploring destinations around the world.

Getting Started

Requirements:

• JDK 17 or above
• Maven 3.0.0 or above
• Tomcat 10.0.0 or above
• PostgreSQL 16.0 or above
• JavaScript package manager (npm, yarn, bun...)

Database setup:

1. create PostgreSQL database scheme
2. create tables using database/create.sql script
3. seed data using database/seed.sql script

Backend setup:

Inside folder backend/src/main/resources create file application.local.properties with structure:

database.host= #localhost
database.port= #5432
database.scheme= #travel_guide
database.username= #username
database.password= #password

Build and package the backend into a web archive (war) and deploy to the tomcat server. This can be done manually or using an IDE such as IntelliJ IDEA Ultimate (community version does not contain tomcat configuration) or eclipse.

Frontend setup:

Inside folder frontend create env file .env.local with structure:

TG_API_URL= #http://localhost:8080/TravelGuide/api/v1

Features & Technologies

Database:

• PostgreSQL

Backend:

• Java
• Java Database Connectivity
• Validation
• Eclipse Jersey
• JSON Web Token
• Pagination

Frontend:

• React
• Typescript
• Tailwind (customized)
• Shadcn (customized)
• Axios
• Zod