info
What comes with Cabazzo
Customer Application, Driver Application, and Admin Panel — all included.
Introduction
Welcome to Cabazzo, a React Native–based mobile application designed for taxi and ride-hailing services. The platform supports multiple ride services and integrates with backend systems for real-time operations.
Applications
- Customer Application
- Driver Application
- Admin Panel
Key Capabilities
- Daily ride booking
- Rental ride services
- Intercity travel bookings
- Real-time driver tracking
- Firebase push notifications
- Razorpay payment integration
check_circle
White-Label Solution
The application is built as a white-label solution, allowing customization of branding, configuration, and backend services for each client.
Getting Started
warning
Third-Party Services Not Included
Cabazzo integrates with various third-party services to provide enhanced functionality. Please note that third-party services are not included in the base package and require separate paid subscriptions or licenses. These include but are not limited to:
- Map Services — Route planning, location tracking, and geocoding (e.g., Routemappy, Google Maps)
- Payment Gateways — Online payment processing and transaction handling (e.g., Stripe, Razorpay, PayPal)
- Push Notification Services — Real-time alerts and notifications (e.g., Firebase Cloud Messaging, OneSignal)
- Cloud Hosting & Storage — Server infrastructure, database hosting, and media storage (e.g., AWS, Google Cloud, Firebase)
- SMS & Email Services — Communication and verification services (e.g., Twilio, SendGrid)
Important: Clients are responsible for procuring and managing their own third-party service accounts and subscriptions. Cabazzo provides the integration framework only; service credentials, API keys, and associated costs are the client's responsibility.
lightbulb
Prerequisite Knowledge
Note: It's necessary to have a basic knowledge in both server side and mobile app
development.
Basic knowledge in mobile application and installation
Basic knowledge about Google Cloud and Firebase
hub Third Party Services
hub Third Party Services
Cabazzo integrates with several third-party services to provide functionality such as maps, notifications, authentication, email delivery, and payment processing. These services are not included with the purchase package and must be configured using your own accounts and credentials where applicable.
| Service | Purpose | Required |
|---|---|---|
| RouteMappy Maps | Maps, Routing, Address Search & Location Services | Yes |
| Firebase Cloud Messaging (FCM) | Push Notifications & Trip Alerts | Yes |
| Firebase Authentication | OTP Verification & Authentication (optional) | Optional |
| SMTP Mail Service | Email Notifications, Password Reset & Verification | Yes |
| Twilio SMS | SMS Notifications & OTP Delivery | Optional |
| Razorpay | Online Payment Processing | Optional |
map RouteMappy Maps
Cabazzo utilizes RouteMappy as its mapping and location service provider. RouteMappy offers customizable mapping capabilities including route calculation, address search, navigation support, service area management, and location-based functionality.
If you require RouteMappy Maps for your application, please contact the RouteMappy team directly.
- Website: https://routemappy.com/
- Email: sales@menpanitech.com
info
Note:
RouteMappy is a paid map service that requires a
separate subscription or license.
cloud Firebase Services
Cabazzo uses Google Firebase for push notifications (FCM), authentication, and real-time database features. A Firebase project is required to enable these features.
- Website: https://firebase.google.com/
- Pricing: Free tier available with paid upgrades for higher usage
payments Payment Gateways
Cabazzo supports multiple payment gateways for online payments. Choose one or more based on your business requirements and region.
warning Important Notice
API keys, payment gateway accounts, SMS credits, email service providers, hosting services, domain registration, SSL certificates, and RouteMappy subscriptions or licensing fees are not included with the purchase package. Buyers are responsible for creating and maintaining their own third-party service accounts and subscriptions where applicable.
dns Environmental Setup
verified Version Requirements
Ensure the following software versions are installed before proceeding:
Backend Requirements
- PHP: 8.1 or higher
- Laravel: 10.x or later
- MySQL: 5.7 or higher
- Composer: 2.5 or later
- Apache/Nginx: Latest stable version
Frontend Requirements
- Node.js: 22.x(LTS)
- npm: 8.x or later
- React: 18.x
- React Native: 0.84.1.x
Android Development
- Android Studio: Latest stable version
- Java JDK: 17
- Android SDK: API Level 35
- Build Tools: Latest version
iOS Development (macOS only)
- Xcode: 14.x or later (from Mac App Store)
- iOS SDK: iOS 16+
- CocoaPods: 1.12.x or later
- macOS: Monterey or later
- Apple Developer Account: Required for distribution ($99/year)
warning
Important:
Using older versions may cause compatibility issues. Always use the
recommended versions.
System Requirements
Operating System:
- Windows 10/11 (64-bit)
- macOS Monterey or later
- Linux (Ubuntu 20.04+ or equivalent)
Minimum Hardware:
- Processor: Intel i5 (or AMD equivalent)
- RAM: 8 GB (minimum), 16 GB recommended
- Storage: 500 MB–2 GB of free disk space for dependencies and build files
- Internet: Broadband connection required for downloading dependencies
Software Requirements
| Tool | Version | Notes |
|---|---|---|
| Node.js | v22.x(LTS) | Required to run React and npm scripts |
| npm | v8.x or later | Comes with Node.js |
| Git | Optional | Recommended for version control and some setups |
| Code Editor | VS Code (recommended) | For editing and running code |
| Browser | Latest Chrome, Firefox, or Edge | For testing the app |
XAMPP Installation
- Download XAMPP from apachefriends.org
- Install XAMPP on your system
- After installation, start Apache and MySQL servers from the XAMPP control panel
info
Alternative Local Servers:
- Laragon (Windows) - Faster and lighter alternative
- MAMP (macOS/Windows) - Easy to use
- Docker (All platforms) - Containerized environment
- Valet (macOS) - Laravel native development
Composer Installation
- Download Composer from getcomposer.org
- Install Composer on your system
terminal
Verify Your Installation
Run these commands in your terminal/command prompt to confirm all required tools are properly installed:
# Check Node.js version
node --version # Should show v22.x
# Check npm version
npm --version # Should show 8.x or higher
# Check PHP version
php --version # Should show 8.1 or higher
# Check Composer version
composer --version # Should show 2.5 or higher
# Check MySQL version
mysql --version # Should show 5.7 or higher
check_circle
Success Indicator:
If all commands show the correct versions (or higher), your environment is ready for installation.
error
Troubleshooting:
If any command returns "not found" or shows an older version, please install or update the corresponding software before proceeding.
memory Technology Stack
Complete Technology Stack
Cabazzo is built using modern and scalable technologies to power customer applications, driver applications, and administrative operations.
code Core Technology Versions
Before installing and running the application, ensure the following technologies and tools are installed with the recommended versions.
React Native
0.84.1
React
18.3.1
Node.js
22+
PHP
8.1+
Gradle
8.7.2
Kotlin
2.0.21
Android SDK
35
Android Build Tools
35.0.0
Min Android SDK
24
Target Android SDK
35
Android NDK
27.1.12297006
Java JDK
17
iOS Deployment Target
iOS 13+
JavaScript Engine
Hermes
| Category | Technology | Version | Purpose |
|---|---|---|---|
| Mobile Applications (Customer & Driver) | |||
| Framework | React Native | 0.84.1 | Cross-Platform Mobile Development |
| UI Library | React | 18.3.1 | Application User Interface |
| Navigation | React Navigation | Latest | Screen Navigation |
| State Management | Redux Toolkit | Latest | Application State Management |
| HTTP Client | Axios | Latest | API Communication |
| JavaScript Engine | Hermes | Latest | Performance Optimization |
| Filament Admin Panel | |||
| Framework | Laravel Filament | 3.x | Admin Dashboard & Panel |
| Backend | Laravel | 10.x or 11.x | Server-Side Framework |
| PHP | PHP | 8.1 or higher | Server-Side Language |
| Database | MySQL | 5.7 or higher | Data Storage |
| Dependency Manager | Composer | 2.x+ | PHP Package Management |
| HTTP Client | Guzzle HTTP | Latest | External API Communication |
| Firebase SDK | Kreait Firebase PHP | Latest | Firebase Services Integration |
| SMS Gateway | Twilio SDK | Latest | SMS & OTP Services |
| Android Development Environment | |||
| Node.js | Node.js | 22 | JavaScript Runtime |
| Android SDK | Android SDK | 35 | Android Development Platform |
| Build Tools | Android Build Tools | 35.0.0 | Application Compilation |
| Minimum SDK | Android SDK | 24 | Minimum Supported Android Version |
| Target SDK | Android SDK | 35 | Target Android Version |
| Gradle | Gradle | 8.7.2 | Build Automation |
| Kotlin | Kotlin | 2.0.21 | Android Native Support |
| Android NDK | NDK | 27.1.12297006 | Native Library Support |
| Java | JDK | 17 (Recommended) | Android Development Environment |
| iOS Development Environment | |||
| iOS Deployment Target | iOS | 13+ | Minimum Supported iOS Version |
| Xcode | Xcode | Latest | iOS Development Environment |
| CocoaPods | CocoaPods | Latest | iOS Dependency Management |
| Third-Party Integrations | |||
| Push Notifications | Firebase Cloud Messaging | Latest | Real-Time Notifications |
| Authentication | Firebase Authentication | Latest | OTP Verification |
| Storage | Firebase Storage | Latest | Image & Document Uploads |
| Payment Gateway | Razorpay | Latest | Online Payment Processing |
| Maps & Location | RouteMappy | Latest | Location Services & Navigation |
Hosting & Production Server Requirements
- Apache 2.4+ or Nginx 1.18+
- PHP 8.1 or Higher
- MySQL 5.7+
- SSL Certificate (HTTPS) Recommended
- Cron Job Support
- Minimum 4 GB RAM (8 GB Recommended)
- Minimum 10 GB Available Storage
Important:
Shared hosting, VPS, cloud servers, and dedicated servers are supported as long as the above
requirements are met.
warning
Third-Party Services Not Included
Cabazzo integrates with various third-party services that require separate paid subscriptions. These include:
- Firebase Services — Push notifications, authentication, storage (paid beyond free tier)
- Payment Gateways — Razorpay for online payments
- Map Services — RouteMappy for location tracking and navigation
- SMS Services — Twilio or similar for OTP and notifications
- Cloud Hosting — AWS, Google Cloud, or other hosting providers
Important: Clients are responsible for procuring and managing their own third-party service accounts, API keys, and subscriptions.
info
Important Note
Install all required SDKs, development tools, and dependencies using the recommended versions before beginning the installation process. Version mismatches may result in build or runtime issues.
Pro Tip: Use Node Version Manager (NVM) for Node.js version management and Android Studio SDK Manager for maintaining Android SDK compatibility.
view_module Project Dependencies
Project Dependencies Overview
Cabazzo consists of two mobile applications:
person
Customer App
For end-users to book taxi rides
directions_car
Driver App
For drivers to accept and manage trips
info
Common Base Version: React Native 0.84.1 with React 19.2.3
Node Engine: >= 22.11.0
Core Libraries
These libraries provide the core framework functionality and handle state management, API communication, and date processing.
| Package | Version | Customer | Driver | Purpose |
|---|---|---|---|---|
| react | 19.2.3 | check_circle | check_circle | UI Library |
| react-native | 0.84.1 | check_circle | check_circle | Cross-platform mobile framework |
| axios | ^1.13.6 | check_circle | check_circle | HTTP client for API calls |
| zustand | ^5.0.11 | check_circle | check_circle | State management |
| moment | ^2.30.1 | check_circle | check_circle | Date and time formatting |
| i18next | ^25.8.13 | check_circle | check_circle | Internationalization |
| react-i18next | ^16.5.4 | check_circle | check_circle | React i18next integration |
| libphonenumber-js | ^1.12.38 | check_circle | check_circle | Phone number validation |
Navigation Libraries
These libraries handle screen navigation, routing, and tab management within the applications.
| Package | Version | Customer | Driver | Purpose |
|---|---|---|---|---|
| @react-navigation/native | ^7.1.31 | check_circle | check_circle | Core navigation library |
| @react-navigation/native-stack | ^7.14.2 | check_circle | check_circle | Stack navigation |
| @react-navigation/bottom-tabs | ^7.15.3 | check_circle | check_circle | Bottom tab navigation |
| react-native-screens | ^4.15.0 | check_circle | check_circle | Native screen optimization |
| react-native-safe-area-context | ^5.5.2 | check_circle | check_circle | Safe area handling |
| react-native-gesture-handler | ^2.30.0 | check_circle | check_circle | Gesture-based interactions |
Maps and Location
These libraries enable map rendering and location tracking within the application.
| Package | Version | Customer | Driver | Purpose |
|---|---|---|---|---|
| @maplibre/maplibre-react-native | ^11.2.1 | check_circle | check_circle | Map rendering (MapLibre GL) |
| react-native-maps | ^1.26.1 | check_circle | cancel | Alternative map component (Customer only) |
| @react-native-community/geolocation | ^3.4.0 | check_circle | check_circle | GPS location services |
| @turf/invariant | ^7.3.4 | check_circle | cancel | Geospatial utilities (Customer only) |
| geofire-common | ^6.0.0 | check_circle | cancel | Geo-location queries (Customer only) |
Firebase Services
Firebase is integrated to support real-time notifications, trip alerts, and data synchronization.
| Package | Version | Customer | Driver | Purpose |
|---|---|---|---|---|
| @react-native-firebase/app | ^23.8.6 | check_circle | check_circle | Firebase core |
| @react-native-firebase/database | ^23.8.6 | check_circle | check_circle | Real-time database |
| @react-native-firebase/messaging | ^23.8.6 | check_circle | check_circle | Push notifications (FCM) |
| @notifee/react-native | ^9.1.8 | check_circle | check_circle | Enhanced local notifications |
UI and Animation Libraries
These libraries enhance the user interface and animation experience.
| Package | Version | Customer | Driver | Purpose |
|---|---|---|---|---|
| lottie-react-native | ^7.3.6 | check_circle | check_circle | Animated illustrations |
| react-native-haptic-feedback | ^2.3.3 | check_circle | check_circle | Device vibration/haptic feedback |
| react-native-toast-message | ^2.3.3 | check_circle | check_circle | Toast notification messages |
| react-native-svg | ^15.15.3 | cancel | check_circle | SVG rendering (Driver only) |
| react-native-countdown-circle-timer | ^3.2.1 | cancel | check_circle | Countdown timer (Driver only) |
| react-native-chart-kit | ^6.12.0 | cancel | check_circle | Charts for earnings (Driver only) |
| react-native-video | ^6.11.0 | cancel | check_circle | Video playback (Driver only) |
| react-native-video-controls | ^2.8.1 | cancel | check_circle | Video controls (Driver only) |
Icon Libraries
Icon libraries used across the applications.
| Package | Version | Customer | Driver | Purpose |
|---|---|---|---|---|
| @react-native-vector-icons/fontawesome | ^12.4.1 | check_circle | check_circle | FontAwesome icons |
| @react-native-vector-icons/ionicons | ^12.4.1 | check_circle | check_circle | Ionicons |
| @react-native-vector-icons/material-icons | ^12.4.1 | check_circle | check_circle | Material icons |
Device Features
These libraries enable the application to interact with native device capabilities.
| Package | Version | Customer | Driver | Purpose |
|---|---|---|---|---|
| react-native-image-picker | ^8.2.1 | check_circle | check_circle | Image selection from camera/gallery |
| react-native-fs | ^2.20.0 | check_circle | check_circle | File system access |
| react-native-device-info | ^15.0.2 | check_circle | cancel | Device information (Customer only) |
| react-native-sound | ^0.13.0 | check_circle | check_circle | Audio playback |
| @react-native-async-storage/async-storage | ^2.2.0 | check_circle | check_circle | Local data persistence |
| @react-native-community/netinfo | ^12.0.1 | check_circle | check_circle | Network connectivity monitoring |
| react-native-restart | ^0.0.27 | check_circle | check_circle | App restart functionality |
| react-native-webview | ^13.16.1 | check_circle | check_circle | Web content rendering |
| react-native-contacts | ^8.0.10 | check_circle | cancel | Contacts access (Customer only) |
| react-native-eject | ^1.0.2 | check_circle | check_circle | Eject utility |
Date and Time
These libraries handle date/time selection and calendar functionality.
| Package | Version | Customer | Driver | Purpose |
|---|---|---|---|---|
| react-native-date-picker | ^5.0.13 | check_circle | check_circle | Date/time picker component |
| react-native-calendars | ^1.1311.0 | cancel | check_circle | Calendar component (Driver only) |
Payment Integration
The application integrates payment gateways to support secure online transactions.
| Package | Version | Customer | Driver | Purpose |
|---|---|---|---|---|
| react-native-razorpay | ^2.3.1 | check_circle | check_circle | Razorpay payment gateway |
Background Services
These libraries enable background processing and timer functionality.
| Package | Version | Customer | Driver | Purpose |
|---|---|---|---|---|
| react-native-background-timer | ^2.4.1 | cancel | check_circle | Background timer for trip tracking (Driver only) |
Customer-Only Libraries
These libraries are specific to the Customer application.
| Package | Version | Purpose |
|---|---|---|
| @react-native-community/template | ^0.84.1 | React Native template |
| @react-native/new-app-screen | 0.84.1 | New app screen component |
| @turf/invariant | ^7.3.4 | Geospatial utilities |
| geofire-common | ^6.0.0 | Geo-location queries |
| react-native-contacts | ^8.0.10 | Contacts access |
| react-native-device-info | ^15.0.2 | Device information |
| react-native-maps | ^1.26.1 | Alternative map component |
Driver-Only Libraries
These libraries are specific to the Driver application.
| Package | Version | Purpose |
|---|---|---|
| react-native-background-timer | ^2.4.1 | Background timer for trip tracking |
| react-native-calendars | ^1.1311.0 | Calendar component for scheduling |
| react-native-chart-kit | ^6.12.0 | Charts for earnings analytics |
| react-native-countdown-circle-timer | ^3.2.1 | Countdown timer for trip waiting |
| react-native-svg | ^15.15.3 | SVG rendering |
| react-native-video | ^6.11.0 | Video playback |
| react-native-video-controls | ^2.8.1 | Video controls |
Dependency Summary
person
Customer App:
- Total Dependencies: 45 packages
- Unique Libraries: 7 customer-only
- Shared Libraries: 38 packages
- Base Version: React Native 0.84.1
- Node Engine: >= 22.11.0
- Overrides: fast-xml-parser ^5.5.6
directions_car
Driver App:
- Total Dependencies: 41 packages
- Unique Libraries: 7 driver-only
- Shared Libraries: 34 packages
- Base Version: React Native 0.84.1
- Node Engine: >= 22.11.0
- Android Package: com.cabazzo.driver
check_circle
Shared Libraries
person
Customer Only
directions_car
Driver Only
person Customer Application Guide
How Customers Use the Application
1
Register / Login with OTP Verification
- Download the Cabazzo Customer App
- Tap "Sign Up" and enter your mobile number – an OTP will be sent
- Verify the OTP, then fill in full name, email, password (and confirm password)
- For login, enter your mobile number and password, or use OTP login
2
Select Trip Type
- Daily Ride – point-to-point city rides
- Rental Ride – hourly packages
- Outstation Ride – intercity one-way or round trips
- Delivery Trip – on-demand parcel and package delivery services
3
Choose Pickup & Drop Locations
- Google / RouteMappy Map Integration – interactive map for location selection
- Location Search & Auto Suggestions – type any address or landmark
- Pickup location is automatically detected via GPS; you can change both pickup and drop
4
Dynamic Fare Calculation
- Distance-based fare calculated automatically
- Trip-type based pricing (Daily, Rental, Outstation)
- Tax & surcharge applied transparently
- Fare estimate is displayed before confirming
5
Select Available Vehicle Type
- Mini
- Sedan
- SUV
- Luxury (optional, if enabled)
- The app shows estimated arrival time and vehicle options
6
Place Booking Request
- Confirm your booking – the request is sent to nearby drivers
- Nearby drivers receive the booking and can accept
- Once a driver accepts, you receive driver details (name, vehicle, rating)
7
Trip Start OTP Verification
- When the driver arrives, a unique OTP is shown in your app
- Share the OTP with the driver – they enter it to start the trip
- Ensures the right driver picks you up
8
Live Driver Tracking with Polyline Route
- See the driver’s live location and the exact route on the map
- Real‑time ETA updates throughout the trip
9
Trip Completion
- Upon reaching the destination, the driver marks the trip as Completed
- A digital receipt is generated with:
- Fare breakdown (base, distance, taxes)
- Payment summary
- Payment is processed automatically via the selected method
10
My Bookings
- Upcoming Trips – scheduled future rides
- Ongoing Trips – current active ride
- Completed Trips – ride history
- Cancelled Trips – cancelled bookings
11
Wallet Management
- Wallet Balance – view current balance
- Top‑Up – add money via integrated payment gateways
- Transaction History – list of all wallet credits/debits
12
Profile & Settings
- Personal Details – edit name, photo, phone number
- Language & App Preferences – change language, notification settings
lightbulb
Pro Tip: Keep your pickup location accurate – the app uses your
live GPS for faster driver assignment. Enable notifications to receive real‑time trip updates.
build Driver Application Guide
Driver App Workflow
1
Register with Documents
- Download and install the Cabazzo Driver App
- Tap "Register as Driver" and upload the required KYC documents:
- Driving License
- Vehicle RC
- Insurance
- Profile Photo
- Other KYC Documents (Aadhaar, PAN, etc.)
- Submit for admin verification; once approved, your account is active
2
Login with OTP Verification
- Open the app and enter your registered mobile number
- Verify the OTP sent to your number
- Set a password for future logins (optional)
3
Go Online / Offline
- Use the online/offline toggle on the home screen
- When online, you become visible to customers and can receive booking requests
- Select your preferred trip types (Daily, Rental, Outstation) to filter incoming requests
4
Receive Booking Requests
- Daily Trips – point‑to‑point city rides
- Rental Trips – hourly package rides
- Outstation Trips – long‑distance intercity rides
- Each request shows pickup location, fare estimate, and trip distance
5
Accept or Reject Booking
- Review the trip details – pickup location, fare, distance
- Tap "Accept" to take the trip or "Reject" if not convenient
- Once accepted, you must navigate to the pickup point
6
Navigate to Pickup Location
- In‑app navigation with polyline route to the customer’s pickup point
- Real‑time GPS tracking helps you reach quickly
7
Start Trip Using Customer OTP
- Ask the customer for the OTP displayed in their app
- Enter the OTP in your driver app – this starts the trip and the billing
8
Live Polyline Route Tracking
- The map shows the full route with a polyline overlay
- Both you and the customer can track the journey in real time
9
Complete Trip
- At the destination, tap "End Trip"
- A receipt and fare summary are automatically generated
- Fare includes:
- Base fare
- Distance fare
- Rental / Outstation charges (if applicable)
- Tax & commission
10
My Bookings
- Accepted Trips – upcoming or ongoing rides
- Completed Trips – ride history
- Cancelled Trips – trips you cancelled
11
Wallet & Earnings
- Current Balance – total available balance
- Daily Earnings – earnings from today
- Weekly / Monthly Earnings – aggregated reports
- Transaction History – every credit and debit
12
Withdrawal Request
- Request payout of your earnings
- Track withdrawal status (Pending, Approved, Paid)
- Bank account details are required for processing
13
Profile Management
- Personal details – name, photo, contact
- Vehicle details – model, number, RC
- Document updates – renew expired documents
- Bank account details – for withdrawals
info
Note: Always keep the driver app online to receive trip alerts.
Maintain high service standards for better ratings and more trips.
admin_panel_settings Admin Panel Guide
Admin Panel Overview
The Cabazzo Admin Panel provides complete control over the platform. Below is the detailed menu structure and functionality.
| Menu Section | Sub-Menu Items | Fields / Functionality |
|---|---|---|
| Dashboard | ||
| Dashboard | - | Overview of platform analytics, active trips, revenue, and key metrics |
| Driver Subscriptions | ||
| Driver Subscriptions | Search, New | ID, Driver, Subscription Plan, Purchase Date, End Date, Price, Status |
| Subscription Plans | Search, New | ID, Plan Name, Days Count, Price, Status |
| Bookings / Trips | ||
| Trips | Search | ID, Trip ID, Customer Name, Driver Name, Vehicle Number, Payment Method, Promo Code, Surge, Sub Total, Discount, Total Fare, Cancellation Reason, Status |
| Trip Requests | Search | ID, Customer Name, Distance, Vehicle Type, Pickup Address, Drop Address, Payment Method, Surge, Total, Sub Total, Promo, Discount, Tax, Status |
| Trip Types | Search, New | ID, Active Icon, Inactive Icon, Name, Vehicle Mode, Status |
| Trip Sub Types | Search, New | ID, Trip Type, Trip Sub Type |
| Booking Statuses | Search | ID, Status Name, Customer Status Name |
| Trip Request Statuses | Search | ID, Status |
| Stops | Search | ID, Trip Request ID, Trip ID, Address, Latitude, Longitude, Status |
| Cancellation Reasons | Search, New | ID, Reason, Type |
| Customers | ||
| Customers | Search, New | ID, First Name, Last Name, Country Code, Phone Number, Email Address, Profile Picture, Gender, Status |
| Customer Sos Contacts | Search | ID, Customers, Name, Phone Number, Status |
| Customer Wallet Histories | Search | ID, Customers, Type, Message, Amount, Transaction Type |
| Customer Favourites | Search | ID, Customers, Address, Latitude, Longitude |
| Drivers | ||
| Driver Trip Requests | Search | ID, Driver, Trip Request ID, Status |
| Drivers | Search, New | ID, First Name, Last Name, Phone Number, Phone With Code, Email Address, Profile Picture, Date of Birth, GTH Location, GTH Status, Address, Licence Number, ID Proof Status, Online Status, Wallet, Overall Ratings, Number of Ratings, Shared Ride Status, Daily Ride Status, Rental Ride Status, Outstation Ride Status, Driver Hiring Status, Status |
| Driver Vehicles | Search, New | ID, Driver, Vehicle Type, Brand, Color, Vehicle Name, Vehicle Number, Vehicle Image, Vehicle Image Status, Vehicle Certificate Status, Vehicle Insurance Status, Vehicle Insurance, Status |
| Driver Tips | Search | ID, Customers, Driver, Trip ID, Tip Mode, Tip |
| Driver Earnings | Search | ID, Trip ID, Driver Name, Amount |
| Driver Recharges | Search | ID, Driver, Amount |
| Driver Withdrawals | Search | ID, Driver, Amount, Reference Proof, Reference No, Status |
| Driver Bank Kyc Details | Search, New | ID, Driver, Bank Name, Bank Account Number, IFSC Code, Aadhar Number, PAN Number, Status |
| Driver Tutorials | Search, New | ID, Title, Description, Thumbnail Image, Status, File |
| Services | ||
| Our Services | Search, New | ID, Title, Icon |
| Zones | Search, New | ID, Zone, Zone (Arabic), Polygon, View Polygon |
| Fares / Packages | ||
| Daily Fare Managements | Search, New | ID, Vehicle Type, Base Fare, Price Per Km, Status |
| Packages | Search, New | ID, Package Name, Hours, Kilometers |
| Rental Fare Managements | Search, New | ID, Vehicle Type, Package, Price Per Km, Price Per Hour, Package Price, Status |
| Outstation Fare Managements | Search, New | ID, Vehicle Type, Trip Sub Type, Base Fare, Price Per Km, Driver Allowance, Status |
| Delivery Fare Managements | Search, New | ID, Vehicle Type, Trip Sub Type, Base Fare, Price Per Km, Driver Allowance, Status |
| Shared Fare Managements | Search, New | ID, Vehicle Type, Base Fare, Price Per Km, Status |
| Complaints | ||
| Complaint Categories | Search, New | ID, Complaint Category, Status |
| Complaints | Search | ID, Trip ID, Customer, Driver, Complaint Category, Complaint Sub Category, Subject, Status |
| Complaint Sub Categories | Search, New | ID, Complaint Category, Complaint Sub Category, Short Description, Status |
| Payment Methods | ||
| Payment Methods | Search, New | ID, Payment, Payment Type, Icon, Status |
| Payment Types | Search | ID, Payment Type, Status |
| Payment Histories | Search | ID, Trip ID, Mode, Amount |
| Vehicle Management | ||
| Vehicle Categories | Search, New | ID, Vehicle Type, Vehicle Mode, Vehicle Slug, Active Icon, InActive Icon, Status |
| Vehicle Slugs | Search | ID, Slug |
| Tax Lists | Search, New | ID, Tax Name, Percent, Status |
| Settings | ||
| Map Settings | View, Edit | Map Provider Settings, Map Tiles, Routing, Places, Geocode, Reverse Geocode |
| App Versions | Search, New | ID, Platform, Version Number, Version Code |
| App Settings | View, Edit | App Name, App Version, Driver App Version, Default Currency, Default Currency Symbol, Currency Short Code, Default Country, Phone Code, Logo, Referral Amount, Driver Referral Amount, Language Status, Default Language, Subscription Status, Polyline Status, Driver Trip Time, Capital Latitude, Capital Longitude, About Us |
| Trip Settings | Edit | Commission Settings, Maximum Searching Time, Booking Searching Radius, GTH Searching Radius, Admin Commission (%), Waiting Min Timing, Night Fare Start Time, Night Fare End Time |
| Contact Settings | Edit | Phone Number, Email Address, Latitude, Longitude, Address |
| Shared Trip Settings | Edit | Pickup Radius, Drop Radius, Maximum Bookings |
| Operations | ||
| Notification Messages | Search, New | ID, Type, Title, Status |
| User Types | Search | ID, Type Name |
| Filament Shield | ||
| Roles | Search, New Role | Name, Guard Name, Permissions |
| Roles & Permissions | - | Assign granular permissions to each role |
| Users | Search, New User | Name, Email Address, Email Verified At |
| Promotions / Policies | ||
| Promo Codes | Search, New | ID, Customer, Promo Name, Promo Code, Promo Type, Discount, Min Fare, Max Discount Value, Redemptions, Status |
| Statuses | Search | ID, Status Type, Status Name |
| Privacy Policies | Search, New | ID, Slug, Title, Type, Status |
| Term Conditions | Search, New | ID, Title, Status |
| Testimonials | Search, New | ID, Name, Avatar, Role |
admin_panel_settings
Access URL:
http://yourdomain.com/admin
Default Credentials: admin@gmail.com / admin
warning
Security Note: Change default admin password
immediately after first login!
android Android Configuration
Build Configuration
File Location: android/build.gradle
| Configuration | Value |
|---|---|
| Build Tools Version | 35.0.0 |
| Minimum SDK Version | 24 |
| Compile SDK Version | 35 |
| Target SDK Version | 35 |
| Android NDK Version | 27.1.12297006 |
| Kotlin Version | 2.0.21 |
Gradle Plugin Configuration
Gradle Plugins
classpath("com.android.tools.build:gradle:8.7.2")
classpath("com.facebook.react:react-native-gradle-plugin")
classpath("org.jetbrains.kotlin:kotlin-gradle-plugin")
classpath 'com.google.gms:google-services:4.4.2'
admin_panel_settings Admin Configuration
info
PHP Version Requirement
This admin panel requires PHP 8.4. Please ensure you have the correct version installed before proceeding.
php --version # Should show PHP 8.4.x
Installation Steps
-
1
Unzip the Source Folder
Extract the downloaded source files to your working directory.
-
2
Copy to XAMPP
Copy the admin folder and paste it inside
XAMPP → htdocs. Rename your project folder (e.g., cabazzo_admin).infoVerify XAMPP & Composer: Ensure XAMPP and Composer are already installed. If not, download them from apachefriends.org and getcomposer.org. -
3
Open Command Prompt
Navigate to your project folder:
cd C:\xampp\htdocs\cabazzo_admin -
4
Install Dependencies
Run the following command to install all PHP dependencies:
composer installWhen finished, verify the
vendorfolder has been created in your project. -
5
Create Database
Follow these steps in phpMyAdmin:
- Open
http://localhost/phpmyadminin your browser - Click "New"
- Enter your database name (e.g.,
cabazzo_admin) - Click "Create"
- Open
-
6
Import Database
Import the SQL file located at
admin/db_file/cabazzo_admin.sqlusing phpMyAdmin:- In phpMyAdmin, select your newly created database
- Click the "Import" tab
- Choose the
cabazzo_admin.sqlfile from your project - Click "Go"
-
7
Generate Application Key
Run the following command to generate a unique application key:
php artisan key:generateinfoKey Generate: This command generates a unique application key that is used for encryption and security purposes. -
8
Configure .env File
If
.envfile is not visible, enable "show hidden files" in your system settings. Update the.envfile in your project root with the following settings:Application Settings
APP_URL=ENTER_YOUR_URL_HERE APP_ASSET_URL=ENTER_YOUR_URL_HERE/public/upload APP_ENV=production APP_DEBUG=falseDatabase Configuration
DB_DATABASE=your_database_name DB_USERNAME=your_db_username DB_PASSWORD=your_db_passwordTwilio SMS Settings
TWILIO_SID=your_twilio_sid TWILIO_TOKEN=your_twilio_token TWILIO_FROM=your_twilio_numberRazorpay Payment Gateway
RAZORPAY_KEY=your_razorpay_key RAZORPAY_SECRET=your_razorpay_secretFirebase Configuration
Firebase is required for push notifications, real-time database features, and other Firebase services. Before using the application, configure your own Firebase project.
Step 1: Download Firebase Service Account
- Open the Firebase Console.
- Select your Firebase Project.
- Go to Project Settings → Service Accounts.
- Click "Generate New Private Key".
- A JSON file will be downloaded (Example:
your-app-name-firebase-adminsdk.json).
Step 2: Upload the JSON File
Copy the downloaded Firebase JSON file into the following directory:
Admin/config/your-app-name.jsonStep 3: Update the .env File
FIREBASE_FILE=your-app-name.json FIREBASE_DB=https://your-project.firebaseio.com FCM_SERVER_KEY=your_fcm_server_key FCM_SENDER_ID=your_fcm_sender_idcheck_circleFirebase Connected
Once the JSON file is uploaded and the
.envvalues are updated, the application will automatically connect to your Firebase project.shieldSecurity Notice
Never share your Firebase Service Account JSON file or upload it to a public Git repository. This file contains sensitive credentials with administrative access to your Firebase project.
warningImportant: Replace all placeholder values with your actual credentials before running the application.
-
9
Run Migrations
Run the following command to create the database tables:
php artisan migrate -
10
Seed the Database
Run the following command to seed the database with default data:
php artisan db:seed --forceinfoThe--forceflag is used to run the seeder in production environments. For local development, you can omit it. -
11
Generate Shield Permissions
Run the following command to generate all Shield permissions:
php artisan shield:generate --all --option=permissions --panel=adminAfter generating permissions, run this command to assign the super admin role to your admin user:
php artisan tinker --execute=" \$role = DB::table('roles')->where('name','super_admin')->first(); \$perms = DB::table('permissions')->pluck('id')->toArray(); \$rows = array_map(fn(\$id) => ['permission_id'=>\$id,'role_id'=>\$role->id], \$perms); DB::table('role_has_permissions')->insertOrIgnore(\$rows); DB::table('model_has_roles')->insertOrIgnore(['role_id'=>1,'model_type'=>'App\\\Models\\\User','model_id'=>1]); echo 'Done: Admin assigned to super_admin role'; "infoShield: This generates all necessary permissions and assigns the super_admin role to the admin user (ID: 1). -
12
Optimize the Application
Run the following command to optimize the application for production:
php artisan optimize -
13
Serve Application
php artisan serveThe application will be available at
http://127.0.0.1:8000 -
14
Access Admin Panel
Open
http://127.0.0.1:8000in your browser.infoDemo Mode: The admin panel opens in demo mode by default. For full access, setAPP_ENV=productionandAPP_DEBUG=falsein your.envfile.
terminal Quick Command Reference
Run these commands in sequence to set up your admin panel:
# Step 1: Install dependencies
composer install
# Step 2: Generate application key
php artisan key:generate
# Step 3: Run migrations
php artisan migrate
# Step 4: Seed the database
php artisan db:seed --force
# Step 5: Optimize the application
php artisan optimize
# Step 6: Generate Shield permissions
php artisan shield:generate --all --option=permissions --panel=admin
# Step 7: Assign super admin role to admin user
php artisan tinker --execute="
\$role = DB::table('roles')->where('name','super_admin')->first();
\$perms = DB::table('permissions')->pluck('id')->toArray();
\$rows = array_map(fn(\$id) => ['permission_id'=>\$id,'role_id'=>\$role->id], \$perms);
DB::table('role_has_permissions')->insertOrIgnore(\$rows);
DB::table('model_has_roles')->insertOrIgnore(['role_id'=>1,'model_type'=>'App\\\Models\\\User','model_id'=>1]);
echo 'Done: Admin assigned to super_admin role';
"
# Step 8: Start the server
php artisan serve
Login Credentials
Use these default credentials to log in to the admin panel:
| Email: | admin@gmail.com |
| Password: | admin |
| Access Level: | Super Administrator |
shield
Security Alert: Change these credentials immediately after first login.
phone_android Mobile App Configuration
Step 1: Install Node.js
Download and install Node.js from your browser by visiting the official website: https://nodejs.org/en/download
# Verify Node.js installation
node -v
npm -v
Step 2: Install Android Studio
Download and install Android Studio on your system from: https://developer.android.com/studio
Customer App Configuration
Step 1: Copy App Folder
Copy the customer folder and paste it into your desired
location.
info
Note: If you rename the app folder, you must update the bundle ID.
Step 2: Change the Bundle ID
For Android, open:
folder_open Cabazzo_customer/android/app/src/main/AndroidManifest.xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.Cabazzo.customer">
...
</manifest>
Change the package attribute to your new bundle ID, for
example:
package="com.mycompany.mycustomerapp"
For iOS, open:
folder_open ios/CustomerApp.xcodeproj
Update the Bundle Identifier under the app's target settings in Xcode.
check_circle
The bundle ID for the Cabazzo Customer app has been successfully updated in your system. Follow the same process for other applications.
app_registration App Name & Icon
Changing App Name
folder_open Cabazzo/android/app/src/main/res/values/strings.xml
<!-- In strings.xml -->
<string name="app_name">Your App Name</string>
Changing App Icon
- Replace all icon files in
res/mipmap-*directories - Update adaptive icons in
res/mipmap-anydpi-v26 - Rebuild your app
package Package Name
Android Configuration
folder_open Cabazzo/android/app/build.gradle
// In app/build.gradle
android {
defaultConfig {
applicationId "com.yourcompany.yourapp"
}
}
warning
Warning: Changing package name after release will be treated as a new app by Google Play.
construction Custom Work
If you need additional features, modifications, or integrations in this application, we offer custom development services to tailor the app to your specific needs.
For any custom work requests, please get in touch with us:
- language Website: https://menpanitech.com/
- mail Email: sales@menpanitech.com
info
Note: Custom work may involve additional costs and development time depending on the complexity of the requested changes.
history Version History
history Version History
Track the evolution of the Cabazzo platform through major releases, feature additions, improvements, and optimizations.
Version 1.0.0 (Initial Release)
-- ✓ Initial app release
- ✓ Core functionality implemented
local_fire_department Firebase Configuration
Admin Panel Configuration
Project Setup
- Go to Firebase Console and create a new project
- Create a web app in your Firebase project
Database Configuration
- Navigate to your project dashboard and create the Database
Service Account Setup
- Go to Settings → Project settings → Advanced permissions settings
- Click on "Service Accounts" under Firebase Admin SDK section
- Click "Actions" → "Manage Keys" → "Add Key" → "Create new key"
- Select JSON format and click "Create"
.env Configuration
FIREBASE_CREDENTIALS=firebase.json
FIREBASE_DATABASE_URL=https://your-project-id.firebaseio.com
folder
Place the JSON file in:
/admin/config/firebase.json
Mobile App Configuration
Android Setup
- Select your existing project in Firebase Console
- Click Settings icon → Project settings → Add app → Android
- Download
google-services.jsonfile - Place the file in:
Cabazzo_customer/android/app
info
If you haven't created a Firebase project yet, follow the Admin Configuration steps above first.
Required Firebase Services
admin_panel_settings
Authentication
database
Realtime Database
cloud
Cloud Firestore
notifications
Cloud Messaging
analytics
Analytics
location_on
Geo Locations
fingerprint Bundle ID
Clients must update the bundle identifier to match their application package.
Example: com.clientname.Cabazzo
Android
Update in:
folder_open android/app/build.gradle
applicationId "com.clientname.Cabazzo"
Rename the Java package directory:
folder_open android/app/src/main/java/com/clientname/Cabazzo
key Keystore Configuration
Generate a signing keystore:
keytool -genkey -v \
-keystore Cabazzo.keystore \
-alias Cabazzo \
-keyalg RSA \
-keysize 2048 \
-validity 10000
Place the keystore file inside:
folder_open android/app/
Update the signing configuration in:
folder_open android/gradle.properties
MYAPP_UPLOAD_STORE_FILE=Cabazzo.keystore
MYAPP_UPLOAD_KEY_ALIAS=Cabazzo
MYAPP_UPLOAD_STORE_PASSWORD=yourpassword
MYAPP_UPLOAD_KEY_PASSWORD=yourpassword
rocket_launch Android Release Build
Generate APK
cd android
./gradlew assembleReleaseAPK location:
android/app/build/outputs/apk/release/app-release.apk
Generate Play Store Bundle
cd android
./gradlew bundleReleaseOutput: android/app/build/outputs/bundle/release/app-release.aab
phone_iphone iOS Configuration
iOS development requires a macOS system with Apple Xcode installed. Xcode provides all necessary tools, simulators, and SDKs required to build and run the application on iOS devices.
Ensure that you have the latest version of Xcode installed from the Mac App Store and have accepted all license agreements before proceeding.
download Install iOS Dependencies
The iOS project uses CocoaPods to manage native dependencies. You must install all required pods before running the application.
Follow the steps below:
cd ios && pod install && cd ..
This command installs all required native libraries and links them with your iOS project.
Note: The iOS project is named
cabazzo_customer. If you rename the Xcode target and the target line in
ios/Podfile, you must re-run pod install.
fingerprint iOS Bundle Identifier
The Bundle Identifier uniquely identifies your application in the Apple ecosystem. It must match the identifier configured in Firebase and Apple Developer account.
Current Default:
org.reactjs.native.example.$(PRODUCT_NAME:rfc1034identifier)
Steps:
- Open the project in Xcode:
ios/cabazzo_customer.xcworkspace - Select the main application target (cabazzo_customer).
- Go to the Signing & Capabilities tab.
- Update the Bundle Identifier field to match your Android
applicationId.
Example: com.clientname.cabazzocustomer
Ensure that the Bundle Identifier matches exactly with the one used in the Firebase configuration file, otherwise services may not work correctly.
local_fire_department iOS Firebase Setup
Firebase is used for push notifications and other backend services. You need to download and configure the Firebase iOS configuration file.
Step 1: Add iOS App to Firebase
- Go to your Firebase project console.
- Click Add app and select iOS.
- Enter your Bundle Identifier (matching the one set in Xcode).
- Register the app and download
GoogleService-Info.plist.
Step 2: Add File to Project
Drag the downloaded GoogleService-Info.plist into Xcode:
- Open the project in Xcode:
ios/cabazzo_customer.xcworkspace - Drag and drop the file into the Project Navigator.
- Select "Copy items if needed" when prompted.
- Important: Ensure the file is added to the target (not just copied into the folder).
Step 3: Initialize Firebase in AppDelegate
Open ios/cabazzo_customer/AppDelegate.swift and add the following:
import Firebase // at the top// inside application(_:didFinishLaunchingWithOptions:), before the returnFirebaseApp.configure()
warning Critical: Without step 3, Firebase silently fails on iOS. Push notifications and other Firebase services will not work.
lock iOS Permissions (Info.plist)
iOS requires usage description strings for all permissions your app requests. Missing descriptions crash the app instantly when that permission is requested.
File: ios/cabazzo_customer/Info.plist
Add the following keys with appropriate descriptions:
<key>NSLocationWhenInUseUsageDescription</key><string>We use your location to find nearby drivers and set your pickup point.</string><key>NSCameraUsageDescription</key><string>Used to take a profile photo.</string><key>NSPhotoLibraryUsageDescription</key><string>Used to choose a profile photo.</string><key>NSContactsUsageDescription</key><string>Used to select a contact when booking a ride for someone else.</string><key>UIBackgroundModes</key><array> <string>remote-notification</string></array>
warning ⚠️ Critical: On iOS, a missing usage-description string crashes the app instantly when that permission is requested. This is not optional.
image iOS App Icons
Application icons are used across the app, App Store, and device home screen. You need to replace the default icons with your branding assets.
App Icon Path:
folder_open ios/cabazzo_customer/Images.xcassets/AppIcon.appiconset
Replace all icon sizes inside this folder with your custom icons while maintaining the required dimensions.
App Logo
Replace the main logo used inside the application UI:
folder_open src/assets/logo.png
Recommended size: 500 × 500 PNG (transparent background preferred)
play_arrow Run iOS Application
Before running the application, make sure the Metro bundler is running and all dependencies are installed.
Step 1: Install iOS Dependencies
cd ios && pod install && cd ..
Step 2: Start Metro Server
npm start
Step 3: Run iOS App
npm run ios
This command will build the app and launch it in the iOS Simulator. Alternatively, you can open the project in Xcode and run it directly on a simulator or a physical device.
Alternative: Open ios/cabazzo_customer.xcworkspace in Xcode and click the Run button.
rocket_launch iOS Release Build
To publish your application to the App Store, you must generate a release build using Xcode.
Steps:
- Open the project in Xcode:
ios/cabazzo_customer.xcworkspace - Select Generic iOS Device as the build target.
- From the top menu, select Product → Archive.
- Once the archive is created, open the Organizer window.
- Validate and upload the build to App Store Connect.
After uploading, you can manage your app release from App Store Connect.
checklist iOS Setup Checklist
Use this checklist to verify your iOS setup is complete:
- check_box_outline_blank Firebase: GoogleService-Info.plist added to Xcode project (with target)
- check_box_outline_blank Firebase: FirebaseApp.configure() added to AppDelegate.swift
- check_box_outline_blank Bundle ID: Bundle Identifier updated in Signing & Capabilities
- check_box_outline_blank Permissions: All usage descriptions added to Info.plist
- check_box_outline_blank Icons: App icons replaced in AppIcon.appiconset
- check_box_outline_blank Dependencies: pod install completed successfully
- check_box_outline_blank Build: App runs successfully on simulator or device
api API Configuration
Application API configuration is located in:
folder_open src/config/const.js
Update the following values with client server details:
- BASE_URL
- API_URL
- IMG_URL
- SOCKET_URL (if applicable)
Example:
export const BASE_URL = "https://api.clientdomain.com"
export const API_URL = "https://api.clientdomain.com/v1"
export const IMG_URL = "https://cdn.clientdomain.com"
palette Branding Configuration
Application Logo
Replace the logo file located at:
folder_open src/assets/logo.png
Recommended format: 500 × 500 PNG
Android Launcher Icons
Replace launcher icons in:
folder_open android/app/src/main/res/
Folders:
- mipmap-mdpi
- mipmap-hdpi
- mipmap-xhdpi
- mipmap-xxhdpi
- mipmap-xxxhdpi
iOS App Icons
Replace icons in:
folder_open ios/Cabazzo/Images.xcassets/AppIcon.appiconset
map Map Provider
The application uses MapLibre for map rendering and location-based services.
Map Library Used
@maplibre/maplibre-react-native
Capabilities
layers
Vector Tile Rendering using RouteMappy tiles
map
Real-time map display for ride tracking
navigation
Location-based services for navigation and route
visualization
bolt
High-performance map rendering optimized for mobile
devices
These features enable the application to display driver locations, trip routes, and navigation paths within the app.
route RouteMappy
warning
Third‑Party Paid Service
RouteMappy is a paid maps service and is not included with the Cabazzo purchase package. You must obtain your own API key from RouteMappy. All subscription costs, licensing fees, and setup are the responsibility of the buyer.
Admin Panel Configuration
Step 1: Enter Your RouteMappy API Key
In the place of enter_map_key in your .env
file, add your RouteMappy API key as shown below:
MAP_KEY=enter_map_key
info
If you need RouteMappy Maps for your application, feel free to contact us. It functions as a customizable map solution, available for purchase.
- Website: https://routemappy.com/
- Email: sales@menpanitech.com
Mobile Application Configuration
Step 1: Add Your API Key
Edit the following file:
folder_open Cabazzo/src/config/Constants.js
export const ROUTEMAPPY_API_KEY = 'enter_your_routemappy_key';
info
If you need RouteMappy Maps for your application, feel free to contact us. It functions as a customizable map solution, available for purchase.
- Website: https://routemappy.com/
- Email: sales@menpanitech.com
payments Payment Integration
Library Used
- react-native-razorpay
Features
lock
Secure online payments
directions_car
Ride fare payments
credit_card
Multiple payment methods (Cards, UPI, Net Banking,
Wallets)
Configuration
Payment credentials must be configured on the backend server to enable transaction processing.
Required credentials typically include:
- Payment Gateway API Key
- Secret Key
- Webhook configuration for transaction validation
These credentials are used by the backend API to securely communicate with the payment gateway.
warning
Important Warning
Sensitive credentials such as secret keys must never be stored in the mobile application. All payment validation and transaction verification should be handled securely through the backend server.
notifications FCM Configuration
Modern FCM v1 Setup (OAuth 2.0)
This guide covers the modern Firebase Cloud Messaging v1 API. It uses OAuth 2.0 for secure authentication and provides more features than the deprecated legacy API.
warning
Important
The legacy FCM HTTP API (using Server Keys) is deprecated and will be removed. Always use the Firebase Cloud Messaging HTTP v1 API for all new implementations.
Step 1: Generate Service Account Credentials
-
Access Firebase Console
Go to Firebase Console and select your project.
Navigate to Project Settings (gear icon) → Service accounts tab.
-
Generate a new private key
Click "Generate new private key" in the Firebase Admin SDK section.
Confirm by clicking "Generate key" in the popup.
A JSON file (
your-project-id-firebase-adminsdk.json) will be downloaded automatically. This file contains your service account credentials.shield Security Keep this file secure. It contains sensitive credentials that provide full access to your Firebase services. Never commit this file to a public repository or share it with unauthorized users.
Step 2: Server-Side Configuration
Place the Service Account File
Copy the downloaded JSON file to your project's secure configuration directory:
folder
Recommended Location:
/admin/config/firebase-service-account.json
Configure Environment Variables
Update your backend .env file with the following
configuration:
# Firebase Cloud Messaging v1 Configuration
FIREBASE_PROJECT_ID=your-project-id
FCM_DRIVE_PATH=/path/to/firebase-service-account.json
info
Note
The FCM_DRIVE_PATH points to your Firebase Service Account JSON file, and
FIREBASE_PROJECT_ID is your Firebase project identifier, which can be found in the
Firebase Console.
Step 3: Sending Notifications with v1 API
Here's a secure implementation example for sending push notifications using the FCM v1 API with OAuth 2.0 authentication:
// FCM v1 API Notification Sender
// Uses OAuth 2.0 authentication with service account
use Google\Cloud\Firestore\FirestoreClient;
use Google\Cloud\Core\ServiceBuilder;
// Initialize Firebase with service account
$firestore = new FirestoreClient([
'keyFilePath' => env('FCM_DRIVE_PATH'),
'projectId' => env('FIREBASE_PROJECT_ID')
]);
// Construct the FCM v1 endpoint
$url = "https://fcm.googleapis.com/v1/projects/" . env('FIREBASE_PROJECT_ID') . "/messages:send";
// Get OAuth 2.0 access token
$token = $firestore->getCredentialsFetcher()?->fetchAuthToken();
$accessToken = $token['access_token'];
// Construct the notification payload (v1 format)
$data = [
"message" => [
"token" => "device_registration_token_here",
"notification" => [
"title" => "Notification Title",
"body" => "Notification Message Body"
],
"data" => [
"key1" => "value1",
"key2" => "value2"
],
"android" => [
"priority" => "high"
],
"apns" => [
"headers" => [
"apns-priority" => "10"
]
]
]
];
// Send the notification
$options = [
'http' => [
'header' => "Authorization: Bearer $accessToken\r\n" .
"Content-Type: application/json\r\n",
'method' => 'POST',
'content' => json_encode($data)
]
];
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
Troubleshooting
Common Issues:
-
Authentication Failed (401):
Verify the service account JSON file path is correct and the file has proper read permissions. Ensure the project ID matches.
-
Invalid Token (404):
The device registration token may be invalid or expired. Request a new token from the client app.
-
Permission Denied (403):
The service account needs the "Firebase Cloud Messaging Admin" role in IAM settings.
check_circle
Success
The modern FCM HTTP v1 API provides enhanced security, improved reliability, and supports all the latest Firebase Cloud Messaging features.
mail Gmail Configuration
Step-by-Step Configuration
-
Step 1: Access Gmail Account Settings
Log in to your Gmail account and click on your profile picture in the top right corner. Select "Manage your Google Account" from the dropdown menu.
-
Step 2: Enable Security Verification
Navigate to the "Security" tab in the left sidebar.
Under "Signing in to Google," enable 2-Step Verification if not already active.
infoNote: You must have 2-Step Verification enabled to generate an App Password.
-
Step 3: Generate App Password
While still in the Security section:
-
Find the "App passwords" option (under 2-Step Verification)
-
Click "create"
-
Copy the 16-character password shown
-
.env File Configuration
Add these configurations to your .env file:
MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=youremail@gmail.com
MAIL_PASSWORD=your_generated_app_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=youremail@gmail.com
MAIL_FROM_NAME="${APP_NAME}"
warning
Important Security Notes:
- Never use your main Gmail password in the .env file
- Always use the generated App Password
- Keep your .env file secure and never commit it to version control
- If compromised, revoke the app password immediately from Google Security settings
Troubleshooting
Common Issues:
-
Authentication Failed:
Verify 2-Step Verification is enabled and you're using an App Password.
-
Connection Timeout:
Check if your server/firewall allows outbound connections on port 587.
-
Daily Limit Exceeded:
Gmail has sending limits (500 emails/day for free accounts).
devices Device Configuration
Application Deployment Guide
info
Advisable: Copy the source files to D: or E: drive rather than C: drive.
Environment Setup
- Connect your device via USB
- Verify connection:
adb devicesConfirm the device appears in the list.
check_circle
Prerequisites
- Android Studio with SDKs installed
- Active emulator/device visible via adb
- Developer options enabled on physical devices
Build & Run Process
- Launch Command Prompt
- Navigate to project directory:
cd D:\Cabazzo_customer- Install project dependencies:
npm install- Execute the application:
npx react-native run-androidhelp_outline FAQ & Troubleshoot
FAQ & Troubleshooting
1. Dependencies Installation
Failed (npm install)
Cause: Incorrect Node.js version, network issues, or corrupted cache.
Solution:
- Make sure Node.js 22+ is installed and active.
- Navigate to the correct project directory (Customer App or Driver App).
- Run:
npm install- If the problem persists, clear the cache:
rm -rf node_modules package-lock.json
npm cache clean --force
npm install
2. Module Not Found / Import Error
Cause: Missing packages or incorrect import paths after an update.
Solution:
- Ensure all source files are correctly extracted.
- Reinstall dependencies with
npm install. - Check that the imported module name matches the installed package.
- Restart the Metro bundler:
npx react-native start --reset-cache3. Firebase Configuration Issues
Cause: Firebase project not properly linked or config files missing.
Solution:
- Download
google-services.json(Android) andGoogleService-Info.plist(iOS) from your Firebase console. - Place them in the correct folders:
- Android:
android/app/ - iOS: root of the Xcode project (via Xcode)
- Android:
- Verify that Firebase Cloud Messaging (FCM) is enabled for push notifications and real‑time trip alerts.
- Check that the package name / bundle ID matches the Firebase project settings.
4. Environment Variables Not Configured
Cause: The .env file is missing or
contains wrong values.
Solution:
- For the admin backend, copy
.env.exampleto.envand fill in database, mail, map, and payment keys. - For the mobile apps, update the API base URL and any service keys in the environment configuration files.
- Restart the development server after any changes.
Example (Admin .env):
APP_URL=http://your-server-url
DB_DATABASE=cabazzo_db
FCM_SERVER_KEY=your_key
5. Android Device Not Detected
Cause: USB debugging disabled or missing drivers.
Solution:
- Enable Developer Options and USB Debugging on your Android device.
- Connect via a data‑capable USB cable.
- Run
adb devicesin a terminal and accept the authorization prompt on the phone.
adb devices6. License or Purchase Code Validation Issues
Cause: Invalid, expired, or incorrectly entered purchase code.
Solution:
- Log in to your Envato account and download the license certificate again.
- Copy the purchase code exactly and paste it into the activation field.
- Ensure your server can reach the licensing API (whitelist if behind a firewall).
7. Application Stuck on Splash Screen / Not Loading
Cause: Backend URL misconfigured, invalid JSON response, or network restrictions.
Solution:
- Double‑check the API base URL in the mobile app configuration.
- Make sure the Laravel backend is running (
php artisan serve). - Check browser console or React Native debug logs for errors.
- Clear app cache and restart the bundler.
8. Admin Panel Database Import Fails
Cause: Incorrect database credentials or large SQL file timeout.
Solution:
- Create a fresh database via phpMyAdmin or command line.
- Import the provided
.sqlfile using phpMyAdmin’s Import tab or via command line:
mysql -u root -p cabazzo_db < cabazzo_admin.sql
- Update
.envwith correct DB credentials and restart the backend.
9. Push Notifications Not Working
Cause: FCM server key missing, or notification channels not set up.
Solution:
- Go to Admin Panel → Operations → Notification Messages and verify the FCM Server Key is entered.
- Ensure the customer/driver app has granted notification permissions.
- Check that
@react-native-firebase/messagingis correctly linked. - Test from the admin panel using the “Send Notification” feature.
10. Map Not Displaying / Location Issues
Cause: Map provider (RouteMappy/Google) API key invalid, or location permissions denied.
Solution:
- Verify the map API key in Admin → Settings → Map Settings and in the mobile app configuration.
- Ensure location permissions are enabled for the app (device settings).
- Check that the device has an active internet connection.
- Restart the app after changing permissions.
11. Driver Registration Stays Pending
Cause: The admin has not yet reviewed the driver’s documents.
Solution:
- Login to Admin Panel → Drivers → Drivers and locate the pending driver.
- Click on the driver, review the uploaded KYC and vehicle documents.
- Approve the driver account; they will receive a notification immediately.
12. Payment Gateway Not Working (Razorpay)
Cause: API keys are incorrect or set to live mode without proper activation.
Solution:
- Go to Admin Panel → Payment Methods → Payment Methods and ensure the gateway is enabled.
- Double‑check the
RAZORPAY_KEY,RAZORPAY_SECRETin the.envfile. - Use test/sandbox keys first to verify the flow.
- Check that the webhook URL (if required) is correctly configured in the payment gateway dashboard.
13. OTP Not Received During Login or Trip Start
Cause: SMS gateway (Twilio) misconfiguration or insufficient balance.
Solution:
- Verify Twilio SID, Token, and sender number in the
.envfile. - Check your Twilio account balance and trial limitations.
- Make sure the phone number is entered with the correct country code.
- Retry after a short delay; carrier delays can occasionally occur.
14. Customer or Driver Cannot Log In
Cause: Wrong credentials, account deactivated, or network error.
Solution:
- Use the “Forgot Password” option to reset the password.
- In Admin Panel, check under Customers or Drivers that the account is active.
- Verify that the SMS/OTP service is working (if using OTP login).
- Ensure the backend API is reachable from the mobile device.
15. Banners or Images Not Uploading in Admin
Cause: File size too large, unsupported format,
or permission issues on the uploads folder.
Solution:
- Use JPG, PNG, or WebP images under 2 MB.
- Ensure the
storagefolder has write permissions andphp artisan storage:linkhas been executed. - In the Admin .env, check that
APP_ASSET_URLis set correctly.
16. Trip Requests Not Appearing for Drivers
Cause: Driver is offline, vehicle type mismatch, or zone restrictions.
Solution:
- Confirm the driver has set their status to Online in the driver app.
- Check that the driver’s vehicle matches the requested type (Sedan, SUV, Hatchback).
- In Admin Panel → Operations → Zones, verify the driver is inside a valid service zone.
- Ensure the trip type (Daily, Rental, Outstation) is selected in the driver’s trip preferences.
support_agent Need Additional Help?
If you encounter any issues not covered here, our support team is ready to assist.
Support Email:
Support Hours:
Monday – Friday
Response Time: Within 24–48 Business Hours
When contacting support, please include:
- Purchase Code
- Application Version
- Server Details (PHP version, database type)
- Error Screenshots or log snippets
- Steps to Reproduce the issue
This information helps us resolve your problem faster.
support_agent Contact Us
support_agent
Need Help?
If you encounter an error that is not listed above, please feel free to contact our support team for further assistance. We’re here to help.
Custom Development Services
If you need any custom work, additional features, or modifications to this application, our team is ready to help you build and scale your project efficiently.
What We Can Help With
code
Custom feature development based on your business needs
palette
UI/UX design improvements and branding customization
integration_instructions
Third-party API integrations (payment, SMS, maps, etc.)
speed
Performance optimization and scalability improvements
cloud_upload
Full project setup and deployment assistance
rocket_launch
Building large-scale applications from scratch
Hire Us
You can hire our development team for complete project development, from idea to deployment, including frontend, backend, and server setup.
call
Phone Number
+91 9150 441 443
language
Website
https://menpanitech.com/
mail
Email
sales@menpanitech.com
info
Important Note
Custom development services may involve additional cost and timeline depending on the scope and complexity of the project.
We’re happy to collaborate and bring your ideas to life