🚖 Uber Clone - React Native App

A fully functional Uber-like ride booking app built with React Native. This app supports multilingual features (LTR/RTL), light/dark themes, and real-time ride tracking with Google Maps. Built on a scalable boilerplate foundation (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 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")

🔧 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

🛠️ Features

• 🌙 Light/Dark Mode toggle
• 🌍 Language support (English ↔ Arabic)
• 📍 Google Maps live tracking
• 🧾 Ride summary & trip history
• 👤 User profile with logout
• 🚘 Vehicle and driver details
• 🔐 Navigation using React Navigation
• 📡 Real-time communication via Socket.io
• 📦 Background location tracking using react native background geolocation

---

📦 Tech Stack

• React Native
• React Navigation
• Redux Toolkit
• i18next (localization)
• Google Maps SDK
• TypeScript
• Node.js
• Express.js
• Swagger (API documentation)

---

📁 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