aelassas / bookcars

Car Rental Platform with Mobile App

Preface

As of 30^th April 2024, Stripe Payment Gateway integration was successfully implemented in the frontend, the backend and the mobile app, and is fully operational. You can download the demo mobile app, and find the frontend and backend demo links here.

BookCars

BookCars is a fully functional car rental platform with operational Stripe Payment Gateway, supplier-oriented, with a backend for managing car fleets and bookings, as well as a frontend and a mobile app for renting cars.

BookCars is designed to work with multiple suppliers. Each supplier can manage his car fleet and bookings from the backend. BookCars can also work with only one supplier as well.

From the backend, admins can create and manage suppliers, cars, locations, customers and bookings.

When new suppliers are created, they receive an email prompting them to create an account in order to access the backend and manage their car fleet and bookings.

Customers can sign up from the frontend or the mobile app, search for available cars based on pickup and drop-off points and time, choose a car and complete the checkout process.

A key design decision was made to use TypeScript instead of JavaScript due to its numerous advantages. TypeScript offers strong typing, tooling, and integration, resulting in high-quality, scalable, more readable and maintainable code that is easy to debug and test.

BookCars can run in a Docker container. Follow this step by step guide to walk you through on how to build BookCars Docker image and run it in a Docker container.

Features

• Supplier management
• Ready for one or multiple suppliers
• Car fleet management
• Booking management
• Payment management
• Customer management
• Multiple payment methods (Credit Card, Pay Later)
• Operational Stripe Payment Gateway
• Multiple language support (English, French)
• Multiple pagination options (Classic pagination with next and previous buttons, infinite scroll)
• Responsive backend and frontend
• Native Mobile app for Android and iOS with single codebase
• Push notifications
• Secure against XSS, XST, CSRF and MITM
• Supported Platforms: iOS, Android, Web, Docker

Live Demo

Frontend

• URL: https://bookcars.v6.rocks:3002/
• Login: [e-mail]
• Password: B00kC4r5

Backend

• URL: https://bookcars.v6.rocks:3001/
• Login: [e-mail]
• Password: B00kC4r5

Mobile App

You can install the Android app on any Android device.

Scan this code with a device

Open the Camera app and point it at this code. Then tap the notification that appears.

How to install the Mobile App on Android

• On devices running Android 8.0 (API level 26) and higher, you must navigate to the Install unknown apps system settings screen to enable app installations from a particular location (i.e. the web browser you are downloading the app from).

• On devices running Android 7.1.1 (API level 25) and lower, you should enable the Unknown sources system setting, found in Settings > Security on your device.

Alternative Way

You can also install the Android App by directly downloading the APK and installing it on an Android device.

• Download APK
• Login: [e-mail]
• Password: B00kC4r5

Resources

1. Overview
2. Architecture
3. Installing
4. Installing on VPS
5. Setup Stripe
6. Docker
   1. Docker Image
   2. SSL
7. Build Mobile App
8. Demo Database
   1. Windows, Linux and macOS
   2. Docker
9. Run from Source
10. Run Mobile App
    1. Prerequisites
    2. Instructions
    3. Push Notifications
11. Change Currency
12. Add New Language
13. Unit Tests and Coverage
14. Logs

License

BookCars is MIT licensed.