GoCabz Docs - Installation Guide

warning Important: Third-Party Services Disclaimer

Map Services: RouteMappy requires a valid subscription/license
Payment Gateways: Razorpay, Flutterwave, Paystack require separate accounts and may have transaction fees
Push Notification Services: Firebase Cloud Messaging (FCM) or OneSignal require account setup
Cloud Hosting & Storage: AWS, Google Cloud, or Firebase project required (free tier available)
SMS & Email Services: Twilio, SendGrid or similar providers require credits/account
Firebase: Firebase project required for chat and push notifications (free tier available)

These services are not included with the purchase and must be configured by the buyer.

info

What comes with GoCabz

Customer Website, Driver Application, and Admin Panel — all included.

Introduction

Welcome to GoCabz, a white-label taxi booking platform designed for fleet owners, taxi operators, and mobility service providers. It enables seamless ride booking, real-time driver tracking, and efficient trip management through a powerful admin panel.

Core Features

Real-time Ride Booking
Live Route & Driver Tracking
Dynamic Fare Calculation
Multiple Trip Types (Daily, Rental & Outstation)
Multiple Payment Gateway Integration
Driver KYC & Document Verification
Automatic Driver Assignment
Customer & Driver In-App Chat
Wallet, Promo Codes & Discounts
Complete Admin Management Dashboard

check_circle

White-Label Solution

This platform is distributed as a white-label solution, allowing complete customization of branding, configurations, and backend services to match your business requirements and scale your taxi operations efficiently.

Getting Started

extension Third-Party Plugins

Firebase — Used for chat and push notifications
RouteMappy — Map integration for routing and tracking
Payment Gateways: Razorpay, Flutterwave, Paystack

lightbulb

Prerequisite Knowledge

Basic understanding of React-based website development and backend setup (Laravel / API) is recommended before installation and customization.

hub Third Party Services

GoCabz integrates with several third-party services to provide functionality such as maps, push notifications, real-time chat, authentication, 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, Live Route Tracking, Geocoding & Location Services	Yes
Firebase Cloud Messaging (FCM)	Push Notifications for Drivers & Customers	Yes
Firebase Realtime Database / Firestore	In-App Chat Between Customers & Drivers	Yes
Firebase Authentication	User Authentication & OTP Verification	Optional
SMTP Mail Service	Email Notifications, Password Reset & Verification	Yes
Twilio SMS	SMS Notifications & OTP Delivery	Optional
Razorpay	Online Payment Processing	Optional
Flutterwave	Online Payment Processing	Optional
Paystack	Online Payment Processing	Optional

map RouteMappy Maps

GoCabz 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

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.3 or later
Laravel: 13.x
MySQL: 8.0 or later
Composer: 2.5 or later
Apache/Nginx: Latest stable version

Frontend Requirements

Node.js: 20.x or later
npm: 10.x or later
React: 19.2.8
React Router: 7.18.1
Alpine.js: 3.15.12
MapLibre GL: 4.7.1

Android Development

Android Studio: 2024.1.1 (Ladybug) or later
Java JDK: 17 or later (JDK 21 recommended)
Android SDK: API Level 34 (Android 14)
Build Tools: 34.0.0 or later
Gradle: 8.3 or later
React Native: 0.74.x or later

iOS Development (macOS only)

Xcode: 16.x or later (from Mac App Store)
iOS SDK: iOS 17+
iOS Deployment Target: iOS 13+
CocoaPods: 1.15.x or later
macOS: Sonoma 14.5 or later
React Native: 0.74.x 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) — Pro or Enterprise recommended
macOS Monterey (12.0) or later — Sonoma 14.5+ recommended
Linux (Ubuntu 22.04 LTS, 24.04 LTS, or equivalent)

Minimum Hardware:

Processor: Intel i5 10th Gen (or AMD Ryzen 5) or better
RAM: 8 GB (minimum), 16 GB recommended for Android Studio
Storage: 10 GB free disk space for dependencies, SDKs, and build files
Internet: Broadband connection required for downloading dependencies

Software Requirements

Tool/Software	Minimum Version	Recommended Version	Purpose
Node.js	v18.x LTS	v20.x LTS	React & npm scripts
npm	v8.x	v10.x or later	Package management
Git	2.30	Latest	Version control (optional)
VS Code	1.80	Latest	Code editor (recommended)
Web Browser	Chrome 120, Firefox 120, Edge 120	Latest version	Testing & debugging
PHP	8.2	8.3 or later	Laravel backend
Composer	2.5	2.7 or later	PHP dependency manager
MySQL	5.7	8.0 or later	Database
Android Studio	2023.1	2024.1 (Ladybug)	Android APK/AAB build
Java JDK	11	17 or later (JDK 21 recommended)	Android compilation
Gradle	8.3	8.3 or later	Android build system
Xcode (macOS only)	15.0	16.x or later	iOS IPA build
CocoaPods	1.12	1.15.x or later	iOS dependencies

XAMPP / Local Server Installation

Download XAMPP from apachefriends.org (version 8.2+ recommended)
Install XAMPP on your system with default settings
After installation, start Apache and MySQL services from the XAMPP control panel
Verify installation by visiting http://localhost in your browser

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

info

Composer Installation Guide:

https://youtu.be/VCHXCusltqI?si=EfH3PW6l0sRS0FbE

Getting Started Requirements

lightbulb

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

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 v20.x or higher

                # Check npm version
                npm --version    # Should show v10.x or higher

                # Check PHP version
                php --version    # Should show 8.2 or higher

                # Check Composer version
                composer --version  # Should show 2.5 or higher

                # Check MySQL version
                mysql --version  # Should show 8.0 or higher

                # Check Java version (for Android)
                java --version   # Should show 17 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

GoCabz is built using modern and scalable technologies to power Customer Websites, driver applications, and administrative operations.

Core Technology Versions

Before installing and running the application, ensure the following technologies and tools are installed with the recommended versions.

React Native

0.74.x

React

19.2.8

Node.js

20+

PHP

8.3+

Laravel

13.x

MySQL

8.0+

Android SDK

34+

Xcode

16.x+

Java JDK

17+

Filament

5.6

Alpine.js

3.15.12

MapLibre GL

4.7.1

Category	Technology	Version	Purpose
Frontend (Customer Website & Admin Panel)
Framework	React	19.2.8	UI Library
Routing	React Router DOM	7.18.1	Page navigation
JavaScript Library	Alpine.js	3.15.12	Interactive UI Components
Alpine.js Plugin	@alpinejs/intersect	3.15.12	Intersection Observer Plugin
Alpine.js Plugin	@alpinejs/morph	3.15.12	Morphing Plugin
Map Library	MapLibre GL	4.7.1	Map Rendering & Location Services
Backend (Admin Panel & API)
Language	PHP	8.3+	Server-Side Programming
Framework	Laravel	13.x	PHP Framework
Admin Panel	Filament	5.6	Admin Dashboard
Admin Security	Filament Shield	4.2	Admin Panel Security & Permissions
Role & Permission	Spatie Laravel Permission	7.4	User Roles & Permissions Management
Firebase SDK	Kreait Firebase PHP	8.2	Firebase Services Integration
Database	MySQL / MariaDB	8.0+ / 10.6+	Relational Database
Dependency Manager	Composer	2.5+	PHP Package Management
Interactive Shell	Laravel Tinker	3.0	Artisan REPL & Interactive Shell
Mobile App (Driver)
Framework	React Native	0.74.x	Cross-platform mobile
UI Library	React	19.2.8	Application User Interface
Navigation	React Navigation	6.x	Screen navigation
Maps	MapLibre GL	4.7.1	Map rendering
State Management	Redux Toolkit	Latest	Application State Management
HTTP Client	Axios	Latest	API Communication
JavaScript Engine	Hermes	Latest	Performance Optimization
Android Development Environment
Node.js	Node.js	20+	JavaScript Runtime
Android SDK	Android SDK	34+	Android Development Platform
Build Tools	Android Build Tools	34.0.0+	Application Compilation
Minimum SDK	Android SDK	24	Minimum Supported Android Version
Target SDK	Android SDK	34	Target Android Version
Gradle	Gradle	8.3+	Build Automation
Java	JDK	17+	Android Development Environment
iOS Development Environment
iOS Deployment Target	iOS	13+	Minimum Supported iOS Version
Xcode	Xcode	16.x+	iOS Development Environment
CocoaPods	CocoaPods	1.15.x+	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 / Flutterwave / Paystack	Latest	Online Payment Processing
Maps & Location	RouteMappy / MapLibre	Latest	Location Services & Navigation
Address Search	Google Places API	Latest	Location autocomplete
SMS Gateway	Twilio SDK	Latest	SMS & OTP Services
Analytics	Google Analytics / Firebase Analytics	Latest	Usage Tracking & Insights

