# π Luxury Rides
**Ease your journey β Book your ride, order your meal, and pay via M-Pesa.**
---
## π Overview
Luxury Rides is a **single-page seat booking platform** built for travelers moving between **Nairobi**, **Nakuru**, and **Eldoret**. This app allows users to:
- πͺ Book multiple seats on a luxury ride
- π§Ύ View ticket information and receive a digital receipt
- π² Pay seamlessly via **M-Pesa** integration (sandbox mode)
- π½οΈ *Preorder food for the stopover* (planned feature)
This project demonstrates frontend engineering using **HTML**, **CSS**, **JavaScript**, and `json-server` for local data persistence.
---
## π― Features
- π View available rides and seat availability
- πͺ Select multiple seats per booking
- π§Ύ View a receipt with ticket information
- π² Make M-Pesa payments *(mocked using Safaricom sandbox API)*
- π Booking form with **live validation**
- β
Clean, responsive UI
---
## π οΈ Technologies Used
- **HTML5 & CSS3**
- **JavaScript (ES6+)**
- **JSON Server** for local backend
- **M-Pesa Daraja API (sandbox)**
- **Live Server** (for frontend preview)
---
## π File Structure
```
Luxury-Rides/
βββ index.html
βββ css/
β βββ style.css
βββ src/
β βββ index.js
βββ server/
β βββ db.json
β βββ package.json
β βββ package-lock.json
β βββ server.js
βββ README.md
```
---
## π Setup Instructions
1. **Clone the Repository**
```bash
git clone git@github.com:Mr-Dan-kibet/Phase-1-project.git
cd Phase-1-project
```
2. Install JSON Server (if not already installed)
```
npm install -g json-server
```
3. Start JSON Server
```
json-server --watch db.json
```
5. Start the Frontend
```
Use the Live Server extension in VS Code
OR simply open index.html in your browser
```
---
## HOW TO USE
## π¨π½βπ» Author
Dan Rotich
Full-Stack Developer @ Moringa School
GitHub: @Mr-Dan-kibet
---
## πΌοΈ Preview
βDesigned to reduce queues and waiting time at booking offices and stopovers β all from your phone.β
---
## π License
### MIT License
### Copyright (c) 20 β¦