Logo Lanfrica

Mr-Dan-kibet/Phase-1-project

Domain:

mobilitydigital infrastructure

Record type:

softwareproject
Creator:
Mr-
Host:
# 🚐 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 …

Languages

Licenses