Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aelassas/bookcars
Car Rental Platform with Mobile App
https://github.com/aelassas/bookcars
aggregator car-rental car-rental-system expo mongodb react react-native stripe
Last synced: 3 months ago
JSON representation
Car Rental Platform with Mobile App
- Host: GitHub
- URL: https://github.com/aelassas/bookcars
- Owner: aelassas
- License: mit
- Created: 2022-04-20T21:56:03.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T08:58:03.000Z (3 months ago)
- Last Synced: 2024-10-29T10:06:12.973Z (3 months ago)
- Topics: aggregator, car-rental, car-rental-system, expo, mongodb, react, react-native, stripe
- Language: TypeScript
- Homepage: https://bookcars.github.io
- Size: 28.5 MB
- Stars: 317
- Watchers: 21
- Forks: 201
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/aelassas/bookcars/actions/workflows/build.yml) [](https://github.com/aelassas/bookcars/actions/workflows/test.yml) [](https://codecov.io/gh/aelassas/bookcars) [](https://github.com/aelassas/bookcars/wiki) [](https://bookcars.dynv6.net:3002/) [](https://github.com/aelassas/bookcars/actions/workflows/loc.yml)
## BookCars
BookCars is a car rental platform, supplier-oriented, with a backend for managing car fleets and bookings, as well as a frontend and a mobile app for renting cars.
Deploy your own customizable car rental solution at minimal cost using the [Docker-based setup](https://github.com/aelassas/bookcars/wiki/Installing-(Docker)). The platform integrates Stripe for secure payments and can be efficiently hosted on a 1GB RAM droplet, making it an ideal choice for single/multi-supplier operations looking for a scalable and cost-effective solution. You can deploy this solution for under $5 monthly using cloud providers like [Hetzner](https://www.hetzner.com/cloud/) or [DigitalOcean](https://www.digitalocean.com/pricing/droplets).
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 and can be used as a car rental aggregator.
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.
I invested significant time and effort into building this open-source project to make it freely available to the community. If this project has been helpful in your work, consider supporting its continued development and maintenance. You can contribute through [GitHub Sponsorship](https://github.com/sponsors/aelassas) (one-time or monthly), [PayPal](https://www.paypal.me/aelassaspp), or [Buy Me a Coffee](https://buymeacoffee.com/aelassas). Even a simple star on the GitHub repository helps spread the word and is greatly appreciated.
## Features
* Supplier management
* Ready for one or multiple suppliers
* Car fleet management
* Location, country, parking spots and map features
* Booking management
* Payment management
* Customer management
* Multiple payment methods (Credit Card, PayPal, Google Pay, Apple Pay, Link, Pay Later)
* Operational Stripe Payment Gateway
* Multiple language support (English, French, Spanish)
* 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.dynv6.net:3002/
* Login: [email protected]
* Password: B00kC4r5
### Backend
* URL: https://bookcars.dynv6.net:3001/
* Login: [email protected]
* 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 any Android device.
* [Download APK](https://github.com/aelassas/bookcars/releases/download/v4.3/bookcars-4.4.apk)
* Login: [email protected]
* Password: B00kC4r5
## Resources
1. [Overview](https://github.com/aelassas/bookcars/wiki/Overview)
2. [Architecture](https://github.com/aelassas/bookcars/wiki/Architecture)
3. [Installing (Self-hosted)](https://github.com/aelassas/bookcars/wiki/Installing-(Self%E2%80%90hosted))
4. [Installing (VPS)](https://github.com/aelassas/bookcars/wiki/Installing-(VPS))
5. [Installing (Docker)](https://github.com/aelassas/bookcars/wiki/Installing-(Docker))
1. [Docker Image](https://github.com/aelassas/bookcars/wiki/Installing-(Docker)#docker-image)
2. [SSL](https://github.com/aelassas/bookcars/wiki/Installing-(Docker)#ssl)
6. [Setup Stripe](https://github.com/aelassas/bookcars/wiki/Setup-Stripe)
7. [Build Mobile App](https://github.com/aelassas/bookcars/wiki/Build-Mobile-App)
8. [Demo Database](https://github.com/aelassas/bookcars/wiki/Demo-Database)
1. [Windows, Linux and macOS](https://github.com/aelassas/bookcars/wiki/Demo-Database#windows-linux-and-macos)
2. [Docker](https://github.com/aelassas/bookcars/wiki/Demo-Database#docker)
9. [Run from Source](https://github.com/aelassas/bookcars/wiki/Run-from-Source)
10. [Run Mobile App](https://github.com/aelassas/bookcars/wiki/Run-Mobile-App)
1. [Prerequisites](https://github.com/aelassas/bookcars/wiki/Run-Mobile-App#prerequisites)
2. [Instructions](https://github.com/aelassas/bookcars/wiki/Run-Mobile-App#instructions)
3. [Push Notifications](https://github.com/aelassas/bookcars/wiki/Run-Mobile-App#push-notifications)
11. [Change Currency](https://github.com/aelassas/bookcars/wiki/Change-Currency)
12. [Add New Language](https://github.com/aelassas/bookcars/wiki/Add-New-Language)
13. [Unit Tests and Coverage](https://github.com/aelassas/bookcars/wiki/Unit-Tests-and-Coverage)
14. [Logs](https://github.com/aelassas/bookcars/wiki/Logs)
## License
BookCars is [MIT licensed](https://github.com/aelassas/bookcars/blob/main/LICENSE).