🚖 Uber Clone - React Native App

A fully functional Uber-like ride booking app built with React Native (CLI + Expo).

✨ Features

• 🌍 Multilingual support (LTR + RTL)
• 🌙 Light/Dark themes
• 📍 Real-time ride tracking with Google Maps
• 🔌 Live location updates via sockets
• ⚡ Built on a scalable boilerplate foundation – rn_boilerplate

🗂 Tech Stack

• Frontend: React Native (CLI + Expo)
• Backend: Node.js + Express
• Maps & Location: Google Maps SDK + Background Location
• APIs: REST APIs + Swagger Documentation

🚀 Extra

• Dark mode & RTL layouts
• Multi-language support
• Lifetime free updates (new features included)

---

🔗 Boilerplate: rn_boilerplate

---

🚀 How to Run

Follow these steps to set up and run the app:

🗂️ Step 1: Unzip the Project

Unzip the downloaded folder.

📂 Step 2: Navigate to the rn_cli Project Directory

cd uberclone

📦 Step 3: Install Dependencies

npm install

▶️ Step 4: Start Metro Bundler

npm start

📱 Step 5: Run on Android

npm run android

🍎 Step 6: Run on iOS

npm run ios

---

🔑 Google Maps API Setup

To enable maps:

✅ 1. Add your Google Maps API Key

Edit the following file:

// src/config/keys.ts
export const GOOGLE_MAP_API_KEY = 'PASTE_YOUR_API_KEY_HERE';

✅ 2. Android Setup

Add this in android/app/src/main/AndroidManifest.xml:

<meta-data
  android:name="com.google.android.geo.API_KEY"
  android:value="PASTE_YOUR_API_KEY_HERE"/>

✅ 3. iOS Setup

In ios/rn_boilerplate/AppDelegate.swift, inside application(...) method:

GMSServices.provideAPIKey("PASTE_YOUR_API_KEY_HERE")

---

1. Expo Setup

🛑 Important Note: This project uses native dependencies and cannot run in Expo Go. You must use the development build created by npx expo prebuild.

1. Create Environment File

   # Copy the example environment file
   cp env.example.js .env
   

2. Configure Environment Variables

   Edit the .env file in the root folder and add your API keys:

   EXPO_PUBLIC_GOOGLE_MAP_KEY="YOUR_GOOGLE_MAPS_API_KEY"
   EXPO_PUBLIC_LICENSE_KEY="YOUR_LICENSE_KEY"
   

2. Installation & Build

1. Install Dependencies

   npm install
   

2. Prebuild Native Folders

   npx expo prebuild
   

   This command creates the android and ios folders with native configurations.

3. Run the Application

   For iOS:

   npm run ios
   

   For Android:

   npm run android
   

🔧 Backend Setup

📁 Step 1: Navigate to Backend Folder

cd backend

---

📦 Step 2: Install Backend Dependencies

npm install

---

⚙️ Step 3: Start the Backend Server

npm run dev

🛑 Important

Make sure MongoDB is installed and running locally before starting the backend server.

👉 Download MongoDB Community Edition

📁 Folder Structure (Modular)

uberclone/
├── App.tsx                # App entry point
├── index.js               # Registers root component
├── app.json               # App configuration
├── package.json           # Dependencies & scripts
├── babel.config.js        # Babel config
├── metro.config.js        # Metro bundler config
├── tsconfig.json          # TypeScript config
├── yarn.lock              # Yarn lockfile
├── .eslintrc.js           # ESLint config
├── .prettierrc.js         # Prettier config
├── .gitignore             # Git ignored files
├── /android               # Android native files
├── /ios                   # iOS native files
├── /assets                # Global static assets
├── /backend                   # Backend (Node.js + TypeScript)
│   ├── /src
│   │   ├── /api               # API routes
│   │   ├── /config            # DB and app config
│   │   ├── /socket            # WebSocket (Socket.io) logic
│   │   ├── /types             # TypeScript interfaces/types
│   │   └── index.ts           # Main server entry point
│   ├── .env                   # Environment variables
│   ├── package.json           # Backend dependencies & scripts
│   ├── package-lock.json
│   └── tsconfig.json          # TypeScript config
├── /src                   # Main source code
│   ├── /assets            # Fonts, Images
│   ├── /components        # Reusable UI components
│   ├── /config            # App-level config files
│   ├── /constants         # App-wide constants
│   ├── /context           # React contexts
│   ├── /hooks             # Custom hooks
│   ├── /lang              # Localization (en.json, ar.json)
│   ├── /models            # Data models/interfaces
│   ├── /navigation        # Stack & tab navigators
│   ├── /redux             # Redux store, actions, reducers
│   ├── /screens           # UI screens (Home, Profile, etc.)
│   ├── /styles            # Global styles/themes
│   ├── /typings           # TypeScript types
│   └── /utils             # Utility functions

📄 License

MIT License