{"id":16071553,"url":"https://github.com/fmanimashaun/book-car","last_synced_at":"2025-10-25T17:31:06.472Z","repository":{"id":222261557,"uuid":"756288050","full_name":"fmanimashaun/book-car","owner":"fmanimashaun","description":"BookCar is a car booking application developed as part of the Microverse Full-Stack Web Development Program’s capstone project. it provides a seamless and user-friendly platform for users to view and reserve cars for rides","archived":false,"fork":false,"pushed_at":"2024-02-29T12:46:05.000Z","size":3941,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2025-01-06T03:39:34.300Z","etag":null,"topics":["admin","api","authentication-backend","react","redux-toolkit","tailwindcss"],"latest_commit_sha":null,"homepage":"https://fmanimashaun.github.io/book-car/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fmanimashaun.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-12T11:17:47.000Z","updated_at":"2024-12-27T01:52:47.000Z","dependencies_parsed_at":"2024-10-10T22:47:59.148Z","dependency_job_id":null,"html_url":"https://github.com/fmanimashaun/book-car","commit_stats":null,"previous_names":["fmanimashaun/book-a-car","fmanimashaun/book-car"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fmanimashaun%2Fbook-car","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fmanimashaun%2Fbook-car/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fmanimashaun%2Fbook-car/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fmanimashaun%2Fbook-car/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fmanimashaun","download_url":"https://codeload.github.com/fmanimashaun/book-car/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238188551,"owners_count":19430874,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["admin","api","authentication-backend","react","redux-toolkit","tailwindcss"],"created_at":"2024-10-09T07:41:12.223Z","updated_at":"2025-10-25T17:31:05.880Z","avatar_url":"https://github.com/fmanimashaun.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"screenshots/cover-invert.png\" alt=\"\" width=\"200\"  height=\"auto\" /\u003e\n\u003c/div\u003e\n\n\n\u003c!-- ! TABLE OF CONTENTS --\u003e\n\n# 📗 Table of Contents\n\n- [📖 About the Project](#about-project)\n  - [📊 Kanban](#kanban-board)\n  - [🛠 Built With](#built-with)\n    - [Tech Stack](#tech-stack)\n- [🖥️ Backend Integration](#backend-integration)\n  - [Key Features](#key-features)\n  - [🚀 Live Demo](#live-demo)\n- [💻 Getting Started](#getting-started)\n  - [Setup](#setup)\n  - [Prerequisites](#prerequisites)\n  - [Install](#install)\n  - [Usage](#usage)\n- [👥 Authors](#authors)\n- [🔭 Future Features](#future-features)\n- [🤝 Contributing](#contributing)\n- [⭐️ Show your support](#support)\n- [🙏 Acknowledgements](#acknowledgements)\n- [📝 License](#license)\n\n\n\u003c!-- ! PROJECT DESCRIPTION --\u003e\n\n# 📖 BookCar | Book a Ride App \u003ca name=\"about-project\"\u003e\u003c/a\u003e\n**BookCar** is a car booking application developed as part of the Microverse Full-Stack Web Development Program’s capstone project. it provides a seamless and user-friendly platform for users to view and reserve cars for rides. The application is built with React and communicates with a Rails API backend named [BookCar-API](https://github.com/fmanimashaun/book-car-api). This application demonstrates proficiency in full-stack web development, including React, Redux, Tailwind CSS, React-Router, and Rails API development. It showcases the ability to build a robust frontend that communicates effectively with a backend service, and manage application state using modern tools and libraries.\n\n- [BookCar (Frontend) Kanban Board](https://github.com/users/fmanimashaun/projects/16)\n- [BookCar Api (Backend) Kanban Board](https://github.com/users/fmanimashaun/projects/16/views/1)\n\n**Team Members**\n\n- [Anwar Hussaini](https://github.com/M-Anwar-Hussaini)\n- [Esteban Palacios](https://github.com/Estete9)\n- [Timothy Njoroge](https://github.com/simplegoose)\n- [Tomas Esquivel](https://github.com/tomasesquivelgc)\n- [Animashaun Fisayo Micahel](https://github.com/fmanimashaun)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## 🛠 Built With \u003ca name=\"built-with\"\u003e\u003c/a\u003e\n\n### Tech Stack \u003ca name=\"tech-stack\"\u003e\u003c/a\u003e\n\n### Tech Stack \u003ca name=\"tech-stack\"\u003e\u003c/a\u003e\n\n- [React](https://reactjs.org/)\n- [React Router Dom](https://reactrouter.com/web/guides/quick-start)\n- [React Redux](https://react-redux.js.org/)\n- [Redux-toolkit](https://redux-toolkit.js.org/)\n- [Axios](https://axios-http.com/)\n- [Bootstrap](https://getbootstrap.com/)\n- [React Icons](https://react-icons.github.io/react-icons/)\n- [PropTypes](https://www.npmjs.com/package/prop-types)\n- [Tailwindcss](https://tailwindcss.com/)\n\n\u003c!-- ! BACKEND INTEGRATION --\u003e\n\n# 🖥️ Backend Integration \u003ca name=\"backend-integration\"\u003e\u003c/a\u003e\n\nThis project relies on a backend service to fetch and handle data. To ensure the project functions correctly, it's crucial to have a working backend. If you don't have a backend set up yet, kindly follow the instruction on [Book-car-api](https://github.com/fmanimashaun/book-car-api) repo for how to setup local backend for to support the frontend.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- ! Features --\u003e\n\n### Key Features \u003ca name=\"key-features\"\u003e\u003c/a\u003e\n\n- Views/Components:\n  - **Car Listing:** Grid/list display of available cars.\n  - **Car Details:** Showcase car information, booking potential.\n  - **Reservation Form:** User inputs booking details (dates, user autofill).\n  - **My Reservations:** Displays a user's reservation history.\n  - **Admin Forms:** (Add/Delete Cars), protected and visible only to authorized users.\n  - **Navigation:** Clear links between areas of the app.\n- **Routing:** React Router for seamless navigation between views.\n- **State Management:**\n  - **Redux-toolki:** Centralized data store.\n  - **Actions/Reducers:** Fetch car listings, reservation management, user/authentication state.\n- **API Interaction:** Fetch calls to backend, error handling\n- **Input Validation:** User-friendly forms with data integrity checks.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- ! LIVE DEMO --\u003e\n\n## 🚀 Live Demo \u003ca name=\"live-demo\"\u003e\u003c/a\u003e\n\n- [Live Demo Link](https://fmanimashaun.github.io/book-car)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- ! GETTING STARTED --\u003e\n\n## 💻 Getting Started \u003ca name=\"getting-started\"\u003e\u003c/a\u003e\n\nTo get a local copy up and running, follow these steps.\n\n### Prerequisites\n\nIn order to run this project you need:\n\n### Setup\n\nClone this repository to your desired folder:\n\nExample commands:\n\n- With HTTPS:\n\n```bash\n  cd my-folder\n  git clone https://github.com/fmanimashaun/book-car.git\n```\n\n### Install\n\nInstall this project's dependencies with:\n\n```bash\n  npm install\n```\n\n### Usage\n\nTo run the project, first, make sure you have these files in the project's root directory\n\n`.env` with this code `REACT_APP_BASE_URL=http://localhost:4000`\n\nThen execute the following command:\n\n```bash\n npm run start\n```\n\nRuns the app in the development mode.\\\nOpen [http://localhost:3000](http://localhost:3000) to view it in your browser.\n\nThe page will reload when you make changes.\\\nYou may also see any lint errors in the console.\n\n### Run Linters\n\n#### ESLint\n\n```bash\n  npm run eslinter\n```\n\n#### Stylelint\n\n```bash\n  npm run stylelinter\n```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- ! AUTHORS --\u003e\n\n## 👥 Authors \u003ca name=\"authors\"\u003e\u003c/a\u003e\n\n👤 **Fisayo Michael Animashaun**\n\n- GitHub: [@fmanimashaun](https://github.com/fmanimashaun)\n- Twitter: [@fmanimashaun](https://twitter.com/fmanimashaun)\n- LinkedIn: [Fisayo Michael Animashaun ](https://linkedin.com/in/fmanimashaun)\n\n👤 **Tomas Matias Esquivel**\n- GitHub: [@tomasesquivelgc](https://github.com/tomasesquivelgc)\n- Twitter: [@EsquivelTomas](https://twitter.com/EsquivelTomas)\n- LinkedIn: [Tomas Esquivel](https://www.linkedin.com/in/tomás-esquivel-b2160568/)\n\n👤 **Timothy Njoroge**\n- GitHub: [@simplegoose](https://github.com/simplegoose)\n- LinkedIn: [@Timothy Njoroge](https://linkedin.com/in/timothy-njoroge-mwangi)\n  \n👤 *Anwar Hussaini*\n\n- GitHub: [Anwar Hussaini](https://github.com/M-Anwar-Hussaini)\n- LinkedIn: [Anwar Hussaini](https://www.linkedin.com/in/anwar-hussaini/)\n\n👤 **Esteban Palacios**\n\n- GitHub: [@Estete9](https://github.com/Estete9)\n- Twitter: [@NaughTban](https://twitter.com/NaughTban)\n- LinkedIn: [Esteban Palacios](https://www.linkedin.com/in/dev-esteban-palacios/)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- ! FUTURE FEATURES --\u003e\n\n## 🔭 Future Features \u003ca name=\"future-features\"\u003e\u003c/a\u003e\n\n- [ ] **Dark mode.**\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- ! CONTRIBUTING --\u003e\n\n## 🤝 Contributing \u003ca name=\"contributing\"\u003e\u003c/a\u003e\n\nContributions, issues, and feature requests are welcome!\n\nFeel free to check the [issues page](https://github.com/fmanimashaun/book-car/issues).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- ! SUPPORT --\u003e\n\n## ⭐️ Show your support \u003ca name=\"support\"\u003e\u003c/a\u003e\n\nGive a ⭐ if you liked this project!\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- ! ACKNOWLEDGEMENTS --\u003e\n\n## 🙏 Acknowledgments \u003ca name=\"acknowledgements\"\u003e\u003c/a\u003e\n\n- Behance and Murat Korkmaz for the [original design](https://www.behance.net/gallery/26425031/Vespa-Responsive-Redesign)\n- [Microverse](https://www.microverse.org/) for providing the opportunity to learn in a collaborative environment.\n- We the team will like to thank one another for the contribution and dedication for seeing the project to the end\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- ! LICENSE --\u003e\n\n## 📝 License \u003ca name=\"license\"\u003e\u003c/a\u003e\n\nThis project is [MIT](./MIT) licensed.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffmanimashaun%2Fbook-car","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffmanimashaun%2Fbook-car","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffmanimashaun%2Fbook-car/lists"}