Intercity Bus Reservation Android App with Live Seat Map and QR Boarding Pass

Booking an intercity bus still means juggling operator websites, phone calls and station counters, and the passenger often discovers the exact seat only after paying. Seat choice matters on overnight and long-distance routes: a berth near the driver, a window seat away from the door, or two seats together for a family can decide whether the journey is comfortable. This project builds an Intercity Bus Reservation Android App with Live Seat Map and QR Boarding Pass that puts that choice in the passenger's hands before payment. Travellers search routes, compare departures, pick exact seats or berths on a live coach map, and receive a QR boarding pass the moment a booking is confirmed. The app also states its cancellation and reschedule windows up front, so a change of plan is handled by a rule the passenger has already seen, not by a phone call.

The Intercity Bus Reservation Android App moves a passenger from route search to boarding pass in one continuous flow, with the seat map as the centre of the journey. A search returns matching departures for the chosen route and date, and the passenger picks boarding and dropping points from that route's own stops. Tapping seats on the live coach map holds them under a countdown timer, and confirming the booking converts the hold into a confirmed reservation with a QR pass. Cancellation and rescheduling then follow the trip's stated windows, and every booking remains visible in the passenger's booking history. Builder note from the demo build: the hold timer is wired directly to seat state, so a seat whose timer expires returns to the free pool without a page reload — the same state transition the delivered app performs server-side before confirming a booking.

1. The passenger enters origin, destination and date, then picks a boarding point and a dropping point from the route's stop list; the app lists matching departures with timings, coach type, fare and seats left.
2. Opening a departure loads that coach's exact layout — a two-plus-two seater map or lower and upper sleeper decks — with every seat or berth marked free, held or booked.
3. Tapping a free seat marks it held and starts the five-minute countdown, while the booking summary updates with the selected seats and fare breakup.
4. Confirming inside the window converts the hold into a confirmed booking, generates a 10-character booking reference, and produces the QR boarding pass.
5. The booking appears in booking history with route, date, seats, boarding point and fare, and the QR pass stays available until travel.
6. A cancellation or reschedule request is checked against the trip's windows — free cancellation up to 12 hours before departure, rescheduling up to 6 hours before — and applied or refused with a stated reason.
7. At boarding, the passenger shows the QR pass to the conductor, and the booking remains in history afterwards as a completed record.

Tech stack:

• Kotlin for Android
• Jetpack Compose UI
• Room local database
• Retrofit · REST API client
• ZXing QR code generation
• Material Design 3 components
• Gradle · Android Studio build tools
• JSON trip and booking data service

The Intercity Bus Reservation Android App is built around four capabilities that together cover the whole booking journey: a live seat and berth map, route search with boarding and dropping points, a held-seat countdown that protects a selection while the passenger confirms, and a QR boarding pass generated on booking. Around those four, the app adds fare breakup, booking history, and cancellation and reschedule windows that are enforced as rules rather than left to manual handling. Each capability is implemented in the base build and demonstrated in the working demo: the search filters real sample trips, the map reflects booked, held and free seats, and the pass carries the booking reference, seat numbers and boarding point together. Anything not yet built, such as live payment processing, is kept in the customization and limitations sections rather than presented as finished.

• [Live seat and berth map] The coach layout for the chosen trip is drawn seat by seat, with free, held and booked states shown distinctly. Seater coaches use a two-plus-two row layout and sleeper coaches use lower and upper berth decks.
• [Route search with boarding and dropping points] Passengers search by origin, destination and date, then pick a boarding point and a dropping point from that route's own stop list, so the booking records exactly where the passenger boards and alights.
• [Held-seat countdown timer] Tapping a free seat holds it under a visible five-minute countdown. Confirming inside the window converts the hold into a booking; letting it expire releases the seat back to the free pool automatically.
• [QR boarding pass] Every confirmed booking generates a QR pass carrying the booking reference, route, date, departure time, seat numbers, boarding point and fare, ready to show to the conductor at boarding.
• [Cancellation and reschedule windows] Cancellation is free up to 12 hours before departure and rescheduling is allowed up to 6 hours before departure with any fare difference payable. The app enforces these windows and refuses changes outside them with a stated reason.
• [Fare breakup and booking summary] Before confirming, the passenger sees the selected seats, boarding and dropping points, base fare and total payable in one summary, so the amount paid matches the amount shown.
• [Booking history] Confirmed and completed bookings stay listed in the passenger's history with route, date, seats and status, giving a single place to revisit past trips and current passes.

• Complete Android app source code (Kotlin, Jetpack Compose)
• REST API and database schema for trips, seats, bookings and windows
• Seat-map component (seater and sleeper layouts) and QR pass generation module
• Sample trip dataset: 8 scheduled trips across 4 routes with boarding and dropping points
• Project report PDF (background, design, data model, hold-timeout state machine, QR payload)
• PPT presentation for final review
• Viva Q&A preparation document (booking flow, seat-hold logic, cancellation rules, API design)
• Setup guide and project abstract PDF