First-Time Setup
Fill in these settings once, in this order, before you take real rides. Each one is a page in the admin panel. No code and no database editing.
Step 3 in order
First sign in to the admin panel (3.1). The first account that signs in becomes the main admin. Then work through the settings below, one page each, in this order (3.2 to 3.13).
Almost every setting lives under System ManagementSettings near the bottom of the left menu. The Settings page has its own second menu, grouped into App Setup, Business Rules, Integrations, Content & Pages and Support. Zones and vehicle types have their own items in the main menu.
- 1Settings in the left menu. It opens the list of settings pages.
- 2App Setup: General Settings, App Theme, App Settings, Map Settings, Languages, Maintenance Mode.
- 3Business Rules: Business Model, Driver & Ride, Bank Form, Commute Pass, Surge Pricing, Taxes, Currency.
- 4Integrations: Payment and SMTP Settings. Content & Pages and Support follow below.
- 5The page you picked opens here. Each page has its own Save button.
Do these in order#
Do not skip a step
A missing zone, vehicle fare, currency or payment setting is the most common reason the customer app shows "Service is not Available in Pickup Location Area", prices of 0, or cannot take a payment. Tick each one in the Setup checklist as you go.
Why each step matters#
| # | Step | Why it matters |
|---|---|---|
| 1 | Sign in to the admin panel | The panel has no sign-up page. The first email and password that sign in to a new project become the main admin account. Do it before anyone else can open your panel. |
| 2 | General settings & branding | Without the push keys and the service account file, no ride notification reaches a phone. Without the Google client ID, "Sign in with Google" fails. App Theme sets the app name, the colour of each app and the minimum app version. |
| 3 | Currency | Every fare, wallet and payout amount is shown with the active currency's symbol and decimals. |
| 4 | Zones | Customers can only book when the pickup point is inside an active zone, and only drivers who work in that zone get the request. Each zone can have its own prices. |
| 5 | Vehicle types & fares | The cab categories customers choose from (Bike, Sedan, SUV…) and the price of each one in each zone: minimum fare, per km, per minute, waiting and night charges. |
| 6 | Commission & subscriptions | Decides how you earn: a commission on every ride, a paid plan drivers must buy, or both. Also the cancellation fee and the ride OTP. |
| 7 | Payment gateways | Turns on cash, wallet and the online gateways (Stripe, PayPal, Razorpay and others) with your own keys. |
| 8 | Map settings | Picks OpenStreetMap or Google Maps for search, routes and distances, and stores the Google Maps key. |
| 9 | Driver & ride settings | Driver document checks and auto approval, km or miles, the radius used to find drivers, the minimum wallet balance to accept rides and the auto-cancel timer. |
| 10 | Email & SMTP | The outgoing mail server used for emails sent by the platform. |
| 11 | Taxes | Fixed or percentage taxes per country, added on top of every fare. |
| 12 | Content pages & reasons | About, Privacy Policy, Terms, Contact Us, the landing page texts, and the reasons customers pick when they cancel or ask for help. |
| 13 | Maintenance mode | Closes the customer app and/or the driver app with a message, so nobody uses them before you are ready. |
All settings at a glance#
Every page in the Settings menu, and where it is explained.
| Settings page | What you set there | Guide |
|---|---|---|
| General Settings | Notification Sender Key, Web Notification Key, Google login client ID, service account JSON file | General settings |
| App Theme | Customer app colour, driver app colour, app name in every language, minimum app versions and store links | General settings |
| App Settings | Default country code, refer credit, SOS number, wallet limits, loyalty points, intercity radius, night timing | General settings |
| Map Settings | Map type and Google Maps key | Map settings |
| Languages | Languages, translations, right-to-left | Languages & RTL |
| Maintenance Mode | Close the customer or driver app with a message | Maintenance mode |
| Business Model Settings | Admin commission, cancellation charge, negative wallet limit, ride OTP, subscription plans on or off | Commission & subscriptions |
| Driver & Ride Settings | Document verification, auto approval, distance unit, radius, map home screens, ride cancel timer | Driver & ride settings |
| Bank Form Settings | The bank fields drivers fill in for payouts | Payout requests |
| Commute Pass Settings | Rules for customer ride passes | Commute Pass |
| Surge Pricing | Busy-time price multipliers | Surge pricing & zones |
| Taxes | Tax name, country, fixed or percentage | Taxes |
| Currency | Currencies, symbol, decimals, the one in use | Currency |
| Payment | Cash, wallet and online gateways | Payment gateways |
| SMTP Settings | Outgoing email server, test email | Email & SMTP |
| Landing Page, About App, Privacy Policy, Terms & Condition, Contact us | Texts shown in the apps and on the landing page | Content pages |
| Canceling Reason, Help Reason | Reasons customers choose when they cancel or ask for help | Content pages |
Two setup items are in the main left menu instead: Zone ManagementZone and Vehicle ManagementVehicle Type.
Changes go live at once
Settings are saved to your Firebase project. The apps read them when they start, so a change shows up the next time a customer or driver opens the app. There is nothing to rebuild.
The setup tool already filled in examples
The setup tool imported example data: a few vehicle types with fares, the zones Surat, Bhavnagar and WorldWide, INR and USD currencies, a 10 % commission and more. Go through each page and replace the examples with your own values before you launch.
