Skip to content

ioanTeulea/TripNest

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ—ΊοΈ TripNest - Your Smart Travel Itinerary Planner

TripNest is a modern web application that simplifies the process of planning travel itineraries. Whether you're exploring a new city or revisiting familiar places, TripNest helps you create personalized, smart itineraries and get inspired by the travel community. ✨


🌟 Description

TripNest allows users to:

βœ… Easily create and organize custom itineraries for any city

βœ… Get automatic, smart suggestions based on personal preferences

βœ… Explore itineraries created by other travelers for inspiration

TripNest is designed to:

  • Save time by simplifying and automating itinerary planning
  • Provide relevant, personalized travel suggestions
  • Foster a space where travelers connect and inspire each other

πŸš€ Getting Started

βœ… Prerequisites


πŸ› οΈ Installation Steps

  1. Clone the repository:

    git clone https://github.com/<your-username>/tripnest.git
    cd tripnest
  2. Start the database with Docker:

    docker-compose up -d
  3. Run the backend (Spring Boot):

    cd backend
    mvn spring-boot:run
  4. Run the frontend (Angular):

    cd frontend
    npm install
    ng serve
  5. Access the app: Open your browser at: http://localhost:4200


✨ Features

  • 🎨 Intuitive Itinerary Builder: Create, organize, and customize your travel plans with ease
  • 🎯 Smart Place Suggestions: Receive recommendations based on your interests
  • πŸ” Explore Section: Get inspired by itineraries from other travelers
  • πŸ” Secure Authentication: Login with email/password or Google OAuth, secured with JWT & Refresh Tokens
  • πŸ’¬ Real-Time Notifications: Stay updated instantly with WebSocket-powered alerts
  • 🧠 Intelligent Recommendations: Content-Based Filtering using TF-IDF, embeddings, and cosine similarity
  • πŸ—ΊοΈ Google Maps Integration: Visualize locations directly on the map
  • πŸ“± Responsive Design: Optimized for desktop and mobile devices

πŸ’» Technologies Used

Frontend

  • Angular (TypeScript)
  • Angular Material, Bootstrap
  • Google Maps API

Backend

  • Spring Boot 3 (Java 21)
  • Spring Security (JWT & Google OAuth)
  • Spring Data JPA (Hibernate)
  • Spring WebSocket (STOMP protocol)
  • RESTful API design

Database

  • MySQL (Dockerized)
  • Hibernate ORM

Recommendation System

  • Content-Based Filtering
  • TF-IDF scoring
  • Pre-calculated embeddings for place types
  • Cosine similarity for personalized suggestions
  • Smile & ELKI libraries for vector processing

🎯 Project Motivation

TripNest was built to make travel planning:

  • Simpler: Reduce the time and effort required to organize trips
  • Smarter: Deliver personalized suggestions tailored to your interests
  • Social: Enable travelers to connect and share experiences

🌱 Future Improvements

  • πŸ“² Mobile app version
  • 🌀️ Integration with weather and traffic data
  • πŸ‘₯ Social features like following other users
  • πŸ—ƒοΈ Export itineraries (PDF, printable formats)
  • πŸ€– More advanced recommendation algorithms

πŸ“Έ Screenshots

image

image

image

image


🀝 Contributions

Contributions are welcome! Feel free to open issues or pull requests.


🧳 Ready to plan your next adventure?

Explore. Plan. Travel. With TripNest. 🌍

About

TripNest is a modern travel itinerary planner that helps you organize trips with ease. Create custom itineraries, get smart suggestions based on your interests, and explore travel plans shared by other users. Plan smarter, discover new places, and get inspired with TripNest. 🌍✈️

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors