Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bhushan354/reservation-app-frontend

The Full-Stack-Capstone-Frontend is a web application designed to streamline the process of renting cars.
https://github.com/bhushan354/reservation-app-frontend

react-router reactjs redux-toolkit rubyonrails-api

Last synced: 18 days ago
JSON representation

The Full-Stack-Capstone-Frontend is a web application designed to streamline the process of renting cars.

Awesome Lists containing this project

README

        

Full-Stack-Capstone-Frontend: Vehicle Reservation App

# 📗 Table of Contents

- [📗 Table of Contents](#-table-of-contents)
- [📖 Full-Stack-Capstone-Frontend](#-full-stack-capstone-frontend)
- [🛠 Built With ](#-built-with-)
- [Tech Stack ](#tech-stack-)
- [Key Features ](#key-features-)
- [Back-End-Link](#back-end-link)
- [💻 Getting Started ](#-getting-started-)
- [Prerequisites](#prerequisites)
- [Setup](#setup)
- [Usage](#usage)
- [Deployment](#deployment)
- [👥 Authors ](#-authors-)
- [🔭 Future Features ](#-future-features-)
- [🤝 Contributing ](#-contributing-)
- [⭐️ Show your support ](#️-show-your-support-)
- [🙏 Acknowledgments ](#-acknowledgments-)
- [📝 License ](#-license-)

# 📖 Full-Stack-Capstone-Frontend

*The Full-Stack-Capstone-Frontend* is a web application designed to streamline the process of renting cars. Users can log in securely using their username and access various features through a navigation panel. The system allows users to browse available cars, make reservations, manage bookings, add new cars to the inventory, and delete them. The application is responsive, providing both mobile and desktop versions for a user-friendly experience.

## 🛠 Built With
- ✅ Ruby
- ✅ Ruby on Rails - Api
- ✅ Postgresql
- ✅ Linters
- ✅ React

### Kanban Board
Link to Kanban Board for this Project: https://github.com/users/bhushan354/projects/6

Link to kanban board issue: https://github.com/bhushan354/Full-Stack-Capstone-Frontend/issues/12

### Tech Stack

Language


  • Ruby-on-Rails

  • React

### Key Features

- 🔰 *User Authentication:* secure login using email and password.
- 🔰 *Navigation Panel:* has links to browse and reserve cars. "My Reservations" page for booking management, and "Add Car" and "Delete Car" links for administrators.
- 🔰 *Main Page:* Displays a list of available cars. Clicking on a specific car provides access to its details page.
- 🔰 *Details Page:* Shows comprehensive details of the selected car and a "Reserve" button for making a reservation.
- 🔰 *Reserve Form:* Allows users to reserve a car by selecting a date and city.
- 🔰 *Delete car:* Accessible only by administrators, displays a list of all cars with a "Delete" button. Deleted cars are marked as removed and do not appear on the main list.
- 🔰 *Responsive design:* Both mobile and desktop versions for optimal user experience.
- 🔰 *My Reservations:* Users can view a list of their reservations, including car name, date, and city.
- 🔰 *Autofill for Reservations:* Reservations autofill username and selected car details. Additional inputs for date and city based on the "Book a Car" design.

(back to top)

## Back-End-Link

The back-end repo is available [here](https://github.com/bhushan354/Full-Stack-Capstone-Backend)

(back to top)

## 💻 Getting Started

*To get a local copy up and running, follow these steps.*

1. Download or clone this [repostory]([email protected]:bhushan354/Full-Stack-Capstone-Frontend.git).
2. Provide a modern web browser.

### Prerequisites

*In order to run this project you need:*

- ✔ Ruby installed in your machine. you can download it from [here](https://www.ruby-lang.org/en/downloads/)
- ✔ IDE or a code editor installed in your machine.
- ✔ IRB.
- ✔ Get Postgresql up and running. you can download it from [here](https://www.postgresql.org/download/windows/).
- ✔ [Git](https://git-scm.com/downloads) installed in your machine.
- ✔ Sign in or sign up to your [Github](https://github.com/) account.
- ✔ A professional editer such as [VS Code](https://code.visualstudio.com/download).
- ✔ An Updated web browser such as Google Chrome, you can download it from [here](https://www.google.com/chrome/).

### Setup

- Clone this [repository]([email protected]:bhushan354/Full-Stack-Capstone-Frontend.git) to your desired folder:

- Run this command in your command line interface:

```sh
cd [YOUR FOLDER]
git clone [email protected]:bhushan354/Full-Stack-Capstone-Frontend.git
cd Full-Stack-Capstone-Frontend
```

- Open the project in your favourite code editor, Add this piece of code into the dependencies of package.json file:

```sh
"react-elastic-carousel": "^0.11.5",
```

```sh
npm install --force
PORT=3001 npm start
```

- Now Headover To Backend-Repo and follow setup to make sure your app is working fine with rails as a backend : https://github.com/bhushan354/Full-Stack-Capstone-Backend/tree/dev

## 👥 Authors

👤 **Muhammad Umair Muqeem**

- GitHub: [@umair-rao](https://github.com/umair-rao)
- Twitter: [@umair_ra0](https://twitter.com/umair_ra0)
- LinkedIn: [LinkedIn](https://www.linkedin.com/in/engr-umair-muqeem/)

👤 *Eugene Omwomo*

- GitHub: [@Omwomo](https://github.com/Omwomo)
- Twitter: [@eugeneoduor9](https://twitter.com/eugeneoduor9)
- LinkedIn: [LinkedIn](https://linkedin.com/in/Omwomo)

👤 *Bhushan Deshmukh*

- GitHub: [@bhushan354](https://github.com/bhushan354)
- LinkedIn: [Bhushan Deshmukh](https://www.linkedin.com/in/bhushan-deshmukh-5777851b1/)

(back to top)

## 🔭 Future Features

- *Search and Filter Functionality*
- *User Ratings and Reviews*
- *Discounts and Promotions*
- *Multi-language Support*
- *Integration with Maps*
- *Payment Integration*
- *User Profile Management*

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/bhushan354/Full-Stack-Capstone-Frontend/issues).

(back to top)

## ⭐️ Show your support

If you like this project, kindly drop a start ⭐️ for the [repository]([email protected]:bhushan354Full-Stack-Capstone-Frontend.git);

(back to top)

## 🙏 Acknowledgments

We would like to express my heartfelt gratitude to *Microvere* for the invaluable learning experience they have provided. Also we would like to appreciate each for a great team work we demonstrated during the project.

(back to top)

## 📝 License

This project is [MIT](./LICENSE) licensed.

(back to top)