Hosting & Production Server Requirements

Apache 2.4+ or Nginx 1.18+
PHP 8.3+
MySQL 8.0+ / MariaDB 10.6+
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.

info Note on Third-Party Services

This platform integrates with services like RouteMappy, Firebase, Twilio, and Razorpay/Paystack/Flutterwave which require separate accounts and may incur additional costs. See full details in Overview →

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 managing Node.js versions and Android Studio SDK Manager for maintaining Android SDK compatibility.

view_module Project Dependencies

Project Dependencies Overview

GoCabz consists of three main components:

language

Customer Website

React-based frontend with MapLibre

drive_eta

Driver Application

React Native mobile app

admin_panel_settings

Admin Panel

Laravel + Filament backend

info

Customer Website: React 19.2.8 with React Router 7.18.1, Alpine.js 3.15.12, MapLibre GL 4.7.1

Driver Application: React Native 0.85.3 with React 19.2.3

Admin Panel: Laravel 13.x with Filament 5.6, PHP 8.3+

language Customer Website Dependencies

The customer website is built with React and uses the following dependencies:

Package	Version	Purpose
react	19.2.8	UI Library
react-dom	19.2.8	React DOM rendering
react-router-dom	7.18.1	Client-side routing
alpinejs	3.15.12	Interactive UI components
@alpinejs/intersect	3.15.12	Intersection Observer plugin
@alpinejs/morph	3.15.12	Morphing plugin for Alpine.js
maplibre-gl	4.7.1	Map rendering and location services

admin_panel_settings Admin Panel (Laravel) Dependencies

The admin panel is built with Laravel and Filament, using the following PHP dependencies:

Package	Version	Purpose
Production Dependencies
php	^8.3	Server-side scripting language
laravel/framework	^13.0	Laravel PHP Framework
filament/filament	^5.6	Admin panel framework
bezhansalleh/filament-shield	^4.2	Filament security & permissions
spatie/laravel-permission	^7.4	User roles & permissions
kreait/firebase-php	^8.2	Firebase SDK integration
laravel/tinker	^3.0	Artisan REPL & interactive shell
Development Dependencies
fakerphp/faker	^1.23	Fake data generation
laravel/pail	^1.2.5	Log viewer
laravel/pao	^1.0.6	Package auto-discovery optimizer
laravel/pint	^1.27	PHP code style fixer
mockery/mockery	^1.6	Mocking framework for tests
nunomaduro/collision	^8.6	Error handling for console
phpunit/phpunit	^12.5.12	PHP testing framework

drive_eta Driver Application Dependencies

The driver application is built with React Native and uses the following dependencies:

Package	Version	Purpose
Core Libraries
react	19.2.3	UI Library
react-native	0.85.3	Cross-platform mobile framework
react-native-gesture-handler	^2.31.2	Gesture-based interactions
react-native-reanimated	^4.3.1	Smooth animations
react-native-safe-area-context	^5.5.2	Safe area handling
react-native-screens	^4.24.0	Native screen optimization
axios	^1.16.0	HTTP client for API calls
moment	^2.30.1	Date and time formatting
moment-hijri	^3.0.0	Hijri calendar support
i18next	^26.0.10	Internationalization
react-i18next	^17.0.7	React i18next integration
react-native-worklets	^0.11.3	Worklets for React Native
State Management
react-redux	^9.2.0	State management
redux	^5.0.1	State container
Navigation
@react-navigation/native	^7.2.4	Core navigation library
@react-navigation/native-stack	^7.14.14	Stack navigation
@react-navigation/bottom-tabs	^7.15.13	Bottom tab navigation
@react-navigation/drawer	^7.9.11	Drawer/side menu navigation
@react-navigation/stack	^7.8.13	Stack navigation
Maps and Location
@maplibre/maplibre-react-native	^10.4.1	Map rendering
react-native-maps	^1.27.2	Alternative map rendering
@react-native-community/geolocation	^3.4.0	GPS location services
react-native-android-location-enabler	^3.0.1	Android location services
react-native-google-places-autocomplete	^2.6.4	Google Places autocomplete
Firebase Services
@react-native-firebase/app	^24.0.0	Firebase core
@react-native-firebase/database	^24.0.0	Real-time database
@react-native-firebase/messaging	^24.0.0	Push notifications
@notifee/react-native	^9.1.8	Enhanced notification management
UI and Animation
lottie-react-native	^7.3.6	Animated illustrations
react-native-paper	^5.15.2	Material Design components
react-native-vector-icons	^10.3.0	Icon library
react-native-svg	^15.15.4	SVG rendering
react-native-drop-shadow	^1.0.3	Drop shadow effects
react-native-animatable	^1.4.0	Animation components
react-native-calendars	^1.1314.0	Calendar component
react-native-ratings	^8.1.0	Star rating component
react-native-pager-view	^8.0.1	Pager/swipe view
react-native-raw-bottom-sheet	^3.0.0	Bottom sheet component
react-native-simple-bottom-sheet	^1.0.4	Simple bottom sheet component
react-native-toast-message	^2.3.3	Toast notification messages
react-native-dropdownalert	^5.2.0	Alert dropdown notifications
Device Features
@react-native-async-storage/async-storage	^2.2.0	Local data persistence
@react-native-clipboard/clipboard	^1.16.3	Clipboard management
@react-native-community/datetimepicker	^9.1.0	Date/time picker component
@react-native-community/netinfo	^12.0.1	Network connectivity monitoring
@react-native-picker/picker	^2.11.4	Native picker component
@react-native-segmented-control/segmented-control	^2.5.7	Segmented control component
@react-native/new-app-screen	0.85.3	New app screen template
react-native-background-timer	^2.4.1	Background timer functionality
react-native-countdown-circle-timer	^3.2.1	Countdown timer visualization
react-native-device-info	^15.0.2	Device information
react-native-dialog	^9.3.0	Dialog/modal components
react-native-dialog-input	^1.0.8	Dialog with input fields
react-native-fs	^2.20.0	File system access
react-native-get-random-values	^2.0.0	Cryptographic random values
react-native-haptic-feedback	^3.0.0	Device vibration/haptic feedback
react-native-image-picker	^8.2.1	Image selection from camera/gallery
react-native-keyboard-controller	^1.21.7	Keyboard management
react-native-modal-datetime-picker	^18.0.0	Modal date/time picker
react-native-permissions	^5.5.1	Runtime permissions management
react-native-phone-input	^1.3.7	Phone number input with country codes
react-native-restart	^0.0.27	App restart functionality
react-native-signature-canvas	^5.0.2	Digital signature capture
react-native-sound	^0.13.0	Audio playback
react-native-version-number	^0.3.6	App version information
react-native-video	^6.19.2	Video playback
react-native-video-controls	^2.8.1	Video controls
react-native-webview	^13.16.1	Web content rendering
rn-fetch-blob	^0.12.0	File and blob handling
Chat & Messaging
react-native-gifted-chat	^3.3.2	Chat/messaging interface
Payment Integration
react-native-razorpay	^3.0.0	Razorpay payment gateway
flutterwave-react-native	^1.0.4	Flutterwave payment gateway

Dependency Summary

language Customer Website:

Total Dependencies: 7 packages
React Version: 19.2.8
Map Library: MapLibre GL 4.7.1
UI Framework: Alpine.js 3.15.12

drive_eta Driver App:

Total Dependencies: 66 packages
React Native: 0.85.3
React Version: 19.2.3
State Management: Redux + React-Redux

admin_panel_settings Admin Panel:

PHP Version: 8.3+
Laravel: 13.x
Filament: 5.6
Firebase SDK: 8.2

check_circle Shared Libraries language Customer Website drive_eta Driver App admin_panel_settings Admin Panel

person Customer Website Guide

How Customers Use the Website

1

Authentication

Customer Registration: Sign up with full name, email, and mobile number
Customer Login: Login using Email and password
Forgot Password: Reset password via OTP sent to registered Email
Reset Password: Create new password after verification
Logout: Securely logout from the Website

2

Profile Management

View Profile: Access and view personal profile information
Edit Profile: Update name, email, phone number, and other details
Change Password: Update account password securely
Upload Profile Photo: Add or update profile picture

3

Ride Booking

Select Pickup Location: Enter or select pickup location from map
Select Drop Location: Enter or select destination from map
Detect Current Location: Use GPS to detect current location automatically
View Route on Live Map: See the route on interactive map
Calculate Distance & Duration: View estimated distance and travel time
Choose Ride Now or Schedule Ride: Book immediately or schedule for later
Select Trip Type: Choose between Daily, Rental, or Outstation trips
View Available Vehicles & Fare: See available vehicle types with fare details
Dynamic Fare Update: Real-time fare calculation based on distance and duration
Change Pickup & Drop Location: Modify locations before confirming
Add Driver Notes: Provide special instructions to driver

4

Payment Management

Apply Promo Code: Enter discount codes for fare reduction
Razorpay Payment: Secure online payment via Razorpay
Flutterwave Payment: Secure online payment via Flutterwave
Paystack Payment: Secure online payment via Paystack
Cash Payment: Pay with cash at trip completion
Wallet Payment: Use app wallet balance for payment (optional)

5

Trip Management

Create Ride Booking: Confirm and book the ride
Search Nearby Driver: System searches for available drivers nearby
Driver Accept/Reject Status: View real-time driver response
View Driver Details: See driver name, photo, rating, and vehicle details
Trip Status Updates: Track trip status in real-time
Cancel Ride: Cancel the ride before pickup
Complete Ride: Mark trip as completed

6

Communication & Feedback

Customer & Driver Chat: Real-time in-app messaging
Rate Driver: Rate driver from 1 to 5 stars
Submit Review: Write feedback about trip experience

7

Booking History & Support

Booking History: Access all past and upcoming trips
Upcoming Trips: View scheduled and pending trips
Completed Trips: View all completed trip history
Cancelled Trips: View cancelled trip records
Trip Details: View detailed trip information
Complaints: File complaints regarding trips or drivers
FAQ: Access frequently asked questions
Contact Support: Reach out to customer support
Terms & Conditions: View platform terms
Privacy Policy: View privacy policy

lightbulb Pro Tip: Save your frequently used locations for faster booking. Enable notifications to receive real-time ride updates!

drive_eta Driver Application Guide

Driver App Workflow

1

Authentication

Driver Registration: Register with personal and vehicle details
Driver Login: Login using registered mobile number and password
Forgot Password: Reset password via OTP
Logout: Securely logout from the application

2

Document Verification

Upload Driving License: Upload valid driving license
Upload Vehicle Documents: Upload RC, insurance, and permit
Upload Identity Proof: Upload Aadhar, PAN, or passport
Admin Approval: Wait for admin verification and approval

3

Profile Management

Edit Driver Profile: Update personal and vehicle information
Toggle Availability: Go online/offline to accept rides

4

Booking Management

Receive Ride Requests: Get real-time ride request notifications
Accept Ride: Accept incoming ride requests
Reject Ride: Decline ride requests with reason
Cancel Ride: Cancel accepted ride if necessary
Start Ride: Begin the trip after pickup
Complete Ride: End the trip after drop-off

5

Trip Management

View Customer Details: See customer name, rating, and contact
Navigate to Pickup: Get real-time navigation to pickup location
Live Route Navigation: GPS navigation during the trip
Trip History: View all completed trips

6

Wallet & Earnings

Driver Wallet: View wallet balance and transactions
Recharge Wallet: Add funds to wallet
Wallet History: View all wallet transactions
Earnings: View daily earnings summary
Request Withdrawal: Request withdrawal of earnings
Withdrawal History: View past withdrawal requests

7

Communication & Support

Chat with Customer: In-app messaging with customers
Call Customer: Direct call to customer (if enabled)
View Ratings: See customer ratings and reviews
Complaints: File complaints about customers
Contact Admin: Reach out to admin for support
Driver Tutorials: Access driver training materials

info Note: Drivers must complete document verification before accepting rides. Keep your documents updated and maintain high service standards for better ratings and more ride opportunities!

admin_panel_settings Admin Panel Guide

Admin Panel Overview

The GoCabz Admin Panel provides complete control over the platform. Below is the detailed menu structure and functionality.

Menu Section	Sub-Menu Items	Functionality
Dashboard
Dashboard	-	View business overview, revenue, trips, customers, and drivers
App Details	-	View and manage application details and information
Features	-	Manage platform features and highlights
Our Achievements	-	Manage achievements and milestones
Website Settings	-	Configure website settings and preferences
Customer Management
Customers	-	Manage customer accounts, profiles, and details
Customer Favourites	-	View customer favourite drivers and vehicles
Customer Wallet Histories	-	View all customer wallet transactions and history
Driver Management
Drivers	-	Manage driver profiles, vehicles, and status
Driver Vehicles	-	Manage driver vehicle details and documents
Driver Tutorial	-	Manage driver training and tutorial content
Driver Bank Details	-	View and manage driver bank account information
Driver Recharge	-	Manage driver wallet recharge transactions
Driver Earnings	-	View driver earnings and commissions
Driver Withdrawal	-	Manage driver withdrawal requests and payouts
Driver Wallet History	-	View all driver wallet transactions and history
Trip Management
Trips	-	View and manage all trips
Trip Type	Daily, Rental, Outstation	Manage trip types and configurations
Trip Request	-	View and manage all trip requests
Driver Trip Request	-	View driver-specific trip requests and responses
Vehicle Categories	-	Manage vehicle categories and sub-categories
Trip Request Status	-	Manage trip request statuses and workflows
Vehicle Slugs	-	Manage vehicle slugs for SEO and URLs
Booking Status	-	Manage booking statuses and tracking
Payment Management
Payment Methods	Razorpay, Flutterwave, Paystack	Configure payment gateway credentials and settings
Payment Type	Internal, External	Manage accepted payment types
Payment History	-	View all payment transactions and history
Location Management
Zones	-	Create and manage service zones and operating areas
Fare Management
Packages	-	Manage fare packages and pricing plans
Daily Fare	-	Configure daily trip fare settings
Rental Fare	-	Configure rental trip fare settings
Outstation Fare	-	Configure outstation trip fare settings
Setting Group
App Settings	-	Configure company details, email, SMS, notifications, currency, language, timezone, and general application settings
App Versions	-	Manage application versions and updates
Contact Settings	-	Configure contact preferences and support settings
Notification Messages	-	Manage notification templates and messages
Referral Settings	-	Configure referral program settings and rewards
Trip Settings	-	Configure trip-related settings and preferences
User Types	-	Manage user types and classifications
Users	-	Manage all platform users
Map Settings	-	Configure RouteMappy API, map provider, routing, geocoding, and reverse geocoding
Contact Group
Blogs	-	Create and manage blog posts and articles
FAQs	-	Manage frequently asked questions
How It Works	-	Manage "How It Works" content and steps
Privacy Policies	-	Manage privacy policy content
Terms and Conditions	-	Manage platform terms and conditions
Testimonials	-	Manage customer and driver testimonials
Complaint Management
Complaint	-	Manage customer and driver complaints
Complaint Categories	-	Manage complaint categories
Complaint Sub Categories	-	Manage complaint sub-categories
Filament Shield
Roles	Super Admin, Admin, Moderator, Content Manager	Create roles and assign permissions
Management Group
Promo Codes	-	Create and manage promo codes, coupons, offers, and discount campaigns
Tax Lists	-	Configure GST, VAT, service taxes, and tax rules
Cancellation Reasons	-	Manage cancellation reason codes and descriptions
Statuses	-	Manage various system statuses (Trip, Booking, Payment)
Promo Types	-	Manage promotion types and categories

Key Admin Workflows

Driver Management

Review driver registrations and documents
Verify uploaded documents and bank details
Approve/Reject driver applications
Monitor driver performance and ratings
Manage driver recharges and wallet history
Process driver withdrawals and payouts
Manage driver tutorials

Trip & Ride Management

Monitor all ride requests and trips
Track active trips in real-time
Manage scheduled and trip types
View trip history and booking status
Handle cancellations with reasons
Manage vehicle categories and slugs
Generate trip reports

Financial Management

Configure payment methods and types
View all payment transactions and history
Track revenue and commissions
Manage driver payouts and withdrawals
Configure fare settings (Daily, Rental, Outstation)
Configure tax lists and rules
Manage promo codes and types

App Configuration

Configure app settings and versions
Manage website settings and app details
Configure map and location settings
Manage contact settings and notifications
Configure referral and trip settings
Manage CMS content (Blogs, FAQs, Policies)
Configure roles & permissions

Customer Management

