fmungai001/usafibora

Production-ready on-demand cleaning services marketplace for Kenya. Connect customers, providers, and cleaners with a modern mobile-first platform inspired by Uber and Aldobi. # UsafiBora - Professional Cleaning Services Marketplace **Professional Cleaning. Booked in Minutes.** A production-ready, modern on-demand cleaning services marketplace platform connecting customers, cleaning companies, and service professionals across Kenya. ## 🎯 Vision Make professional cleaning services accessible, affordable, and trustworthy through a simple mobile-first platform. **Core Flow:** Customer → Platform → Cleaning Company → Cleaner ## 🚀 Quick Start ### Prerequisites - Node.js 18+ - PostgreSQL 14+ - npm or yarn - Git ### Installation ```bash # Clone repository git clone github.com cd usafibora # Install dependencies npm install # Setup environment variables cp .env.example .env # Edit .env with your configuration # Setup database npm run db:setup npm run db:seed # Start development servers npm run dev ``` ## 📁 Project Structure ``` usafibora/ ├── frontend/ # React web & mobile app │ ├── src/ │ │ ├── components/ # Reusable UI components │ │ ├── pages/ # Page components │ │ ├── features/ # Feature modules (auth, booking, etc) │ │ ├── services/ # API clients │ │ ├── hooks/ # Custom React hooks │ │ ├── context/ # Context providers │ │ ├── styles/ # Global styles & theme │ │ ├── utils/ # Utility functions │ │ └── App.tsx │ └── package.json ├── backend/ # Node.js/Express API │ ├── src/ │ │ ├── api/ # Express routes │ │ ├── services/ # Business logic │ │ ├── models/ # Database models │ │ ├── middleware/ # Auth, validation, error handling │ │ ├── utils/ # Helpers │ │ ├── config/ # Configuration │ │ └── server.ts │ └── package.json ├── database/ # Database schema & migrations │ ├── schema.sql # Complete database …