Skip to content

Parshuram02/Campus-Pool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 

Repository files navigation

🚖 Campus Pool - Ride Together, Save Together

Version License Status

Campus Pool is a modern, real-time carpooling platform designed specifically for university students. It connects students traveling on the same route, helping them share rides, reduce travel costs, and lower their carbon footprint.


🚀 Key Features

🌟 Core Functionality

  • Host a Ride: Create a ride listing with source, destination, time, and vehicle type.
  • Find & Join: Filter available rides by time, price, or seats and request to join.
  • Smart Notifications: Real-time updates when a host accepts or rejects your request.

💬 Real-Time Communication

  • In-Ride Chat: Integrated group chat for each ride using Socket.io.
  • Privacy Focused: Chat is only accessible to accepted members of the ride.

💰 Fare Management

  • Fair Split Calculator: Admin can instantly calculate and broadcast the per-person share based on the total trip cost.
  • Transparent Pricing: Users see estimated costs before joining.

🛡️ Safety & Preferences

  • Verified Profiles: Users are authenticated via college credentials.
  • Gender Filtering: Option to host "Female Only" rides for safety and comfort.
  • Vehicle Choice: Support for various vehicle types (Uber Go, Premier, Auto, Bike).

🛠️ Tech Stack

This project is built using the MERN Stack for a robust and scalable architecture.

Component Technology Description
Frontend React.js Dynamic, responsive UI with react-router-dom.
Styling Tailwind CSS Modern, utility-first CSS for glassmorphism and gradients.
Icons Lucide React Beautiful, consistent iconography.
Backend Node.js / Express RESTful API with distinct route controllers.
Database MongoDB NoSQL database for flexible data modeling (Users, Rides, Chats).
Real-Time Socket.io Bidirectional event-based communication for chat and alerts.
Auth JWT Secure JSON Web Token authentication.

📸 Screenshots

Dashboard Ride Details
Hero section with gradient UI Chat & Fare Calculator

(Add your screenshots here)


⚙️ Installation & Setup

Follow these steps to run the project locally.

Prerequisites

  • Node.js (v14+)
  • MongoDB (Local or Atlas URL)

1. Clone the Repository

git clone https://github.com/Parshuram02/Campus-Pool.git
cd Campus-Pool

2. Backend Setup

cd backend
npm install
# Create a .env file and add your MONGO_URI and JWT_SECRET
npm run dev

3. Frontend Setup

# Open a new terminal
cd frontend
npm install
npm start

4. Access the App

Open http://localhost:3000 to view it in the browser.


🤝 Contributing

Contributions are welcome! Please fork the repository and submit a pull request for any enhancements.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📧 Contact

Prashant (Admin)
AIT Pune
Project Link: https://github.com/Parshuram02/Campus-Pool

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors