🚗 Uber Clone - Full Stack Ride Sharing Application

A full-stack ride-sharing application built with the MERN stack, featuring real-time driver-passenger matching, live location tracking, and integrated payment processing.

📹 Demo

uber.mp4

Project Architecture

✨ Features

For Passengers

🔐 User Authentication - Secure signup/login with JWT
📍 Location Search - Google Maps autocomplete for pickup and destination
💰 Fare Estimation - Real-time fare calculation for different vehicle types
🚕 Vehicle Selection - Choose from cars, bikes, or autos
💳 Payment Integration - Razorpay payment gateway integration
🔔 Real-time Notifications - Live updates on ride status
🎯 Ride Tracking - Track your driver in real-time

For Drivers

🔐 Driver Authentication - Separate authentication flow for drivers
📱 Driver Dashboard - View and manage ride requests
🔔 Ride Notifications - Instant notifications for nearby ride requests
✅ Accept/Reject Rides - Full control over ride acceptance
🚗 Vehicle Management - Register and manage vehicle details
📊 Ride History - Track completed rides

Technical Features

⚡ Real-time Communication - Socket.io for instant updates
🗺️ Google Maps Integration - Location services and distance calculation
🔄 State Management - React Context API
💾 Caching - Redis for session and location data
🎨 Responsive Design - Mobile-first Tailwind CSS design
🔒 Secure Authentication - Bcrypt password hashing + JWT tokens

🏗️ Architecture

The application consists of three main services:

uber-clone/
├── frontend/          # React + Vite frontend
├── backend/           # Express.js + MongoDB backend
└── web socket server/ # Socket.io real-time server

Technology Stack

Frontend

React 19
Vite
TailwindCSS
Socket.io Client
React Router DOM
GSAP (animations)
Axios
React Razorpay

Backend

Node.js + Express 5
TypeScript
MongoDB + Mongoose
Redis
JWT Authentication
Bcrypt
Google Maps API
Razorpay API

WebSocket Server

Socket.io
Redis
Express
TypeScript

🚀 Getting Started

Prerequisites

Node.js (v18+)
MongoDB
Redis
Google Maps API Key
Razorpay API Keys

Installation

Clone the repository

git clone https://github.com/yourusername/uber-clone.git
cd uber-clone

Backend Setup

cd backend
npm install

# Create .env file
cat > .env << EOL
PORT=3000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
JWT_EXPIRY=1d
GOOGLE_MAPS_API_KEY=your_google_maps_api_key
GOOGLE_MAPS_URL=https://maps.googleapis.com/maps/api
RAZORPAY_API_KEY=your_razorpay_key
RAZORPAY_SECRET_KEY=your_razorpay_secret
EOL

npm run dev

WebSocket Server Setup

cd "web socket server"
npm install
npm run dev

Frontend Setup

cd frontend
npm install

# Create .env file
cat > .env << EOL
VITE_RAZORPAY_API_KEY=your_razorpay_key
EOL

npm run dev

Running the Application

Start all services:

MongoDB (default port: 27017)
Redis (default port: 6379)
Backend server (port: 3000)
WebSocket server (port: 3001)
Frontend (port: 5173)

📂 Project Structure

Backend

backend/src/
├── config/          # Configuration files (DB, Redis, Razorpay)
├── controllers/     # Route controllers
├── dtos/            # Data transfer objects
├── middleware/      # Auth middleware
├── models/          # Mongoose schemas
├── repositories/    # Database operations
├── routes/          # API routes
├── services/        # Business logic
└── utils/           # Helper functions

Frontend

frontend/src/
├── components/      # Reusable React components
├── context/         # Context providers
├── pages/           # Page components
└── utils/           # Helper functions

WebSocket Server

web socket server/src/
├── config/          # Socket.io configuration
├── controllers/     # WebSocket event handlers
├── routes/          # HTTP routes for notifications
├── services/        # Redis operations
└── utils/           # Helper utilities

🔑 Key Components

Real-time Ride Flow

User requests ride → Backend creates booking
Backend finds nearby drivers → Uses Redis geospatial queries
WebSocket server notifies drivers → Socket.io emit to driver sockets
Driver accepts ride → Backend updates booking status
User notified → Socket.io emit to user socket
Payment processed → Razorpay integration
Ride completed → Status updated in MongoDB

Authentication Flow

JWT tokens stored in localStorage
Protected routes with auth middleware
Separate auth flows for users and drivers
Password hashing with bcrypt (10 rounds)

Location Services

Google Maps Geocoding API for address → coordinates
Distance Matrix API for fare calculation
Places Autocomplete API for search suggestions
Redis GEOADD/GEORADIUS for driver proximity

🔐 Environment Variables

Backend (.env)

PORT=3000
MONGO_URI=mongodb://localhost:27017/uber
JWT_SECRET=your_secret_key
JWT_EXPIRY=1d
GOOGLE_MAPS_API_KEY=your_google_maps_key
GOOGLE_MAPS_URL=https://maps.googleapis.com/maps/api
RAZORPAY_API_KEY=your_razorpay_key
RAZORPAY_SECRET_KEY=your_razorpay_secret

Frontend (.env)

VITE_RAZORPAY_API_KEY=your_razorpay_key

📡 API Endpoints

User Routes

POST /api/v1/user/signup - Register new user
POST /api/v1/user/signin - User login
GET /api/v1/user/me - Get user profile
POST /api/v1/user/create - Create new ride booking
GET /api/v1/user/:id - Get user by ID

Driver Routes

POST /api/v1/driver/signup - Register new driver
POST /api/v1/driver/signin - Driver login
GET /api/v1/driver/me - Get driver profile
POST /api/v1/driver/location - Update driver location
POST /api/v1/driver/confirm - Confirm ride acceptance
GET /api/v1/driver/details/:id - Get booking details

Map Routes

GET /api/v1/map/suggestions?input={query} - Get location suggestions
GET /api/v1/map/get-fare?pickup={}&destination={} - Calculate fare

Payment Routes

POST /api/v1/payment/order - Create Razorpay order

🎯 Future Enhancements

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the project
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

This project is licensed under the ISC License.

👨‍💻 Author

Your Name

GitHub: @yourusername

🙏 Acknowledgments

Google Maps Platform for location services
Razorpay for payment processing
Socket.io for real-time communication
MongoDB for database
Redis for caching and geospatial queries

📧 Contact

For any queries or suggestions, feel free to reach out!

Happy Coding! 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 22 Commits
backend		backend
frontend		frontend
web socket server		web socket server
README.md		README.md

trishit78/uber

Folders and files

Latest commit

History

Repository files navigation