eonwonga/Mpesa-integrated-wifi-biling-system

# Mpesa_Based-WiFi-Billing-System A WiFi billing system that allows users to purchase internet access via MPesa payments (STK Push). Ideal for cybercafés, small businesses, and public WiFi hotspots. **📌 FEATURES** ✅ MPesa STK Push Integration – Users pay directly from their phone via STK Push. ✅ Time-Based Access. ✅ Admin Dashboard – Track payments and manage users. ✅ MAC Address Whitelisting – Secure WiFi access via MikroTik integration. **🛠️ TECH STACK** Frontend: React + Tailwind CSS Backend: Node.js + Express Database: MySQL Router Integration: MikroTik (MAC Address Whitelisting) **🔧 INSTALLATION & SETUP** 1️⃣ Clone the Repository `cd Mpesa_Based-WiFi-Billing-System` 2️⃣ Install Dependencies `npm install` 3️⃣ Set Up Environment Variables ``` MPESA_CONSUMER_KEY=your_key MPESA_CONSUMER_SECRET=your_secret MPESA_PASSKEY=your_passkey MPESA_SHORTCODE=your_shortcode DATABASE_URL=mysql://user:password@localhost/dbname ``` 4️⃣ Run the Application ### Start the backend `node index.js` ### Start the frontend From the `Frontend/` folder: ``` cp .env.local.example .env.local # if provided, otherwise create manually echo NEXT_PUBLIC_API_URL=localhost > .env.local npm install npm run dev ``` # 🚀 RECENT IMPROVEMENTS (2025) **Authentication & Security** - Refactored backend authentication to use Prisma ORM and secure password hashing (bcrypt). - Implemented robust admin login with JWT-based session management. - Added error handling and secure credential validation for all login flows. **Frontend Enhancements** - Redesigned admin login page with improved error feedback and user experience. - Dashboard now displays logged-in admin info and provides a logout button. - Added reusable authentication hook and protected route wrapper for admin-only pages. **Codebase & Runtime** - All components now use proper default/named exports and pass runtime checks. - Modularized authentication logic for maintainability and scalability. - Improved …