📗 Table of Contents

• 📗 Table of Contents
• 📖 Full-Stack-Capstone-Frontend
  • 🛠 Built With
    • Tech Stack
    • Key Features
  • Back-End-Link
  • 💻 Getting Started
    • Prerequisites
    • Setup
    • Usage
    • Deployment
  • 👥 Authors
  • 🔭 Future Features
  • 🤝 Contributing
  • ⭐️ Show your support
  • 🙏 Acknowledgments
  • 📝 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

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-End-Link

The back-end repo is available here

💻 Getting Started

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

1. Download or clone this repostory.
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
• ✔ IDE or a code editor installed in your machine.
• ✔ IRB.
• ✔ Get Postgresql up and running. you can download it from here.
• ✔ Git installed in your machine.
• ✔ Sign in or sign up to your Github account.
• ✔ A professional editer such as VS Code.
• ✔ An Updated web browser such as Google Chrome, you can download it from here.

Setup

• Clone this repository to your desired folder:

• Run this command in your command line interface:

  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:

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

   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
• Twitter: @umair_ra0
• LinkedIn: LinkedIn

👤 Eugene Omwomo

• GitHub: @Omwomo
• Twitter: @eugeneoduor9
• LinkedIn: LinkedIn

👤 Bhushan Deshmukh

• GitHub: @bhushan354
• LinkedIn: Bhushan Deshmukh

🔭 Future Features

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

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

⭐️ Show your support

If you like this project, kindly drop a start ⭐️ for the repository;

🙏 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.

📝 License

This project is MIT licensed.