Manage customer accounts and profiles
View customer favourites
Monitor customer wallet histories
Handle customer complaints
Manage testimonials

Support & Content

Manage complaint categories and sub-categories
Update How It Works content
Manage FAQs and blogs
Handle cancellation reasons
Manage status configurations
Send notifications

admin_panel_settings

Access URL: http://yourdomain.com/admin Default Credentials: admin / admin

warning Security Note: Change default admin password immediately after first login!

android Android Configuration

settings Android Configuration

The Android build configuration defines the SDK versions, build tools, and other essential parameters required for compiling the application.

Build Configuration

File Location: android/build.gradle

Configuration	Value
Build Tools Version	36.0.0
Minimum SDK Version	24
Compile SDK Version	36
Target SDK Version	36
Android NDK Version	27.1.12297006
Kotlin Version	2.1.20

Example Configuration

code Build Configuration (build.gradle)

buildToolsVersion = "36.0.0"

        minSdkVersion = 24

        compileSdkVersion = 36

        targetSdkVersion = 36

        ndkVersion = "27.1.12297006"

        kotlinVersion = "2.1.20"

Gradle Properties

Gradle properties control the build performance, memory allocation, and Android compatibility settings.

File Location: android/gradle.properties

settings Gradle Properties

org.gradle.jvmargs=-Xmx8g -XX:MaxMetaspaceSize=3g -Dfile.encoding=UTF-8

        org.gradle.daemon=true

        org.gradle.parallel=true

        org.gradle.caching=true

        android.useAndroidX=true

        reactNativeArchitectures=arm64-v8a

        newArchEnabled=true

        hermesEnabled=true

        edgeToEdgeEnabled=false

Property	Value	Description
org.gradle.jvmargs	-Xmx8g -XX:MaxMetaspaceSize=3g -Dfile.encoding=UTF-8	JVM memory allocation for Gradle builds
org.gradle.daemon	true	Enables Gradle daemon for faster builds
org.gradle.parallel	true	Enables parallel execution of tasks
org.gradle.caching	true	Enables build caching for faster builds
android.useAndroidX	true	Enables AndroidX support libraries
reactNativeArchitectures	arm64-v8a	Target architecture for React Native
newArchEnabled	true	Enables React Native New Architecture
hermesEnabled	true	Enables Hermes JavaScript engine
edgeToEdgeEnabled	false	Disables edge-to-edge display mode

Gradle Plugin Configuration

File Location: android/build.gradle

extension 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")

info

Important Notes

SDK Versions: Ensure all SDK versions are consistent across the build configuration
Gradle Version: Compatible with Gradle 9 or later
New Architecture: React Native New Architecture is enabled by default (newArchEnabled=true)
Hermes: Hermes JavaScript engine is enabled for improved performance
Google Services: Firebase integration requires the Google Services plugin

admin_panel_settings Admin Panel Configuration

info

PHP Version Requirement

This admin panel requires PHP 8.3. Please ensure you have the correct version installed before proceeding.

php --version # Should show PHP 8.3.x

folder

Project Structure

The React website is located inside the admin project folder:


    GoCabz/
    ├── app/
    │   ├── Http/
    │   │   └── Controllers/          ← API Controllers
    │   ├── Models/                   ← Eloquent Models
    │   ├── Filament/
    │   │   ├── Pages/                ← Filament Admin Pages
    │   │   └── Resources/            ← Filament Resources
    │   └── Providers/                ← Service Providers
    ├── bootstrap/
    ├── config/                       ← Configuration Files
    ├── database/
    │   ├── migrations/               ← Database Migrations
    │   └── seeders/                  ← Database Seeders
    ├── public/
    │   ├── style.json                ← Map Style Configuration
    │   ├── pois/                     ← Map POI Images
    │   ├── js/
    │   │   └── Layers.js             ← Map Layers Configuration
    │   └── storage/
    ├── resources/
    │   ├── css/
    │   │   └── app.css
    │   ├── js/                       ← React Frontend
    │   │   ├── main.jsx              ← Entry Point
    │   │   ├── App.jsx               ← Router + Providers
    │   │   ├── pois.js               ← Map POI Image Loader
    │   │   ├── context/
    │   │   │   ├── AuthContext.jsx   ← Login, Register, Profile
    │   │   │   └── BookingContext.jsx← Pickup/Drop, Vehicles, Booking
    │   │   ├── hooks/
    │   │   │   ├── useApi.js         ← API Wrapper
    │   │   │   ├── useGeolocation.js ← GPS + Reverse Geocode
    │   │   │   └── useTripPolling.js ← Driver Search + Trip Status
    │   │   ├── components/
    │   │   │   ├── Layout.jsx        ← Header + Footer + Outlet
    │   │   │   ├── Header.jsx        ← Responsive Nav
    │   │   │   ├── Footer.jsx        ← Site Footer
    │   │   │   ├── MapView.jsx       ← MapLibre GL Map
    │   │   │   ├── VehicleCard.jsx   ← Vehicle Selection
    │   │   │   ├── PackageCard.jsx   ← Rental Package
    │   │   │   ├── PromoPicker.jsx   ← Promo Code Modal
    │   │   │   └── PaymentSelector.jsx← Payment Methods
    │   │   ├── pages/
    │   │   │   ├── Home.jsx          ← Hero + Booking Form
    │   │   │   ├── Trip.jsx          ← Map + Vehicle Selection
    │   │   │   ├── Create.jsx        ← Checkout (3 States)
    │   │   │   ├── Searching.jsx     ← Driver Searching Animation
    │   │   │   ├── Accepted.jsx      ← Driver Info + OTP
    │   │   │   ├── Login.jsx         ← Email/Password Login
    │   │   │   ├── Register.jsx      ← Registration
    │   │   │   ├── ForgotPassword.jsx← 3-Step Reset
    │   │   │   ├── Dashboard.jsx     ← Sidebar + 10 Sub-tabs
    │   │   │   ├── MyTrips.jsx       ← Trip History + Filters
    │   │   │   ├── Faq.jsx           ← Accordion FAQ
    │   │   │   ├── PrivacyPolicy.jsx ← Privacy Content
    │   │   │   └── TermsConditions.jsx← Terms Content
    │   │   └── services/
    │   │       └── api.js            ← API Helpers
    │   └── views/
    │       ├── app.blade.php         ← Blade Shell
    │       ├── welcome.blade.php
    │       ├── filament/
    │       │   └── pages/
    │       └── mail_templates/
    ├── routes/
    │   ├── web.php                   ← Web Routes
    │   ├── api.php                   ← API Routes
    │   └── console.php
    ├── storage/
    ├── tests/
    ├── vendor/
    ├── .env                          ← Environment Configuration
    ├── .env.example
    ├── artisan
    ├── composer.json
    ├── composer.lock
    └── README.md

Installation Steps

admin_panel_settings Part 1: Admin Panel (Laravel Filament)

Set up the Laravel backend and Filament admin panel

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., GoCabz_admin).

info
Verify 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\GoCabz_admin
4
Install PHP Dependencies

Run the following command to install all PHP dependencies:

composer install

When finished, verify the vendor folder has been created in your project.
5
Create Database

Follow these steps in phpMyAdmin:
1. Open http://localhost/phpmyadmin in your browser
2. Click "New"
3. Enter your database name (e.g., GoCabz_admin)
4. Click "Create"
6
Import Database

Import the SQL file located at database/GoCabz_admin.sql using phpMyAdmin:
1. In phpMyAdmin, select your newly created database
2. Click the "Import" tab
3. Choose the GoCabz_admin.sql file from your project
4. Click "Go"
7
Generate Application Key

Run the following command to generate a unique application key:

php artisan key:generate

info
Key Generate: This command generates a unique application key that is used for encryption and security purposes.
8
Configure .env File

If .env file is not visible, enable "show hidden files" in your system settings. Update the .env file in your project root with the following settings:
Application Settings

APP_URL=http://localhost:8000 APP_ASSET_URL=http://localhost:8000/storage APP_ENV=local APP_DEBUG=true

Database Configuration

DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=GoCabz_admin DB_USERNAME=root DB_PASSWORD=

Twilio SMS Settings

TWILIO_SID=your_twilio_sid TWILIO_TOKEN=your_twilio_token TWILIO_FROM=your_twilio_number

Razorpay Payment Gateway

RAZORPAY_KEY=your_razorpay_key RAZORPAY_SECRET=your_razorpay_secret
Firebase 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
1. Open the Firebase Console.
2. Select your Firebase Project.
3. Go to Project Settings → Service Accounts.
4. Click "Generate New Private Key".
5. 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:

