Velora – Ride Booking App

Velora is a real-time ride-hailing platform that connects users with captains. Built with Socket.IO, MongoDB Atlas, and Google Maps integration, it provides seamless ride booking, acceptance, and live tracking.

🌍 Live Demo

🔗 /Velora

---

✨ Features

• 🔐 User & Captain Authentication (MongoDB Atlas)
• 📲 Book a ride with pickup & drop locations
• 🚗 Captains receive ride requests instantly (Socket.IO)
• ✅ Captains can accept rides (updates reflect for users in real-time)
• 🗺️ Google Maps Integration with live tracking
• 📌 Fully deployed and mobile responsive

---

🛠️ Tech Stack

• Frontend: React.js, Tailwind CSS
• Backend: Node.js, Express.js
• Database: MongoDB Atlas
• Real-time: Socket.IO
• Maps: Google Maps API

---

📸 Screenshots

---

---

📂 Project Structure

velora/
├── Backend/
│   ├── .gitignore
│   ├── app.js
│   ├── controllers/
│   ├── db/
│   ├── middlewares/
│   ├── models/
│   ├── package-lock.json
│   ├── package.json
│   ├── README.md
│   ├── routes/
│   ├── server.js
│   ├── services/
│   └── socket.js
└── frontend/
    ├── .gitignore
    ├── eslint.config.js
    ├── index.html
    ├── package-lock.json
    ├── package.json
    ├── postcss.config.js
    ├── public/
    ├── README.md
    ├── src/
    │   ├── App.css
    │   ├── App.jsx
    │   ├── assets/
    │   ├── components/
    │   ├── context/
    │   ├── index.css
    │   ├── main.jsx
    │   └── pages/
    ├── tailwind.config.js
    ├── vercel.json
    └── vite.config.js

---

🚀 Getting Started

# Clone the repository
git clone https://github.com/ancure-2004/Velora.git

cd Velora

#Frontend dependencies
cd frontend
npm install

#backend dependencies
cd backend
npm install

# Run backend
cd backend
npx nodemon

# Run frontend
cd frontend
npm run dev

---

Environment Variables

Create a .env file in the backend root directory and add the following variables:

PORT="Enter PORT"
MONGODB_URI="Enter your mongoDB connection string"
JWT_SECRET="Enter Your secret key"
GOOGLE_MAPS_API="Google Maps API Key"
SOCKET_ORIGIN="Enter the URL where Frontend is Running"

Create a .env file in the frontend root directory and add the following variables:

VITE_BASE_URL = "Enter the URL where backend is running"
VITE_GOOGLE_MAPS_API_KEY = "Your google maps api key"

---

🔮 Future Enhancements

• 💳 Payment Integration (UPI, Cards, Wallets)
• 📖 Ride History for users & captains
• ⭐ Ratings & Reviews system
• 🛡️ Improved UI with animations and smooth transitions

---

🤝 Contributing

We welcome contributions!

• Fork the repository
• Create a new branch (git checkout -b feature-name)
• Make your changes and commit (git commit -m 'Add feature')
• Push to the branch (git push origin feature-name)
• Open a Pull Request

---

License

This project is licensed under the MIT License.

Contact

• 📧 ankur2004tyagi@gmail.com
• 🔗 www.linkedin.com/in/ankur-tyagi2004