fmungai001/usafibora
Domaine:
digital infrastructureType de record:
software
Créateur:
fmu
Hôte:
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 …