CarryGO - React Native Ride and Delivery Apps

Launch Your Own Production-Ready Mobility Startup Instantly

CarryGO is a complete, production-ready, 3-in-1 software ecosystem for on-demand ride-hailing and parcel delivery. Built with industry-standard modern frameworks, this repository gives you the entire full-stack foundation needed to compete with industry giants like Uber, Bolt, and Glovo at a fraction of the development cost.

Stop spending thousands of dollars and months of development time coding real-time dispatch systems, payment rails, and state management from scratch.

What's Included in the Bundle

You get full, unrestricted access to four core engineering modules:

• Customer Mobile App: Cross-platform React Native app featuring real-time map navigation, automated vehicle selection, order tracking, and an integrated digital wallet.
• Driver Mobile App: Cross-platform React Native app featuring trip requests, persistent active mapping, earnings tracking panels, and automated profile verification workflows.
• Admin Web Dashboard: A comprehensive web console built for fleet managers to oversee operational financials, audit driver sign-ups, adjust active promo configurations, and monitor system-wide support tickets.
• Robust Backend & Infrastructure: A high-performance Node.js REST API layer optimized with Redis caching, real-time WebSocket communication channels, and automated dispatch routing services.

Premium Core Features Built-In

• Integrated Digital Wallet: Built-in balance top-up flows to capture user revenue and facilitate seamless cash-free bookings.
• Real-Time Fleet Dispatch: Uses persistent WebSockets for live driver-to-rider matching and precise geo-tracking.
• Dynamic Pricing & Schedule Architecture: Native logic built to support immediate bookings, scheduled trips, and smart distance pricing.
• Premium Animated Splash Screen: Replaces generic image logos with a high-performance, fluid animated text welcome sequence built directly into the React Native mobile clients.

Enterprise-Grade Tech Stack

• Frontend Mobile Framework: React Native (Expo)
• Web Panel Framework: React (Single Page Application architecture)
• Backend Server: Node.js / Express
• Caching & Live Queueing: Redis
• Real-time Layer: Socket.io / WebSockets
• Database Management: MongoDB / Mongoose

Why Buy This Template?

• Clean & Generic Code: All environment configurations are separated into standard template variables. Zero hardcoded credentials or rigid branding.
• Save 400+ Hours: Skip setting up boilerplate logic, database authentication middleware, payment gateways, and intricate map states.
• Developer-Friendly Architecture: Fully organized folder layouts making it easy to integrate custom localized options like Paystack, Flutterwave, or Stripe.

Get instant access to the source code zip bundle immediately after checkout. Start self-hosting and scaling your logistics business today.

Features

• Dual-Service Engine: Seamless support for both immediate passenger trips (Ride-Hailing) and logistics parcel fulfillment (Delivery) inside a single application.
• Live Geo-Tracking: Instant real-time driver positioning updates map-rendered seamlessly via persistent WebSockets.
• In-App Closed-Loop Wallet: Native consumer digital wallet ecosystem supporting fund top-ups, transaction logging, and automated cashless ledger deduction.
• Driver Earning Tracking: Interactive tracking components for drivers to monitor historical earnings over custom date frames alongside instant ride payouts.
• Promo Code Infrastructure: Flexible operational control options for defining system-wide percentage or flat-rate discount vouchers.
• Flexible Multi-Language Platform: Native localized i18n localization support loaded with pre-configured localization trees (English, French, and Arabic).
• Automated Dispatch Router: Highly scalable location location polling middleware engine pairing the closest vacant transport partner instantly.
• Dynamic Vehicle Category Selector: Configure custom operational tiers (Economy, Business, Delivery Bike) directly from your central interface.
• Complete Support Desk: Embedded administrative support modules capable of handling localized dispute resolutions and system-wide account deletions.

Requirements

To successfully customize, execute, and scale this deployment framework, developers should have the following minimum environmental pre-requisites installed locally:

• Node.js Environment: Version 18.x LTS or higher installed globally.
• Containerization Engine: Docker Engine & Docker-Compose (Highly recommended for fast infrastructure orchestration setup).
• Database Access: An active instance of MongoDB (Local setup or free cluster hosting via MongoDB Atlas).
• Memory Optimization Layer: Redis Server instance running locally or via fully-managed remote service.
• Mobile Compilation Framework: React Native Development Environment setup (Expo framework including Android Studio SDK tools / Apple Xcode tools).
• Google Maps Platform API Keys: Valid application project credentials highlighting actively configured Maps SDK for Android/iOS, Directions API, and Geocoding endpoints.

Instructions

Setting up the environment requires three quick phases:

Phase 1: Environment Token Initialization

1. Copy the contents of .env.example located in /CarryGO/backend/ and save as a brand new configuration file named .env.
2. Fill out your target system port variables, database connection strings, your localized encryption token secrets, and Redis entry points.
3. Mirror this setup step for target .env.example configurations nested respectively within /admin-dashboard/, /customer-app/, and /driver-app/.
4. Important Wireless Note: In the mobile apps' .env configuration files, make sure to replace localhost with your computer's actual local wireless IP address (e.g., 192.168.x.x). This allows your physical devices to communicate seamlessly over your shared Wi-Fi network.

Phase 2: Local Server Deployment

1. Navigate directly into the terminal root path of the project folder: cd CarryGO.
2. Spin up your entire background microservice container orchestration immediately via docker setup automation: docker-compose up --build -d.
3. Alternative Manual Launch: Step inside /backend/ and invoke command loops npm install followed directly by npm start.

Phase 3: Client Interfaces Execution & Expo Go Testing

1. Open up separate console environments focusing on your visual app interfaces.
2. For Admin Web Dashboard: Navigate to /admin-dashboard/, run npm install, then input npm start to spawn your dashboard portal locally at http://localhost:3000.
3. For Mobile Apps Setup: Access either mobile workspace root directories (/customer-app/ or /driver-app/). Heavy dependency folders have been cleanly excluded from the source code for security; simply trigger the package installation sequence using npm install to restore your workspace using the locked versions inside package-lock.json.
4. Launch development server: Make sure your physical mobile testing device is connected to the exact same wireless Wi-Fi network as your host development machine. Launch the runtime environment with the tunnel compilation flag by executing: npx expo start --tunnel.
5. Scan and Run: Open up the official Expo Go app on your iOS or Android mobile hardware, use the built-in viewfinder camera mode to scan the terminal window's active QR code engine, and instantly begin cross-platform live system testing.

App White-Labeling & Reskinning Details

• App Name & Package Identifiers: Configured cleanly within the root app.json or app.config.js under the global "name", "android.package", and "ios.bundleIdentifier" parameter strings.
• Branding Colors: Fully customizable in the centralized theme layout engine location at /src/theme/index.js. Changing the hex codes changes system-wide buttons and accents instantly.
• Icons & Splash Screens: Replace static placeholders located inside the /assets/ project directories with your custom matching elements while maintaining standard image file square dimensions.
• Core Strings & Languages: Modify structural translation maps nested directly inside /src/i18n/ (supports English, French, and Arabic configuration matrices).

Production Signed Native Build Deployment

This codebase uses Expo Application Services (EAS CLI) cloud execution grids to compile native signed distributions effortlessly:

1. Install and log into the global compilation helper: npm install -g eas-cli && eas login
2. Configure your deployment infrastructure profile maps: eas build:configure
3. Build a signed Android production bundle (.aab): eas build --platform android --profile production
4. Build a signed iOS App Store distribution package (.ipa): eas build --platform ios --profile production