Skip to content

Commit

Permalink
Merge branch 'main' of https://github.com/aelassas/bookcars
Browse files Browse the repository at this point in the history
  • Loading branch information
aelassas committed Feb 5, 2025
2 parents e2ffd06 + f1f699f commit af0b993
Show file tree
Hide file tree
Showing 70 changed files with 904 additions and 610 deletions.
2 changes: 1 addition & 1 deletion CITATION.cff
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
cff-version: 1.2.0
message: "If you use BookCars in your research or projects, please cite it using the following metadata."
title: "BookCars: A Car Rental Booking System"
title: "BookCars: A Car Rental Booking Platform with Mobile App"
authors:
- name: "Akram El Assas"
year: 2025
Expand Down
15 changes: 8 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,12 +17,12 @@ https://github.com/user-attachments/assets/01afc5ec-3c0a-47b9-a4e1-3b8888b2a695

BookCars is a highly customizable, scalable, and cost-efficient solution for car rental businesses. Its robust feature set and open-source nature make it a sustainable choice for long-term growth in the rental industry.

BookCars integrates Stripe and PayPal [payment gateways](https://github.com/aelassas/bookcars/wiki/Supported-Payment-Gateways). You can choose either to use Stripe or PayPal for payments. If your country is not supported by [Stripe](https://stripe.com/global), you can check if it is supported by [PayPal](https://www.paypal.com/us/webapps/mpp/country-worldwide). And if so, you can use PayPal payment gateway instead of Stripe.
BookCars integrates Stripe and PayPal [payment gateways](https://github.com/aelassas/bookcars/wiki/Payment-Gateways). You can choose either to use Stripe or PayPal for payments. If your country is not supported by [Stripe](https://stripe.com/global), you can check if it is supported by [PayPal](https://www.paypal.com/us/webapps/mpp/country-worldwide). And if so, you can use PayPal payment gateway instead of Stripe.

With BookCars, you can deploy your own customizable car rental marketplace at minimal cost using the [Docker-based setup](https://github.com/aelassas/bookcars/wiki/Installing-(Docker)). The platform integrates Stripe and PayPal 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/month using cloud providers like [Hetzner](https://www.hetzner.com/cloud/) or [DigitalOcean](https://www.digitalocean.com/pricing/droplets).

<!--
BookCars is free and open source. You can customize it as you want and deploy it yourself by following the [documentation](https://github.com/aelassas/bookcars/wiki). If you want me to customize it and deploy it for you, contact me by email. You can find my email in my [GitHub profile page](https://github.com/aelassas). You need to be logged in to GitHub to view my email. I can deploy the platform to the cloud for you, configure your DNS, emailing, webmail and all related tasks.

-->
BookCars is designed to work with multiple suppliers. Suppliers can manage their car fleets and bookings from the admin dashboard. BookCars can also work with a single supplier and can be used as a car rental aggregator.

From the admin dashboard, admins can create and manage suppliers, cars, countries, locations, parking spots, customers, bookings and payments.
Expand Down Expand Up @@ -56,9 +56,9 @@ Customers can sign up from the frontend or the mobile app, search for available
* Supported Platforms: iOS, Android, Web, Docker

## Live Demo

<!--
Some features are locked down on the demo links provided. To unlock all the features contact me by email and I will you give a full access. You can find my email on my [GitHub](https://github.com/aelassas) profile page.

-->
### Frontend

* URL: https://bookcars.dynv6.net:3002/
Expand All @@ -79,7 +79,7 @@ You can install the Android app on any Android device.

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

![QR](https://bookcars.github.io/content/qr-code-5.4.png)
![QR](https://bookcars.github.io/content/qr-code-5.5.png)

#### How to install the Mobile App on Android

Expand All @@ -91,7 +91,7 @@ Open the Camera app and point it at this code. Then tap the notification that ap

You can install the Android App by downloading the APK and installing it on any Android device.

* [Download APK](https://github.com/aelassas/bookcars/releases/download/v5.4/bookcars-5.4.apk)
* [Download APK](https://github.com/aelassas/bookcars/releases/download/v5.5/bookcars-5.5.apk)
* Login: jdoe@bookcars.ma
* Password: B00kC4r5

Expand Down Expand Up @@ -124,6 +124,7 @@ You can install the Android App by downloading the APK and installing it on any
15. [Price Calculation](https://github.com/aelassas/bookcars/wiki/Price-Calculation)
16. [Supplier Contracts](https://github.com/aelassas/bookcars/wiki/Supplier-Contracts)
17. [Logs](https://github.com/aelassas/bookcars/wiki/Logs)
18. [FAQ](https://github.com/aelassas/bookcars/wiki/FAQ)

## License

Expand Down
20 changes: 10 additions & 10 deletions api/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 3 additions & 3 deletions api/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "api",
"version": "5.5.0",
"version": "5.6.0",
"description": "",
"main": "index.js",
"type": "module",
Expand Down Expand Up @@ -29,7 +29,7 @@
"@types/express": "^4.17.21",
"@types/jest": "^29.5.14",
"@types/multer": "^1.4.12",
"@types/node": "^22.12.0",
"@types/node": "^22.13.0",
"@types/nodemailer": "^6.4.17",
"@types/supertest": "^6.0.2",
"@types/validator": "^13.12.2",
Expand All @@ -50,7 +50,7 @@
"i18n-js": "^4.5.1",
"jest": "^29.7.0",
"jose": "^5.9.6",
"mongoose": "^8.9.5",
"mongoose": "^8.9.6",
"multer": "^1.4.5-lts.1",
"nanoid": "^5.0.9",
"nocache": "^4.0.0",
Expand Down
Loading

0 comments on commit af0b993

Please sign in to comment.