config/your-app-name.json

Step 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_id

check_circle

Firebase Connected

Once the JSON file is uploaded and the .env values are updated, the application will automatically connect to your Firebase project.

shield

Security 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.
warning
Important: 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 --force

info
The --force flag 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=admin

After 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'; "

info
Shield: 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

web Part 2: React Website (Frontend)

Set up the React frontend website located inside the admin project

13
Configure React Environment

Create a .env file in the website folder and add the following configurations:
# API Configuration (Points to the admin backend) APP_NAME=GoCabz APP_ENV=local APP_KEY=base64:5bU0VTReojFUiriVbqrmY0GH5y2F42OZex7X4luPm/k= APP_DEBUG=true APP_URL=ENTER_YOUR_APP_URL APP_LOCALE=en APP_FALLBACK_LOCALE=en APP_FAKER_LOCALE=en_US APP_MAINTENANCE_DRIVER=file # APP_MAINTENANCE_STORE=database # PHP_CLI_SERVER_WORKERS=4 BCRYPT_ROUNDS=12 LOG_CHANNEL=stack LOG_STACK=single LOG_DEPRECATIONS_CHANNEL=null LOG_LEVEL=debug DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=ENTER_YOUR_DATABASE_NAME DB_USERNAME=ENTER_YOUR_USERNAME DB_PASSWORD=ENTER_YOUR_PASSWORD SESSION_DRIVER=file SESSION_LIFETIME=120 SESSION_ENCRYPT=false SESSION_PATH=/ SESSION_DOMAIN=null BROADCAST_CONNECTION=log FILESYSTEM_DISK=local QUEUE_CONNECTION=sync CACHE_STORE=file # CACHE_PREFIX= MEMCACHED_HOST=127.0.0.1 REDIS_CLIENT=phpredis REDIS_HOST=127.0.0.1 REDIS_PASSWORD=null REDIS_PORT=6379 MAIL_MAILER=smtp MAIL_SCHEME=null MAIL_HOST=smtp.gmail.com MAIL_PORT=587 MAIL_USERNAME=ENTER_YOUR_MAIL_USERNAME MAIL_PASSWORD=ENTER_YOUR_MAIL_PASSWORD MAIL_ENCRYPTION=tls MAIL_FROM_ADDRESS=ENTER_YOUR_MAIL_FROM_ADDRESS MAIL_FROM_NAME="${APP_NAME}" RAZORPAY_KEY=ENTER_YOUR_RAZORPAY_KEY FLUTTERWAVE_PUBLIC_KEY=ENTER_YOUR_FLUTTERWAVE_PUBLIC_KEY PAYSTACK_PUBLIC_KEY=ENTER_YOUR_PAYSTACK_PUBLIC_KEY AWS_ACCESS_KEY_ID= AWS_SECRET_ACCESS_KEY= AWS_DEFAULT_REGION=us-east-1 AWS_BUCKET= AWS_USE_PATH_STYLE_ENDPOINT=false VITE_APP_NAME="${APP_NAME}" FIREBASE_FILE=ENTER_YOUR_FIREBASE_FILE FIREBASE_DB= ENTER_YOUR_FIREBASE_DB FILESYSTEM_DISK=public MODE=DEMO VITE_ROUTEMAPPY_API_URL=ENTER_YOUR_VITE_ROUTEMAPPY_API_URL VITE_ROUTEMAPPY_MAP_KEY=ENTER_YOUR_VITE_ROUTEMAPPY_MAP_KEY
warning
warning
Important:

Update all placeholder values in the .env file before running the application.

Set APP_URL to your application's domain or local URL.

Configure your Firebase credentials and upload the correct Firebase Service Account JSON file.

Configure your payment gateway credentials (Razorpay, Flutterwave, Paystack) only if you plan to use those services.

Replace the RouteMappy API URL and Map Key with your own credentials.

After making changes to the .env file, run php artisan optimize:clear followed by php artisan optimize.
14
Serve Laravel Backend

In a separate terminal, navigate to the admin project root and serve the Laravel backend:

php artisan serve

The Laravel backend runs at http://localhost:8000
15
Access the Applications
- Admin Panel: http://localhost:8000/admin
- React Website: http://localhost:8000
info
Default Login:
- Email: admin@gmail.com
- Password: admin

terminal Complete Setup Quick Reference

Run these commands in sequence to set up both admin panel and website:

admin_panel_settings Admin Panel Setup

# Navigate to admin project
    cd C:\xampp\htdocs\GoCabz_admin

    # Install PHP dependencies
    composer install

    # Generate application key
    php artisan key:generate

    # Run migrations
    php artisan migrate

    # Seed the database
    php artisan db:seed --force

    # Generate Shield permissions
    php artisan shield:generate --all --option=permissions --panel=admin

    # Optimize the application
    php artisan optimize

    # Start Laravel server (in one terminal)
    php artisan serve

web React Website Setup

# Navigate to website folder
    # Create .env file with configurations
    # (Copy .env.example to .env and update values)

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.

Troubleshooting

settings Environment Configuration Issues

If the application is not working correctly, verify:

The .env file exists in the project root.
All required environment variables have been updated with your own credentials.
The APP_URL points to your application URL.
Run php artisan optimize:clear after modifying the .env file.

storage Database Connection Issues

Verify the following:

MySQL service is running.
The database exists in phpMyAdmin.
Database credentials in the .env file are correct.
Run php artisan migrate if the tables have not been created.

folder_off Image & File Upload Issues

If uploaded images or files are not displayed:

Run php artisan storage:link.
Ensure the storage directory has write permission.
Clear the application cache using php artisan optimize:clear.

notifications_active Firebase Notification Issues

If push notifications are not working:

Verify the Firebase Service Account JSON file is placed in the correct location.
Ensure the Firebase values in the .env file are correct.
Confirm that your Firebase project has Cloud Messaging enabled.

cached Configuration & Cache Issues

If recent changes are not reflected:

Run php artisan optimize:clear.
Run php artisan optimize.
Restart the Laravel server using php artisan serve.

palette Website Customization Guide

Customize Everything Through Admin Panel (No Code Changes Required)

info Note: All website content can be managed directly from the Admin Panel. No code changes needed!

1. Website Settings (Hero Section & Branding)

Hero Section on Website

Admin Panel: Dashboard → Website Settings

Go to: Dashboard → Website Settings

Field	Description	Action
Title	Website title/brand name	Edit
Playstore Link	Google Play Store app link	Edit
Appstore Link	Apple App Store app link	Edit
Store Image	App store download images	Add \| Edit
Store Title	App store section title	Edit
Contact Link	Contact page URL	Edit
Website Color	Primary theme color (Hex code) - Changes entire website color scheme	Edit
Facebook Link	Facebook page URL	Edit
Twitter Link	Twitter/X profile URL	Edit
LinkedIn Link	LinkedIn company URL	Edit
Skype Link	Skype contact URL	Edit

Theme Color Customization:

