Skip to content

TravelApplication/fare-share

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

249 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FareShare

FareShare is a collaborative travel planning application designed to help you and your friends organize trips seamlessly. With features like group creation, friendships management, notifications, voting on attractions, and more, FareShare makes trip planning fun and efficient.


Table of Contents


About the Project

FareShare is a full-stack application built to simplify group travel planning. Whether you're organizing a weekend getaway or a long vacation, FareShare provides tools to manage your trip collaboratively. From voting on attractions to splitting bills (coming soon) and sharing photos (coming soon), FareShare ensures everyone stays connected and involved.


Features

  • Group Creation: Create and manage travel groups with your friends.
  • Friendships Management: Add and manage friends within the app.
  • Notifications: Stay updated with real-time notifications.
  • Voting on Attractions: Vote on attractions to include in your trip itinerary.
  • Bill Splitting: Easily split expenses among group members.

Built With

This section lists the major frameworks, libraries, and tools used to build FareShare.

Backend

Backend

  • Java
  • Spring Boot
  • Postgres
  • Docker
  • JUnit
  • Mockito
  • Jacoco

Frontend

  • Next.js
  • TypeScript
  • Shadcn
  • TailwindCSS

Getting Started

Follow these steps to set up FareShare locally on your machine.

Prerequisites

Before you begin, ensure you have the following installed:

  • Java 21
  • Node.js (for frontend)
  • Docker
  • PostgreSQL

Installation

  1. Clone the repository

    git clone https://github.com/your-username/FareShare.git
    cd FareShare
  2. Set up the backend

  • In the main directory run:
    docker-compose up
  1. Set up the frontend
  • In the frontend directory run:
    npm install
    npm run dev
  1. Access the application
  • Backend: localhost:8080
  • Frontend: localhost:3000

Usage

Once the application is running, you can:

  • Create an account and log in.

  • Create or join a travel group.

  • Add friends and manage your connections.

  • Vote on attractions and plan your itinerary.

  • Stay updated with real-time notifications.

Contributors

FareShare was developed by:


- Agata Bartczak - Oskar Gawryszewski - Szymon Grabski - Sebastian Jabłoński

Acknowledgements

We would like to thank the following resources and tools that helped us build FareShare:

About

Collaborative travel planning application designed to help you and your friends organize trips seamlessly

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages