<<<<<<< HEAD

bookcars-main

=======

BookCars

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. You can choose either to use Stripe or PayPal for payments. If Stripe isn't available in your country, simply check if PayPal is supported and use it as an alternative for smooth and secure payments.

With BookCars, you can deploy your own customizable car rental marketplace at minimal cost using the Docker-based setup. 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 or multi-supplier operations looking for a scalable and cost-effective solution. You can deploy it for under $5/month using cloud providers like Hetzner or DigitalOcean. <!-- BookCars is free and open source. You can customize it as you want and deploy it yourself by following the documentation. 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. 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.

When new suppliers are created, they receive an email prompting them to create an account in order to access the admin dashboard and manage their car fleets 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.

Features

• Supplier management
• Supplier contracts
• Ready for one or multiple suppliers
• Car fleet management
• Dynamic price calculation
• Date Based Price Rates
• Price Change Rate
• Location, country, parking spots and map features
• Booking management
• Vehicle scheduler
• Payment management
• Customer management
• Multiple login options (Google, Facebook, Apple, Email)
• Multiple payment methods (Credit Card, PayPal, Google Pay, Apple Pay, Link, Pay at the counter, Pay in full, Pay deposit)
• Multiple language support (English, French, Spanish)
• Multiple currencies support
• Multiple pagination options (Classic pagination with next and previous buttons, infinite scroll)
• Multiple Payment Gateways supported (Stripe, PayPal)
• Responsive admin dashboard and frontend
• Native Mobile app for Android and iOS with single codebase
• Push notifications
• Secure against XSS, XST, CSR, MITM and DDoS
• Supported Platforms: iOS, Android, Web, Docker

Live Demo

Frontend

• URL: https://bookcars.dynv6.net:3002/
• Login: jdoe@bookcars.ma
• Password: B00kC4r5

Admin Dashboard

• URL: https://bookcars.dynv6.net:3001/
• Login: admin@bookcars.ma
• 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 install the Android App by downloading the APK and installing it on any Android device.

• Download APK
• Login: jdoe@bookcars.ma
• Password: B00kC4r5

Documentation

1. Overview
2. Why Use BookCars
3. Architecture
4. Installing (Self-hosted)
5. Installing (Docker)
   1. Docker Image
   2. SSL
6. Payment Gateways
7. Setup Stripe
8. Build Mobile App
9. Demo Database
   1. Windows, Linux and macOS
   2. Docker
10. Run from Source
11. Run Mobile App
    1. Prerequisites
    2. Instructions
    3. Push Notifications
    4. Run iOS App
12. Add New Language
13. Add New Currency
14. Unit Tests and Coverage
15. Manual Tests
16. Price Calculation
    1. Pricing Fields
    2. Discounted Prices
    3. Date Based Price Rates
    4. Price Change Rate
    5. Calculation Algorithm
17. Supplier Contracts
18. Logs
19. FAQ

Support

If you find this project helpful, consider buying me a coffee.

License

BookCars is MIT licensed.

62c698c (Initial commit)