lynesabie29-oss/kiambu-nganyahub

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!** …