Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/mohamedhnoor/cars-rental-frontend

Car Rentals Frontend is a React app that serves as a front end to the Car Rentals project.
https://github.com/mohamedhnoor/cars-rental-frontend

axios react redux

Last synced: about 5 hours ago
JSON representation

Car Rentals Frontend is a React app that serves as a front end to the Car Rentals project.

Awesome Lists containing this project

README 

        





  
Cars Rental Frontend







# 📗 Table of Contents



- [📗 Table of Contents](#-table-of-contents)

- [📖 Cars Rental Frontend ](#-cars-rental-frontend-)

  - [Live Demo](#live-demo)

  - [Desktop View](#desktop-view)

  - [Mobile View](#mobile-view)

  - [Kanban Board](#kanban-board)

  - [Backend](#backend)

  - [Contributors](#contributors)

  - [🛠 Built With ](#-built-with-)

    - [Tech Stack ](#tech-stack-)

    - [Key Features ](#key-features-)

  - [💻 Getting Started ](#-getting-started-)

  - [To get a local copy up and running, follow these steps.](#to-get-a-local-copy-up-and-running-follow-these-steps)

    - [Prerequisites](#prerequisites)

    - [Setup](#setup)

    - [Install](#install)

  - [👥 Authors ](#-authors-)

  - [🔭 Future Features ](#-future-features-)

  - [🤝 Contributing ](#-contributing-)

  - [⭐️ Show your support ](#️-show-your-support-)

  - [🙏 Acknowledgments ](#-acknowledgments-)

  - [📝 License ](#-license-)



# 📖 Cars Rental Frontend 



> Car Rentals Frontend is a React app that serves as a front end to the Car Rentals project.



## Live Demo



To see this project's live demo, please click [here](https://wheelsaway-app.vercel.app/).



## Desktop View



![screenshot](./src/assets/desktop.png)



## Mobile View



![screenshot](./src/assets/mobile.png)



## Kanban Board



To view the Kanban Board we built for this project please click [here](https://github.com/users/demix007/projects/3).



To view the issue with the Kanban Board screenshots please click [here](https://github.com/demix007/car-rentals-backend/issues/18).



## Backend



Api documentation can be found [here](https://documenter.getpostman.com/view/26901652/2s93eZyBwq)



Api live demo can be found [here](https://cars-api.up.railway.app/)



## Contributors



There were 4 contributors to this project, you can see their contact information in the Authors section of this document.



## 🛠 Built With 



This app is build with React and Redux.



### Tech Stack 



> 
  • React
    • 

    > 
  • Redux
    • 


    ### Key Features 
    


    > - The login page where the user logs in to the website.

    > - The home page where the user can see a list of cars and click on any car to display the details of that car.

    > - The details page is where the user can click on the "Reserve" button to reserve the car.

    > - The user can see a list of their reservations.

    > - The user can add a new car.

    > - The user can click on the delete button from the naviagtion panel and see a list of all cars with the car name and a "delete" button and then delete a particular car.

    > - The deleted cars are removed from the home page.
    


    (back to top)
    


    ## 💻 Getting Started 
    


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


    ### Prerequisites
    


    In order to run this project you need:
    


    - Mac or PC

    - Install node.js

    - Use npm as package manager.

    - Understanding of React and Redux
    


    ### Setup
    


    - Clone this repository to your desired folder:
    


    ```sh

     git clone https://github.com/houdamzari/Cars-Rental-FrontEnd.git

    ```
    


    - Navigate into the cloned folder
    


    ```sh

     cd Cars-Rental-FrontEnd
    


    ```
    


    ### Install
    


    - Install this project with:
    


    ```sh

     npm install

    ```
    


    - Start the server
    


    ```sh

     npm start

    ```
    


    (back to top)
    


    ## 👥 Authors 
    


    👤 **Ayodeji Abidemi**
    


    - GitHub: [![demix007](https://img.shields.io/badge/-demix007-white?logo=GitHub&logoColor=181717&style=plastic)](https://github.com/demix007)

    - Twitter: [![dat_dope_demix](https://img.shields.io/badge/-dat_dope_demix-blue?logo=Twitter&logoColor=skyBlue&style=plastic)](https://twitter.com/dat_dope_demix)

    - LinkedIn: [![ayodeji-abidemi](https://img.shields.io/badge/-AyodejiAbidemi-white?logo=LinkedIn&logoColor=181717&style=plastic)](https://linkedin.com/in/ayodeji-abidemi)
    


    👤 **Mohamed Hassan Noor**
    


    - GitHub: [![MohamedHNoor](https://img.shields.io/badge/-MohamedHNoor-white?logo=GitHub&logoColor=181717&style=plastic)](https://github.com/MohamedHNoor)

    - Twitter: [![MohamedHNoor](https://img.shields.io/badge/-MohamedHNoor-blue?logo=Twitter&logoColor=skyBlue&style=plastic)](https://twitter.com/MohamedHNoor)

    - LinkedIn: [![MohamedHNoor](https://img.shields.io/badge/-MohamedHNoor-white?logo=LinkedIn&logoColor=181717&style=plastic)](https://www.linkedin.com/in/mohamedhnoor/)
    


    👤 **Houda Mzari**
    


    - GitHub: [![houdamzari](https://img.shields.io/badge/-houdamzari-white?logo=GitHub&logoColor=181717&style=plastic)](https://github.com/houdamzari/)

    - LinkedIn: [![houdamzari](https://img.shields.io/badge/-houdamzari-white?logo=LinkedIn&logoColor=181717&style=plastic)](https://www.linkedin.com/in/houda-mzari/)
    


    👤 **Kashif Saleem**
    


    - GitHub:[![Kashif](https://img.shields.io/badge/-Kashif-white?logo=GitHub&logoColor=181717&style=plastic)](https://github.com/Kashif-Saleem-Ghuman)

    - Twitter:[![Kashif](https://img.shields.io/badge/-Kashif-blue?logo=Twitter&logoColor=skyBlue&style=plastic)](https://twitter.com/Kashif14Saleem)

    - LinkedIn:[![Kashif](https://img.shields.io/badge/-Kashif-white?logo=LinkedIn&logoColor=181717&style=plastic)](https://www.linkedin.com/in/kashifsaleemghuman/)
    


    (back to top)
    


    ## 🔭 Future Features 
    


    - [ ] **Allow users to choose a language for the application**

    - [ ] **Add payment option**

    - [ ] **Some UX improvements: include transitions and/or animations, etc.**
    


    (back to top)
    


    ## 🤝 Contributing 
    


    Contributions, issues, and feature requests are welcome!
    


    Feel free to check the [issues page](https://github.com/houdamzari/Cars-Rental-FrontEnd/issues).
    


    (back to top)
    


    ## ⭐️ Show your support 
    


    If you like this project, please leave a ⭐️
    


    (back to top)
    


    ## 🙏 Acknowledgments 
    


    - We would like to thank Microverse for providing the reading materials that aided us to during the project development.

    - We would like to give Credit to 🙏 Murat Korkmaz the author of the original Vespa- Responsive Redesign, as required by the Creative Commons License.
    


    (back to top)
    


    ## 📝 License 
    


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


    (back to top)