CleopasOj/electroKE

Electronics marketplace in Kenya # electroKE Full Project — Premium Kenya Electronics Marketplace **Production-ready starter** with beautiful premium frontend (Next.js) + solid backend (Express). ## Quick Start (Run Locally) ### 1. Backend ```bash cd backend npm install npm run dev ``` Backend runs on **http://localhost:3001** ### 2. Frontend (Next.js) ```bash cd web npm install npm run dev ``` Frontend runs on **http://localhost:3000** Open localhost — the full premium marketplace experience. ### Features Included (Premium & Market-Ready) - Beautiful, clean, trustworthy UI matching the original vision - Live search + advanced filters (category, condition, price, county) - Dynamic listing creation (Sell flow) - Real API integration (listings, boost with M-Pesa simulation, chat) - Boost system with fake STK Push that actually updates the UI - In-app chat with smart fake replies - Responsive design optimized for iPhone - TypeScript, Framer Motion animations, Sonner toasts - In-memory backend (easy to swap for PostgreSQL + Prisma) ## Deploy & PWA **Frontend**: One-click deploy to Vercel (recommended) **Backend**: Deploy to Railway, Render, or Fly.io (free tiers available) ### PWA (Installable App on Android & iPhone) The project is fully configured as a **Progressive Web App**: - Install from Chrome/Safari → feels like a native app - Works offline (basic caching) - Add to Home Screen for app-like experience Update `next.config.js` if needed for advanced service worker. Update `API_BASE` in `web/app/page.tsx` to your deployed backend URL. ## Next Steps for Production - Add real authentication (Firebase / Africa's Talking OTP + JWT) - Connect Prisma + PostgreSQL (schema already designed) - Real M-Pesa Daraja integration in backend - Image uploads to Cloudinary - Real-time chat with Socket.io - Admin dashboard expansion - Mobile app (Flutter) This starter feels premium and is ready for the Kenyan market. Scale it confidently. Built with ❤️ for Kenya.