Ride Hailing App for Northern Kenya
# ๐ The King of Northern
## ๐ Northern Kenya's Premier Ride Hailing Service
A complete ride-hailing platform connecting customers with nearby drivers across Northern Kenya.
---
## ๐ฑ **Apps Available**
| App | Description |
|-----|-------------|
| ๐ **Customer App** | Request rides, track drivers, and view nearby vehicles |
| ๐จโโ๏ธ **Driver App** | Accept ride requests, manage trips, and track earnings |
---
## ๐ **Live Demo**
- **Landing Page:**
the-king-of-northern-2.onreโฆ
- **Customer App:**
the-king-of-northern-2.onreโฆ
- **Driver App:**
the-king-of-northern-2.onreโฆ
---
## ๐ **Features**
### Customer Features:
- โ
Request a ride with pickup and destination
- โ
Select from multiple vehicle types
- โ
View nearby available drivers
- โ
See driver details (name, phone, car, plate, rating)
- โ
Real-time ride status updates
- โ
Download app to phone
### Driver Features:
- โ
Login to driver dashboard
- โ
View pending ride requests
- โ
Accept/confirm rides
- โ
Complete rides
- โ
Track ride history
---
## ๐ **Driver Login Credentials**
| Username | Password |
|----------|----------|
| `driver` | `driver123` |
---
## ๐ ๏ธ **Technology Stack**
| Technology | Purpose |
|------------|---------|
| **Node.js** | Backend server |
| **Express** | API framework |
| **CORS** | Cross-origin requests |
| **HTML/CSS/JS** | Frontend |
| **PWA** | Mobile app experience |
| **Render** | Hosting & deployment |
---
## ๐ **Deployment**
### Deploy on Render:
1. Push code to GitHub
2. Go to Render
3. Click **"New +"** โ **"Web Service"**
4. Connect GitHub repository
5. Fill in:
- **Build Command:** `npm install`
- **Start Command:** `node server.js`
6. Click **"Create Web Service"**
---
## ๐ฑ **Install on Phone**
### Android (Chrome):
1. Open Chrome
2. Go to Customer or Driver app URL
3. Tap **three dots (โฎ)** โ **"Add to Home screen"**
4. Tap **"Install"**
### iPhone (Safari):
1. Open Safari
2. Go to โฆ