lynesabie29-oss/kiambu-nganyahub
Domaine:
mobilityType de record:
software
Créateur:
lyn
Hôte:
first kiambu nganya hub project
# NganyaHub Kenya — Complete Deployment Guide
## Overview
NganyaHub Kenya is a full-stack PHP/MySQL web platform for Nairobi matatu (nganya) fans. It features live GPS tracking, community feed, events, news, admin dashboard analytics, and a subscription system ready for M-Pesa integration.
**Featured Nganyas:** B613 · Delirium · Dethrone
---
## Tech Stack
| Layer | Technology |
|---|---|
| Backend | PHP 8.0+ (OOP, PDO) |
| Database | MySQL 8.0+ |
| Frontend | HTML5, CSS3, JavaScript (ES6+) |
| Maps | Leaflet.js + OpenStreetMap |
| AJAX | Fetch API |
| Security | bcrypt, CSRF tokens, PDO prepared statements, XSS protection |
---
## Requirements
- PHP 8.0 or higher
- MySQL 8.0 or higher
- Apache with `mod_rewrite` enabled
- PHP extensions: `pdo_mysql`, `gd`, `fileinfo`, `mbstring`, `openssl`
- Minimum 50MB upload limit recommended
---
## Installation Steps
### Step 1 — Upload Files
Upload all files to your web hosting `public_html` or domain root directory.
### Step 2 — Create Database
1. Login to cPanel → phpMyAdmin
2. Create a new database (e.g. `nganyahub_db`)
3. Create a database user with ALL PRIVILEGES
4. Import `database.sql` into the new database
### Step 3 — Configure the Application
Edit `/config/config.php` and update:
```php
define('DB_HOST', 'localhost');
define('DB_NAME', 'nganyahub_db');
define('DB_USER', 'your_db_user');
define('DB_PASS', 'your_db_password');
define('BASE_URL', 'yourdomain.com');
define('SITE_NAME', 'NganyaHub Kenya');
```
### Step 4 — Set File Permissions
```bash
chmod 755 uploads/
chmod 755 uploads/avatars/
chmod 755 uploads/photos/
chmod 755 uploads/videos/
chmod 755 uploads/events/
chmod 755 uploads/news/
chmod 644 .htaccess
chmod 644 config/config.php
```
### Step 5 — Create Admin Account
After importing the database, the default admin credentials are:
| Field | Value |
|---|---|
| Email | admin@nganyahub.co.ke |
| Password | Admin@123 |
**Change the admin password immediately after first login!** …