{"id":27115167,"url":"https://github.com/sunjay-dev/ride-sharing-website","last_synced_at":"2025-06-15T20:09:19.012Z","repository":{"id":275192902,"uuid":"920801172","full_name":"sunjay-dev/Ride-sharing-website","owner":"sunjay-dev","description":"A ride-sharing platform designed for MUET students, making travel between MUET and Hyderabad affordable, and convenient. Built as a hackathon project","archived":false,"fork":false,"pushed_at":"2025-03-07T14:10:08.000Z","size":1268,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-15T19:11:02.430Z","etag":null,"topics":["carpooling","carpooling-application","rideshare","ridesharing"],"latest_commit_sha":null,"homepage":"https://uniride.sunjay.xyz","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sunjay-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-22T19:47:55.000Z","updated_at":"2025-05-27T08:23:24.000Z","dependencies_parsed_at":"2025-03-02T07:24:33.214Z","dependency_job_id":"357a5b95-4ece-4c70-8dae-8fc1fc5cccf6","html_url":"https://github.com/sunjay-dev/Ride-sharing-website","commit_stats":null,"previous_names":["sunjay-dev/ride-sharing-website"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sunjay-dev/Ride-sharing-website","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunjay-dev%2FRide-sharing-website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunjay-dev%2FRide-sharing-website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunjay-dev%2FRide-sharing-website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunjay-dev%2FRide-sharing-website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sunjay-dev","download_url":"https://codeload.github.com/sunjay-dev/Ride-sharing-website/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sunjay-dev%2FRide-sharing-website/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260044504,"owners_count":22950755,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["carpooling","carpooling-application","rideshare","ridesharing"],"created_at":"2025-04-07T04:54:24.864Z","updated_at":"2025-06-15T20:09:18.943Z","avatar_url":"https://github.com/sunjay-dev.png","language":"JavaScript","readme":"# Ride Sharing Website\n\n## 📌 Overview\nThis 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.\n\n## 🚀 Features\n- **User Authentication**: Secure login and signup system.\n- **Offer a Ride**: Drivers can create ride offers.\n- **Find a Ride**: Passengers can search for available rides.\n- **Manage Rides**: Users can oversee their current rides.\n- **Ride History**: Log of all created, joined, and canceled rides.\n- **Notifications**: Alerts for ride cancellations or when a passenger leaves.\n- **Real-time Updates**: Live seat availability and ride notifications using WebSockets.\n- **Forgot Password**: Users can reset passwords via email link.\n- **Microsoft Login**: Users can Login and Sign Up using their Microsoft university email.\n\n## 🛠 Tech Stack\n![HTML5](https://img.shields.io/badge/html5-%23E34F26.svg?style=for-the-badge\u0026logo=html5\u0026logoColor=white) \n![CSS3](https://img.shields.io/badge/css3-%231572B6.svg?style=for-the-badge\u0026logo=css3\u0026logoColor=white) \n![JavaScript](https://img.shields.io/badge/javascript-%23323330.svg?style=for-the-badge\u0026logo=javascript\u0026logoColor=%23F7DF1E) \n![EJS](https://img.shields.io/badge/ejs-%23B4CA65.svg?style=for-the-badge\u0026logo=ejs\u0026logoColor=black) \n![TailwindCSS](https://img.shields.io/badge/tailwindcss-%2338B2AC.svg?style=for-the-badge\u0026logo=tailwind-css\u0026logoColor=white) \n![Socket.io](https://img.shields.io/badge/Socket.io-black?style=for-the-badge\u0026logo=socket.io\u0026badgeColor=010101) \n![NodeJS](https://img.shields.io/badge/node.js-6DA55F?style=for-the-badge\u0026logo=node.js\u0026logoColor=white) \n![NPM](https://img.shields.io/badge/NPM-%23CB3837.svg?style=for-the-badge\u0026logo=npm\u0026logoColor=white) \n![Express.js](https://img.shields.io/badge/express.js-%23404d59.svg?style=for-the-badge\u0026logo=express\u0026logoColor=%2361DAFB) \n![MongoDB](https://img.shields.io/badge/MongoDB-%234ea94b.svg?style=for-the-badge\u0026logo=mongodb\u0026logoColor=white) \n![Render](https://img.shields.io/badge/Render-%46E3B7.svg?style=for-the-badge\u0026logo=render\u0026logoColor=white)\n![Git](https://img.shields.io/badge/git-%23F05033.svg?style=for-the-badge\u0026logo=git\u0026logoColor=white)\n![Figma](https://img.shields.io/badge/figma-%23F24E1E.svg?style=for-the-badge\u0026logo=figma\u0026logoColor=white)\n![Canva](https://img.shields.io/badge/Canva-%2300C4CC.svg?style=for-the-badge\u0026logo=Canva\u0026logoColor=white)\n\n\n- **Frontend**: EJS (Embedded JavaScript Templates) + Tailwind CSS\n- **Backend**: Node.js + Express.js\n- **Database**: MongoDB (via Mongoose)\n- **Authentication**: JWT (JSON Web Token) + Microsoft OAuth\n- **File Storage**: Cloudinary\n- **Email Service**: Resend\n- **Real-time Updates**: WebSockets\n\n\n## 🔧 Installation\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/sunjay-dev/Ride-sharing-website\n   cd Ride-sharing-website\n   ```\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n3. Set up environment variables in a `.env` file (see below).\n4. Run the server:\n   ```bash\n   npm start\n   ```\nThe app will be running at `http://localhost:3000`\n\n## Environment Variables\nCreate a `.env` file in the root directory and add the following:\n```env\nMONGO_URI=mongodb+srv://your_username:your_password@your_cluster.mongodb.net/database_name\nCLOUDINARY_CLOUD_NAME=your_cloud_name\nCLOUDINARY_API_KEY=your_api_key\nCLOUDINARY_API_SECRET=your_api_secret\nJWT_SECRET=your_jwt_secret\nPORT=3000\nsenderEmail=EMAIL_ADDRESS\nCLIENT_URL=http://localhost:3000\nRESEND_EMAIL_API_KEY=RESEND_EMAIL_API_KEY\nMICROSOFT_CLIENT_ID=MICROSOFT_CLIENT_ID\nMICROSOFT_CLIENT_SECRET=MICROSOFT_CLIENT_SECRET\n```\n\n\n## 🔑 User Authentication\n- **Sign Up** with university email (`@students.muet.edu.pk`).\n- **Login** to access ride-sharing features.\n- **Forgot Password?** Reset using an emailed link.\n\n## 🚀 What's Next?\n- Develop a mobile app for iOS \u0026 Android.\n- Add a feature for drivers to approve passengers before joining a ride.\n\n## 🏆 Achievements\n\n- 🎉 Hackathon: Hack for Humanity🥇 \n- Public Voting Winner🏅\n- Ranked 20th among all participants📜\n\n## ![Certificate Awarded](https://github.com/user-attachments/assets/bd63539d-524f-4767-afac-98fa8d1e897f)\n\n\n## 🤝 Contributors\n- **Varoon Kumar** - UI Designer\n- **Sunjay Kumar** - MERN Stack Developer (Backend Focused)\n- **Muhammad Sajid** - MERN Stack Developer (Frontend Focused)\n\n## 🎯 Support Us\nIf you like our project, please support us by contributing open source! 🙌\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsunjay-dev%2Fride-sharing-website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsunjay-dev%2Fride-sharing-website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsunjay-dev%2Fride-sharing-website/lists"}