The "Website Color" field accepts Hex color codes (e.g., #4032ae). This color will be applied to:

Primary buttons and CTAs
Navigation links and highlights
Section headings and borders
Icons and accent elements
Hover and focus states
Footer links and branding

Actions: Add | Edit

2. App Details (Mobile App Section)

Mobile App Section on Website

Admin Panel: Dashboard → App Details

Go to: Dashboard → App Details

Field	Description	Action
Title	Mobile app section title	Edit
Image	Mobile app showcase image	Add \| Edit

Actions: Edit

3. Features (Safety Section)

Safety Section on Website

Admin Panel: Dashboard → Features

Go to: Dashboard → Features

Field	Description	Action
Title	Feature title (e.g., "Safe Rides")	Add \| Edit
Image	Feature icon/image	Add \| Edit

Actions: Add | Edit | Delete

4. Our Achievements (Counter Section)

Achievements Counter Section

Admin Panel: Dashboard → Our Achievements

Go to: Dashboard → Our Achievements

Field	Description	Action
Count	Achievement number (e.g., 1000+)	Add \| Edit
Title	Achievement label (e.g., "Happy Customers")	Add \| Edit

Actions: Add | Edit | Delete

5. Trip Types (Choose Your Ride Type - Hero Section)

Trip Types displayed in Hero Section

Admin Panel: Trips → Trip Type

Go to: Trips → Trip Type

Field	Description	Action
Active Icon	Icon when trip type is active	Add \| Edit
Inactive Icon	Icon when trip type is inactive	Add \| Edit
Name	Trip type name (Daily, Rental, Outstation)	Add \| Edit
Vehicle Mode	Vehicle mode for this trip type	Add \| Edit
Status	Active/Inactive status	Toggle

Actions: Add | Edit | Delete

6. Packages (Rental Packages - Hero Section)

Rental Packages in Hero Section

Admin Panel: Fare Management → Packages

Go to: Fare Management → Packages

Field	Description	Action
Name	Package name (e.g., "Economy")	Add \| Edit
Hours	Duration in hours	Add \| Edit
KM	Kilometers included	Add \| Edit
Price	Package price	Add \| Edit
Extra KM	Additional KM charges	Add \| Edit
Extra Hour	Additional hour charges	Add \| Edit
Status	Active/Inactive status	Toggle

Actions: Add | Edit | Delete

7. Vehicle Categories (Premium Taxi & Ride Services)

Vehicle Categories on Website

Admin Panel: Trips → Vehicle Categories

Go to: Trips → Vehicle Categories

Field	Description	Action
Vehicle Type	Type of vehicle (Sedan, SUV, Hatchback)	Add \| Edit
Title	Display title	Add \| Edit
Icon	Vehicle icon	Add \| Edit
Vehicle Mode	Vehicle mode	Add \| Edit
Status	Active/Inactive status	Toggle

Actions: Add | Edit | Delete

8. Vehicle Selection (Trip Details Page)

Vehicle Selection in Trip Details

Admin Panel: Trips → Vehicle Categories

Go to: Trips → Vehicle Categories

Same fields as Vehicle Categories above:

Vehicle Type: Type of vehicle displayed
Title: Display title
Icon: Vehicle icon
Vehicle Mode: Vehicle mode
Status: Active/Inactive status

Note: Same Vehicle Categories used here

9. Promo Codes (Apply Promo - Trip Details Page)

Apply Promo in Trip Details

Admin Panel: Management Group → Promo Codes

Go to: Management Group → Promo Codes

Field	Description	Action
Customer	Customer ID or "All" for everyone	Add \| Edit
Promo Name	Promotion name	Add \| Edit
Promo Code	Discount code (e.g., "SAVE50")	Add \| Edit
Promo Type	Type of promotion	Add \| Edit
Discount	Discount amount/percentage	Add \| Edit
Redemptions	Usage limit (max uses)	Add \| Edit
Status	Active/Inactive status	Toggle

Actions: Add | Edit | Delete

10. Payment Methods (Fare & Payment Page)

Payment Methods on Website

Admin Panel: Payment → Payment Methods

Go to: Payment → Payment Methods

Field	Description	Action
Name	Payment method name (e.g., "Razorpay")	Add \| Edit
Icon	Payment method icon	Add \| Edit
Type	Internal or External	Add \| Edit
Status	Active/Inactive status	Toggle

Actions: Add | Edit | Delete

11. Fare Management (Daily, Rental, Outstation)

Admin Panel: Fare Management

Go to: Fare Management → [Daily / Rental / Outstation] Fare

A. Daily Fare Managements

Field	Description	Action
Vehicle Type	Select vehicle category	Dropdown
Zone	Service zone	Dropdown
Base Fare	Minimum fare	Add \| Edit
Base KM	Base distance included	Add \| Edit
Price Per Km	Rate per kilometer	Add \| Edit
Status	Active/Inactive status	Toggle

Actions: Add | Edit | Delete

B. Rental Fare Managements

Field	Description	Action
Vehicle	Select vehicle category	Dropdown
Package	Select rental package	Dropdown
Price	Package price	Add \| Edit
Per KM	Additional KM charges	Add \| Edit
Per Hour	Additional hour charges	Add \| Edit
Status	Active/Inactive status	Toggle

Actions: Add | Edit | Delete

C. Outstation Fare Managements

Field	Description	Action
Vehicle	Select vehicle category	Dropdown
Trip Type	One way or Round trip	Dropdown
Base Fare	Minimum fare	Add \| Edit
Per KM	Rate per kilometer	Add \| Edit
Allowance	Distance allowance	Add \| Edit
Status	Active/Inactive status	Toggle

Actions: Add | Edit | Delete

12. Testimonials

Testimonials Section

Admin Panel: Contact Group → Testimonials

Go to: Contact Group → Testimonials

Field	Description	Action
Name	Customer/Driver name	Add \| Edit
Avatar	Profile image	Add \| Edit
Comments	Testimonial text	Add \| Edit
Role	Customer or Driver	Add \| Edit

Actions: Add | Edit | Delete

13. Footer (Contact Settings)

Footer Section

Admin Panel: Setting Group → Contact Settings

Go to: Setting Group → Contact Settings

Field	Description	Action
Phone Number	Contact phone number	Edit
Email	Contact email address	Edit
Address	Physical address	Edit

Social Links: Dashboard → Website Settings (Facebook, Twitter, LinkedIn, Skype)

Logo: Dashboard → Website Settings (Title, Store Image)

Actions: Edit

14. CMS Content (FAQs, Policies)

Admin Panel: Contact Group

Go to: Contact Group → [Section]

FAQs

Field	Description	Action
Question	Frequently asked question	Add \| Edit
Answer	Answer to the question	Add \| Edit

Actions: Add | Edit | Delete

How It Works

Field	Description	Action
Title	Step title	Add \| Edit
Description	Step description	Add \| Edit
Icon	Step icon	Add \| Edit
Status	Active/Inactive status	Toggle

Actions: Add | Edit | Delete

Privacy Policies

Field	Description	Action
User Type	Customer or Driver	Add \| Edit
Title	Policy title	Add \| Edit
Status	Published/Draft status	Toggle

Actions: Add | Edit | Delete

Terms and Conditions

Field	Description	Action
Title	Terms section title	Add \| Edit
Description	Terms content	Add \| Edit

Actions: Add | Edit | Delete

Theme Color Customization

How to Change Theme Color

Go to Dashboard → Website Settings
Find the "Website Color" field
Enter a valid Hex color code (e.g., #4032ae, #ff6b35, #00b894)
Save the changes
The website will automatically update with the new color scheme

Where the Theme Color Applies

Primary buttons and call-to-action elements
Navigation links and active states
Section headings and borders
Icons and accent elements
Hover and focus states on interactive elements
Footer links and branding
Highlight boxes and notification badges
Progress bars and loading indicators

Pro Tip: Use tools like Coolors or Color Hunt to find the perfect color combination for your brand.

Quick Reference - Where to Customize

#	Website Section	Admin Panel Location	Actions
1	Hero Section & Branding	Dashboard → Website Settings	Add \| Edit
🎨	Theme Color	Dashboard → Website Settings → Website Color	Edit (Hex Code)
2	Mobile App Section	Dashboard → App Details	Edit
3	Safety Features	Dashboard → Features	Add \| Edit \| Delete
4	Achievements Counter	Dashboard → Our Achievements	Add \| Edit \| Delete
5	Trip Types (Hero)	Trips → Trip Type	Add \| Edit \| Delete
6	Rental Packages (Hero)	Fare Management → Packages	Add \| Edit \| Delete
7	Vehicle Categories	Trips → Vehicle Categories	Add \| Edit \| Delete
8	Vehicle Selection (Trip Details)	Trips → Vehicle Categories	Add \| Edit \| Delete
9	Promo Codes	Management Group → Promo Codes	Add \| Edit \| Delete
10	Payment Methods	Payment → Payment Methods	Add \| Edit \| Delete
11	Fare Settings	Fare Management → Daily/Rental/Outstation	Add \| Edit \| Delete
12	Testimonials	Contact Group → Testimonials	Add \| Edit \| Delete
13	Footer (Contact)	Setting Group → Contact Settings	Edit
14	FAQs, Policies	Contact Group	Add \| Edit \| Delete

lightbulb Pro Tip: All changes made in the admin panel reflect instantly on the website. No need to rebuild or redeploy! The Website Color field allows you to completely rebrand the website's look and feel with just a single color change.

directions_car Driver Application

info

Driver Application Setup

This guide explains how to install, configure and run the Driver application on both Android and iOS devices. Follow every step carefully before building the application.

Prerequisites

Step 1: Install Node.js

Download and install Node.js from the official website.

https://nodejs.org/en/download

# Verify Installation

node -v
npm -v

Step 2: Install Android Studio

Download Android Studio from the official website.

https://developer.android.com/studio

Install Android SDK.
Install Build Tools.
Create an Android Virtual Device (AVD).
Configure Android environment variables.

Step 3: Install Xcode (iOS Only)

Download Xcode from the Mac App Store.
Install Command Line Tools.
Create an iOS Simulator.

Setup & Installation

Step 1: Copy Driver Folder

Copy the Driver folder into your preferred location.

info

Note: If you rename the folder, remember to update the Bundle ID before building the application.

Step 2: Install Dependencies

Open terminal inside the Driver application and run:

npm install

If you use Yarn, execute:

yarn install

Step 3: Install iOS Pods

Navigate into the iOS folder.

cd ios

pod install

Step 4: Run the Application

Android

npx react-native run-android

iOS

npx react-native run-ios

check_circle

The Driver application will launch on your connected device or emulator after the build completes successfully.

app_registration App Name & Icon

info

Customize Your Application

You can personalize the Driver application by changing the app name and launcher icon before publishing it to the Play Store or App Store.

Changing App Name

For Android, open the following file:

folder_open Driver/android/app/src/main/res/values/strings.xml

<string name="app_name">Your App Name</string>

Replace Your App Name with the name you want to display on the device home screen.

iOS App Name

Open the following project in Xcode:

folder_open ios/DriverApp.xcodeproj

Select the Driver application target.
Open the General tab.
Update the Display Name.
Save the project.

Changing App Icon

Replace the default launcher icons with your own branded icons.

android Android Launcher Icon

Replace all icons inside android/app/src/main/res/mipmap-*.
Replace adaptive icons in mipmap-anydpi-v26.
Keep the same file names.
Do not change folder names.

phone_iphone iOS App Icon

Open the project using Xcode.
Navigate to Assets.xcassets → AppIcon.
Replace all required icon sizes.
Build the application again.

warning

Make sure all launcher icons follow Android and Apple size guidelines. Incorrect icon dimensions may cause build or submission errors.

check_circle

Your application name and launcher icon have been successfully customized. Rebuild the application to see the updated branding.

package Package Name Configuration

info

Change Your Application Package Name

Before publishing your application, update the package name (Android) and Bundle Identifier (iOS) so your application has a unique identity on Google Play and the App Store.

Android Configuration

Open the following file:

folder_open Driver/android/app/build.gradle

android {

    defaultConfig {

        applicationId "com.yourcompany.yourapp"

    }

}

Update the following locations:

applicationId inside build.gradle
package name inside AndroidManifest.xml
Java/Kotlin package folders if required
MainActivity package declaration
MainApplication package declaration

iOS Configuration

Open the following project:

folder_open ios/DriverApp.xcodeproj

Select the Driver project.
Select the application target.
Open the General tab.
Update the Bundle Identifier.
Ensure all targets use the same Bundle Identifier.

warning

Never use a package name that already exists on Google Play or App Store. Every published application must have a unique package name.

error

Important: If you change the package name after publishing your application, Google Play and Apple App Store will treat it as a completely new application.

check_circle

After updating the package name and bundle identifier, clean the project and rebuild the application before generating a release build.

construction Custom Work

If you require additional features, UI changes, third-party integrations, new modules, or any other customization that is not included in the default package, our development team can help tailor the application to your business requirements.

build Custom Development Services

New feature development
UI/UX customization
Payment gateway integration
SMS & Email service integration
Map provider integration
API integration with third-party services
Mobile application customization
Admin panel enhancements
Performance optimization
Deployment assistance

Contact Us

For custom development requests, please contact our team using the details below.

language

Website

https://menpanitech.com/

mail

Email

sales@menpanitech.com

info

Note: Custom development services are not included with the regular purchase. The implementation cost and delivery time depend on the complexity of the requested features.

history Version History

new_releases Initial Release

This is the first official release of the GoCabz platform, introducing the core functionality required to operate a complete taxi booking and ride-hailing solution.

new_releases

Version 1.0.0

Initial Release

calendar_today March 2024

rocket_launch
Initial Application Release
First stable release of the GoCabz Driver Application.
verified_user
Driver Registration & Login
Drivers can register, log in securely, and manage their profiles.
local_taxi
Ride Acceptance & Navigation
Accept ride requests, navigate to pickup and destination locations, and complete trips efficiently.
account_balance_wallet
Earnings Management
View completed trips, earnings, and payment history directly from the driver application.

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.json file
Place the file in: GoCabz_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.GoCabz

Android

Update in:

folder_open android/app/build.gradle

applicationId "com.clientname.GoCabz"

Rename the Java package directory:

folder_open android/app/src/main/java/com/clientname/GoCabz

key Keystore Configuration

Generate a signing keystore:

keytool -genkey -v \
    -keystore GoCabz.keystore \
    -alias GoCabz \
    -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=GoCabz.keystore
MYAPP_UPLOAD_KEY_ALIAS=GoCabz
MYAPP_UPLOAD_STORE_PASSWORD=yourpassword
MYAPP_UPLOAD_KEY_PASSWORD=yourpassword

rocket_launch Android Release Build

Generate APK

cd android
./gradlew assembleRelease

APK location: android/app/build/outputs/apk/release/app-release.apk

Generate Play Store Bundle

cd android
./gradlew bundleRelease

Output: 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.

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: Download Configuration File

GoogleService-Info.plist

Step 2: Add File to Project

Place the downloaded file inside the following directory:

folder_open ios/GoCabz/GoogleService-Info.plist

Steps in Xcode:

Open the iOS project in Xcode.
Drag and drop the GoogleService-Info.plist file into the Project Navigator.
Select "Copy items if needed" when prompted.
Ensure the file is added to the main application target.

This configuration enables Firebase services such as push notifications and analytics.

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.

Steps:

Open the project in Xcode: ios/GoCabz.xcworkspace
Select the main application target.
Go to the General tab.
Update the Bundle Identifier field.

Example: com.clientname.taxiapp

Ensure that the Bundle Identifier matches exactly with the one used in the Firebase configuration file, otherwise services may not work correctly.

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/GoCabz/Images.xcassets/AppIcon.appiconset

Replace all icon sizes inside this folder with your custom icons while maintaining the required dimensions.

iOS 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.

Step 1: Start Metro Server

npm start

Step 2: Run iOS App

npx react-native 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.

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/GoCabz.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.

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/GoCabz/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

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

RouteMappy maps integration requires a valid API key. Please contact RouteMappy directly for licensing and pricing information:

Website: https://routemappy.com/
Email: sales@menpanitech.com

Mobile Application Configuration

Step 1: Add Your API Key

Edit the following file:

folder_open GoCabz/src/config/Constants.js

export const ROUTEMAPPY_API_KEY = 'enter_your_routemappy_key';

info

RouteMappy maps integration requires a valid API key. Please contact RouteMappy directly for licensing and pricing information:

Website: https://routemappy.com/
Email: sales@menpanitech.com

payments Payment Integration

Library Used

react-native-razorpay
flutterwave-react-native

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.

info
Note: You must have 2-Step Verification enabled to generate an App Password.
Step 3: Generate App Password

While still in the Security section:
1. Find the "App passwords" option (under 2-Step Verification)
2. Click "create"
3. 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 devices

Confirm 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:\GoCabz_customer

Install project dependencies:

npm install

Execute the application:

npx react-native run-android

help_outline FAQ & Troubleshoot

Frequently Asked Questions & Troubleshooting

quick_reference Quick Navigation

Installation Firebase Environment Android Maps Drivers Payment Notifications Admin Panel Website

1. Installation Dependencies Failed (`npm install` or `composer install`)

Cause: Missing or outdated Node.js/PHP version, unstable internet connection, or running commands from the wrong directory.

Solution:

Ensure Node.js (v20+) and PHP (8.3+) are installed and updated.
Open terminal inside the project root directory.
For React website dependencies:

npm install

For Laravel backend dependencies:

composer install

If the issue persists:

rm -rf node_modules package-lock.json
npm install

✓ Success Indicator: After successful installation, you should see a node_modules folder and vendor folder created.

2. Module Not Found Error (React Website)

Cause: Missing dependencies, incorrect import paths, or incomplete project extraction.

Solution:

Verify all project files are extracted correctly.
Check import paths in resources/js/ files.
Reinstall dependencies:

npm install

Clear Vite cache:

npm run build

3. Firebase Configuration Issues

Cause: Firebase project setup is incomplete or configuration files are missing.

Solution:

Verify Firebase project settings in Firebase Console.
For Admin Panel: Place firebase.json in config/ directory.
For Driver App: Download and configure:
- google-services.json (Android)
- GoogleService-Info.plist (iOS)
Ensure Firebase Cloud Messaging (FCM) is enabled for push notifications.
Verify package names and bundle identifiers match Firebase configuration.

💡 Tip: Always download the latest configuration files from Firebase Console. Old files may contain outdated credentials.

4. Environment Variables Not Configured

Cause: Missing or incomplete environment configuration in .env file.

Solution:

Copy .env.example to .env.
Configure all required values:

APP_URL=ENTER_YOUR_APP_URL
DB_DATABASE=citycabz
RAZORPAY_KEY=ENTER_YOUR_RAZORPAY_KEY
FIREBASE_FILE=ENTER_YOUR_FIREBASE_FILE
VITE_ROUTEMAPPY_API_URL=ENTER_YOUR_ROUTEMAPPY_API_URL

Run php artisan optimize:clear after updating .env.
Restart the Laravel server.

⚠️ Important: Never commit your .env file to version control. It contains sensitive credentials.

5. Android Device Not Detected

Cause: USB debugging is disabled or device drivers are not installed.

Solution:

Enable Developer Options on your Android device.
Enable USB Debugging.
Connect the device using a supported USB cable.
Verify detection:

adb devices

Accept the authorization prompt on the device.

6. RouteMappy Map Not Displaying

Cause: RouteMappy configuration is incomplete or map services are unavailable.

Solution:

Verify RouteMappy configuration settings in .env:

VITE_ROUTEMAPPY_API_URL=ENTER_YOUR_ROUTEMAPPY_API_URL
VITE_ROUTEMAPPY_MAP_KEY=ENTER_YOUR_ROUTEMAPPY_MAP_KEY

Check internet connectivity.
Confirm location permissions are enabled on the device.
Verify map settings from Admin Panel → Map Settings.
Contact RouteMappy support at sales@menpanitech.com if API access or licensing assistance is required.

7. Driver Registration Remains Pending

Cause: Driver account is awaiting administrator approval.

Solution:

Login to Admin Panel.
Navigate to: Driver Management → Documents
Review uploaded documents (Driving License, Vehicle Documents, Identity Proof).
Approve or reject the registration.
The Driver will receive a push notification after approval.

8. Payment Gateway Not Working

Cause: Payment credentials are incorrect or payment methods are disabled.

Solution:

Verify payment gateway credentials in .env:

RAZORPAY_KEY=ENTER_YOUR_RAZORPAY_KEY
FLUTTERWAVE_PUBLIC_KEY=ENTER_YOUR_FLUTTERWAVE_PUBLIC_KEY
PAYSTACK_PUBLIC_KEY=ENTER_YOUR_PAYSTACK_PUBLIC_KEY

Confirm gateway status is enabled in Admin Panel → Payment Settings.
Check configuration under Payments → Payment Types.
Test using sandbox credentials before going live.

9. Push Notifications Not Working

Cause: Firebase Cloud Messaging (FCM) is not configured properly.

Solution:

Verify Firebase project configuration.
Confirm FIREBASE_FILE and FIREBASE_DB are set in .env.
For Driver App: Ensure google-services.json (Android) or GoogleService-Info.plist (iOS) is placed correctly.
Ensure notification permissions are granted on the device.
Test notifications from Admin Panel → Notifications.
Verify device internet connectivity.

10. OTP Verification Not Received

Cause: SMS service provider configuration is incomplete or delayed.

Solution:

Verify SMTP mail settings in .env:

MAIL_USERNAME=ENTER_YOUR_MAIL_USERNAME
MAIL_PASSWORD=ENTER_YOUR_MAIL_PASSWORD

Confirm mobile number format is correct.
Check SMS provider balance and status (if using Twilio).
Retry OTP after a few minutes.

11. Customer or Driver Unable to Login

Cause: Incorrect credentials, inactive account, or account suspension.

Solution:

Verify registered mobile number or email.
Reset password using the Forgot Password option.
Ensure account status is active in Admin Panel.
Verify OTP services are functioning properly.

12. Ride Requests Not Appearing for Drivers

Cause: Driver availability, service area, or status configuration is incorrect.

Solution:

Verify Driver account is approved.
Check if Driver is online (availability toggled ON).
Confirm service area coverage in Admin Panel → Zone Management.
Ensure Driver status is active.
Check if there are active ride requests in the system.

13. Laravel Admin Panel 500 Error

Cause: PHP version mismatch, missing dependencies, or permission issues.

Solution:

Verify PHP version is 8.3+.
Run composer install to install all dependencies.
Run php artisan key:generate.
Run php artisan migrate.
Set proper permissions for storage and bootstrap/cache.
Check Laravel logs at storage/logs/laravel.log for detailed errors.

14. Images or Banners Not Uploading

Cause: File size exceeds server limits or unsupported file format.

Solution:

Upload supported image formats (JPG, PNG, WEBP).
Reduce image size.
Run php artisan storage:link to create symbolic link.
Verify upload permissions on the server.
Check storage availability.

15. Admin Panel Not Loading After Installation

Cause: Missing configuration, incorrect .env values, or database connection issues.

Solution:

Verify .env configuration is complete.
Ensure database credentials are correct.
Run php artisan optimize:clear.
Run php artisan optimize.
Restart the Laravel server: php artisan serve.
Check Laravel logs for detailed errors.

16. Real-time Chat Not Working

Cause: Firebase Realtime Database configuration issues.

Solution:

Verify FIREBASE_DB URL is correct in .env.
Ensure Firebase Realtime Database is enabled.
Check database security rules allow read/write.
Verify the Firebase Service Account has proper permissions.
Check network connectivity.

17. Dynamic Fare Not Calculating Correctly

Cause: Fare configuration is incomplete or incorrect.

Solution:

Go to Admin Panel → Fare Management.
Configure Daily, Rental, and Outstation fare settings.
Set base fare, distance fare, waiting charges, night charges, and toll charges.
Save changes and test with a new ride booking.

18. RouteMappy API Key Not Working

Cause: Invalid API key or incorrect configuration.

Solution:

Verify API key is valid and active.
Contact RouteMappy team for support: sales@menpanitech.com
Ensure API key has required permissions enabled.
Check if API key has domain/IP restrictions that may block requests.

19. Customer Website Not Loading After Deployment

Cause: Vite build not generated or incorrect asset paths.

Solution:

Run npm run build to build frontend assets.
Ensure APP_URL in .env is correct.
Check if resources/views/app.blade.php has the correct Vite directives.
Clear Laravel cache: php artisan optimize:clear.
Restart the Laravel server.

20. Driver Location Not Updating in Real-time

Cause: GPS permissions or location tracking configuration issues.

Solution:

Ensure GPS permission is granted on the device.
Verify location tracking is enabled in Driver App settings.
Check internet connectivity.
Verify backend API endpoints are accessible.
Check if driver is online.

21. Website Customization Changes Not Reflecting

Cause: Cache issues or incorrect settings in Admin Panel.

Solution:

Clear browser cache or use Incognito/Private mode.
Clear Laravel cache: php artisan optimize:clear.
Verify the setting was saved in Admin Panel.
For theme color: Ensure you're using a valid Hex color code (e.g., #4032ae).
For images: Ensure uploaded images are in supported formats (JPG, PNG, WEBP).
Run php artisan storage:link if images are not displaying.
Check if APP_URL in .env matches your domain.

💡 Tip: After making changes in the Admin Panel, use php artisan optimize:clear and php artisan optimize to ensure all caches are cleared.

22. Website Settings Not Saving in Admin Panel

Cause: Database connection issues or permission problems.

Solution:

Verify database credentials in .env are correct.
Check if the settings table exists in the database.
Ensure the storage directory has write permissions.
Check Laravel logs at storage/logs/laravel.log for errors.
Run php artisan migrate if tables are missing.
Restart the Laravel server after making changes.

23. Social Media Links in Footer Not Working

Cause: Invalid URLs or missing social media links in Website Settings.

Solution:

Go to Admin Panel → Dashboard → Website Settings.
Verify the social media URLs are correct (e.g., https://facebook.com/yourpage).
Ensure the URLs are full URLs including https://.
Clear cache after updating: php artisan optimize:clear.
Check if the social media platforms are enabled and active.

support_agent Need Additional Help?

If you encounter any issues that are not covered in this documentation, please contact our support team.

Support Email:

sales@menpanitech.com

Support Hours:

Monday – Friday

Response Time: Within 24–48 Business Hours

Please include the following information when contacting support:

Purchase Code
Application Version
Server Information (PHP version, OS, etc.)
Error Screenshot (if available)
Detailed Issue Description

This will help us provide faster and more accurate assistance.

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