Skip to content

asquare004/RideShare

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 

Repository files navigation

🚗 RideShare

A smart, scalable, and intuitive ride-sharing web application connecting drivers and passengers through real-time technology, transparent workflows, and a seamless user experience.

📌 Overview

RideShare is a full-stack ride-sharing platform engineered to offer a secure, eco-friendly, and efficient urban transport experience. With dedicated portals for both passengers and drivers, the system handles end-to-end ride coordination — from booking to payment — while ensuring real-time updates, seamless user onboarding, and scalable architecture for future growth.

Built using MERN stack, Razorpay, and scalable MongoDB schemas, it features optimized backend logic, real-world event handling, and robust user state management.

✨ Key Features

  • 🔐 Dual Portal: Separate login flows for passengers and drivers
  • 🧠 Smart Ride Matching: Real-time request broadcasting to nearby drivers
  • 📍 Location-based Filtering: Ride creation and joining based on seat/time/place
  • 💳 Secure Payments: Integrated Razorpay checkout and signature verification
  • 🚦 Dynamic Ride Lifecycle: Auto-updated ride states (scheduled, ongoing, completed)
  • 📈 Admin-free Coordination: First-come-first-serve driver assignment logic
  • 📊 Scalable Design: Cleanly separated schema logic and controller responsibilities

🧠 How the System Works

👤 Passenger Flow

  1. Login via passenger portal
  2. View available rides (if seats are free)
  3. Choose to:
    • Join an existing ride (instant join)
    • Create a new ride (requests broadcast to all drivers)
  4. Await driver acceptance
  5. Ride begins → passenger pays after drop
  6. Status auto-updates as ride progresses

🚗 Driver Flow

  1. Login via driver portal
  2. Receive broadcasted requests (first driver to accept gets the ride)
  3. Manage scheduled/ongoing rides
  4. Start ride → collect payment → end ride when complete

🧩 Technical Architecture

  • Frontend: React.js (Vite), Tailwind CSS, Google OAuth
  • Backend: Node.js, Express.js, MongoDB, Razorpay SDK
  • Database: Mongoose models for users, rides, drivers, ratings, payments
  • Auth: JWT cookies (secure, scoped by portal)
  • Payments: Razorpay Orders + Signature verification

🖼️ Key Documentation and Diagrams

All major planning, design, and demonstration resources are available below:

Type Link
🧑‍🏫 Mentor Notes + Design Drafts Discussions & Drafts
📃 BRD – Business Requirements View BRD
📘 SRS – Software Requirements View SRS
🧱 System Architecture – Physical View Physical View
🧠 System Architecture – Logical View Logical View
🧭 UML Diagrams (Class, State, Activity, Use Case, Sequence) View UML Folder
🎥 Progress Presentation (Regular Evaluation) Gamma Deck
📽️ Demonstration Videos (Working + Architecture) Demo Videos Folder

👥 Team

This project was built with collaboration, innovation, and hard work by:

About

This ride-sharing application aims to provide a seamless, cost-effective, and efficient transportation solution.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •