AI powered ride hailing app for Ghana and West Africa
# MOVR Platform - African Super-App
MOVR is a comprehensive platform combining ride-hailing, e-commerce, delivery, rentals, digital wallet, and blockchain rewards into a unified ecosystem.
## Project Structure
```
movr-platform/
├── backend/ # Node.js/Express API
│ ├── src/
│ │ ├── index.ts # Express app + Socket.io
│ │ ├── routes/ # API endpoints (11 modules)
│ │ ├── services/ # Business logic services
│ │ ├── middleware/ # Auth, logging
│ │ └── config/ # Database, Redis config
│ └── package.json
├── frontend/
│ ├── web/ # Customer web app (React + Vite)
│ │ ├── src/
│ │ │ ├── pages/ # Page components
│ │ │ ├── components/ # Reusable components
│ │ │ ├── services/ # API client
│ │ │ ├── store/ # Zustand state
│ │ │ ├── hooks/ # Custom React hooks
│ │ │ └── App.tsx
│ │ └── package.json
│ ├── admin/ # Admin dashboard (React + Vite)
│ │ ├── src/
│ │ │ ├── pages/
│ │ │ ├── components/
│ │ │ └── App.tsx
│ │ └── package.json
│ └── public-website/ # Marketing website
└── docker-compose.yml # PostgreSQL + Redis
```
## Tech Stack
### Backend
- **Framework**: Express.js + Socket.io
- **Language**: TypeScript
- **Database**: PostgreSQL 15 + PostGIS
- **Cache**: Redis 7
- **Auth**: JWT + Passport.js
- **Payments**: Stripe, Flutterwave
- **Monitoring**: Winston, Sentry
### Frontend
- **Framework**: React 18 + Vite
- **State**: Zustand + React Query
- **Styling**: Tailwind CSS
- **Forms**: React Hook Form + Zod
- **Maps**: Leaflet, React Leaflet
- **Real-time**: Socket.io-client
## Getting Started
### Prerequisites
- Node.js 18+ (LTS)
- pnpm 10+
- PostgreSQL 15
- Redis 7
- Docker & Docker Compose (optional)
### Installation
1. **Install dependencies**:
```bash
pnpm install
```
This installs dependencies for:
- Backend (`backend/ …