https://github.com/chandrashekher1/triptix
TripTix is a real-time bus ticket booking web app. It allows users to search buses, select seats, fill passenger details, and make payments using Razorpay. Seat locking and unlocking are handled live to prevent overbooking.
https://github.com/chandrashekher1/triptix
expressjs gemini-api jwt-authentication mongodb nodejs reactjs socket-io tailwindcss usecontext-hook
Last synced: 3 months ago
JSON representation
TripTix is a real-time bus ticket booking web app. It allows users to search buses, select seats, fill passenger details, and make payments using Razorpay. Seat locking and unlocking are handled live to prevent overbooking.
- Host: GitHub
- URL: https://github.com/chandrashekher1/triptix
- Owner: Chandrashekher1
- Created: 2025-07-03T14:06:03.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-17T04:32:32.000Z (11 months ago)
- Last Synced: 2025-07-17T06:59:20.118Z (11 months ago)
- Topics: expressjs, gemini-api, jwt-authentication, mongodb, nodejs, reactjs, socket-io, tailwindcss, usecontext-hook
- Language: JavaScript
- Homepage: https://trip-tix-zeta.vercel.app
- Size: 175 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🚌 TripTix - Real-Time Bus Ticket Booking App
TripTix is a full-stack real-time web application that allows users to search for buses, select seats, enter passenger details, and complete bookings with secure Razorpay payment integration. Built using the MERN stack with Socket.io, it supports **real-time seat locking**, preventing overbooking and ensuring a seamless experience.
---
## Features
- **Browse Available Buses**
Search and view available bus listings with operator, AC/sleeper info, and pricing.
- **Real-Time Seat Selection**
Interactive seat layout with **real-time seat locking/unlocking** using Socket.io.
- **Passenger Details Form**
Dynamically generated form for each selected seat to collect traveler information.
- **Razorpay Payment Integration**
Secure and smooth payment gateway integration.
- **Live Socket Communication**
Prevents double-booking by locking selected seats until the transaction is complete or cancelled.
- **Booking Summary & Confirmation**
View trip, seat, fare, and duration summary before final confirmation.
---
## Tech Stack
- Frontend: React.js, Tailwind CSS
- Backend: Node.js, Express.js
- Databse: MongoDB, Mongoose
- Real-Time: Socket.io
- Payment: Razorpay API
- Icons/UI: React-Icons, Responsive UI
---
## Folder Structure
```
/tripTix
/components
- BusCard.jsx
- ChatBot.jsx
- Footer.jsx
- Header.jsx
- Login.jsx
- Navbar.jsx
- OfferCard.jsx
- Payment.jsx
- SearchBar.jsx
- SeatSelection.jsx
/context
- BusContext.js
- BusProvider.jsx
/hook
- useBus.js
/pages
- Home.jsx
- AvailableBus.jsx
- PassengerDetails.jsx
- Profile.jsx
/utils
- constants.js
App.js
```
---
## How It Works
1. **User logs in** and searches for buses.
2. **User selects a bus** and views available seats.
3. Selected seats are **locked in real-time** using `Socket.io`.
4. On the next page, user fills **passenger details**.
5. Proceeds to **Razorpay payment**.
6. If successful, **booking is saved**, else **seats are unlocked**.
---
## Setup Instructions
### Prerequisites
- Node.js
- MongoDB
- Razorpay Account (API Keys)
- Google Gemini API Key (Optional for ChatBot)
### Installation
```bash
# Clone the project
git clone https://github.com/Chandrashekher1/TripTix.git
cd tripTix
# Install Frontend dependencies
npm install
# Run Frontend
npm run dev
```
## Real-Time ChatBot
- Uses Google Gemini API to answer user FAQs related to bookings.
- Uses Google Gemini API to answer user FAQs related to bookings.
## Screenshots
## Author
Chandrashekher Prasad
## License
MIT License - feel free to use, fork, and build upon it!
# React + Vite
This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
Currently, two official plugins are available:
- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) for Fast Refresh
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
## Expanding the ESLint configuration
If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) for information on how to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project.