https://github.com/sunjay-dev/ride-sharing-website
A ride-sharing platform designed for MUET students, making travel between MUET and Hyderabad affordable, and convenient. Built as a hackathon project
https://github.com/sunjay-dev/ride-sharing-website
carpooling carpooling-application rideshare ridesharing
Last synced: about 1 month ago
JSON representation
A ride-sharing platform designed for MUET students, making travel between MUET and Hyderabad affordable, and convenient. Built as a hackathon project
- Host: GitHub
- URL: https://github.com/sunjay-dev/ride-sharing-website
- Owner: sunjay-dev
- Created: 2025-01-22T19:47:55.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-02T07:05:51.000Z (2 months ago)
- Last Synced: 2025-03-02T07:27:39.530Z (2 months ago)
- Topics: carpooling, carpooling-application, rideshare, ridesharing
- Language: JavaScript
- Homepage: https://uniride.sunjay.xyz
- Size: 1.09 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ride Sharing Website
## 📌 Overview
This is a ride-sharing platform designed to help MUET students conveniently find and offer rides, reducing travel costs and promoting eco-friendly commuting. Users can create ride offers, search for available rides, manage their trips, and receive real-time updates.
## 🚀 Features
- **User Authentication**: Secure login and signup system.
- **Offer a Ride**: Drivers can create ride offers.
- **Find a Ride**: Passengers can search for available rides.
- **Manage Rides**: Users can oversee their current rides.
- **Ride History**: Log of all created, joined, and canceled rides.
- **Notifications**: Alerts for ride cancellations or when a passenger leaves.
- **Real-time Updates**: Live seat availability and ride notifications using WebSockets.
- **Forgot Password**: Users can reset passwords via email link.
- **Microsoft Login**: Users can Login and Sign Up using their Microsoft university email.
## 🛠 Tech Stack
- **Frontend**: EJS (Embedded JavaScript Templates) + Tailwind CSS
- **Backend**: Node.js + Express.js
- **Database**: MongoDB (via Mongoose)
- **Authentication**: JWT (JSON Web Token) + Microsoft OAuth
- **File Storage**: Cloudinary
- **Email Service**: Resend
- **Real-time Updates**: WebSockets
## 🔧 Installation
1. Clone the repository:
```bash
git clone https://github.com/sunjay-dev/Ride-sharing-website
cd Ride-sharing-website
```
2. Install dependencies:
```bash
npm install
```
3. Set up environment variables in a `.env` file (see below).
4. Run the server:
```bash
npm start
```
The app will be running at `http://localhost:3000`
## Environment Variables
Create a `.env` file in the root directory and add the following:
```env
MONGO_URI=mongodb+srv://your_username:your_password@your_cluster.mongodb.net/database_name
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret
JWT_SECRET=your_jwt_secret
PORT=3000
senderEmail=EMAIL_ADDRESS
CLIENT_URL=http://localhost:3000
RESEND_EMAIL_API_KEY=RESEND_EMAIL_API_KEY
MICROSOFT_CLIENT_ID=MICROSOFT_CLIENT_ID
MICROSOFT_CLIENT_SECRET=MICROSOFT_CLIENT_SECRET
```
## 🔑 User Authentication
- **Sign Up** with university email (`@students.muet.edu.pk`).
- **Login** to access ride-sharing features.
- **Forgot Password?** Reset using an emailed link.
## 🚀 What's Next?
- Develop a mobile app for iOS & Android.
- Add a feature for drivers to approve passengers before joining a ride.
## 🏆 Achievements
- 🎉 Hackathon: Hack for Humanity🥇
- Public Voting Winner🏅
- Ranked 20th among all participants📜
## 
## 🤝 Contributors
- **Varoon Kumar** - UI Designer
- **Sunjay Kumar** - MERN Stack Developer (Backend Focused)
- **Muhammad Sajid** - MERN Stack Developer (Frontend Focused)
## 🎯 Support Us
If you like our project, please support us by contributing open source! 🙌