a health app that is going to be a game changer in Africa and worldwide
# MiqorAI
MiqorAI is a connected health platform made up of multiple client apps backed by one shared Node.js API, one shared PostgreSQL database, Redis, and an optional clinical-safety AI service.
## Repository structure
| Directory | Role | Stack | Dev port |
|-----------|------|-------|----------|
| `server/` | Shared backend API, auth, files, reports, integrations | Node.js, Express, Prisma | 3000 |
| `patient-portal-desktop/` | Patient web portal | Vite, React | 5173 |
| `hospital-portal/` | Hospital staff portal | Vite, React | 8080 |
| `insurance-portal/` | Insurer portal | Vite, React | 8081 |
| `pharmacy-portal/` | Pharmacy portal | Vite, React | 8082 |
| `admin-portal/` | Platform admin portal | TanStack Start, React | 8083 |
| `mobile_patient/` | Patient mobile app | Expo, React Native | Expo default |
Supporting folders:
- `scripts/` - local helper scripts
- `seed_data/` - CSV seed inputs used by the backend seed flow
- `docker-compose.dev.yml` - local Redis support for development
## Current launch story
All portals are meant to talk to the shared backend in `server/`.
The frontends are no longer meant to run as isolated mock-only products for launch. A valid backend, database, and environment configuration are part of the normal system startup story.
## Local development
Install dependencies:
```bash
npm install
npm run install:all
npm install --prefix mobile_patient
```
Start backend plus the main web portals:
```bash
npm run dev:full
```
That starts:
- API:
localhost
- Patient portal:
localhost
- Hospital portal:
localhost
- Insurance portal:
localhost
- Pharmacy portal:
localhost
- Admin portal:
localhost
If you only want backend + patient + hospital:
```bash
npm run dev:core
```
If you only want the backend:
```bash
npm run dev:api
```
## Mobile app
```bash
cd mobile_patient
npm start
```
For local phone testing, point `EXPO_PUBLIC_API_URL` at your compute …