
Kurdish Medical App
A lifelong digital medical record for every citizen — owned by the patient, trusted by institutions.
- 1
- Lifelong record per citizen
- 14
- Clinical & care categories
- 2
- Delivery channels (Web + Mobile)
- 248k+
- Synthetic patients in analytics demo
The problem
Healthcare in the region suffers from a fragmented, institution-centric record model. The core gap: there is no continuous, trustworthy, patient-centred record that spans an entire lifetime and every institution.
Records don't travel with the patient
Each hospital keeps its own file. Move city, change provider, or arrive unconscious at an ER — and your history starts from zero.
Paper and memory are the fallback
Allergies, chronic conditions, past surgeries, and medications rely on the patient remembering and correctly reporting them.
No single source of truth
The same patient can exist as several partial identities across systems, causing duplicate tests, drug interactions, and diagnostic delay.
No population-level visibility
Ministries cannot see disease trends or chronic-illness prevalence in near real time, so public-health decisions are slow and reactive.
The solution & how it works
KMA gives every citizen a permanent KMA ID. From that point, every clinical interaction — anywhere in the country — is appended to the same tamper-evident timeline.
Institution Web Portal
Hospitals, clinics, and the Ministry of Health search any patient by KMA ID, name, or phone — then read the full lifelong timeline, register patients, author events, and open the population-health analytics dashboard.
Patient Mobile App
Each citizen logs in with their KMA ID to read their own complete history — diagnoses, prescriptions, surgeries, lab results. Clinical data is strictly read-only; patients may self-update contact and emergency details.
Authoritative Backend
A single API enforces who may write (only the institution that created an event, and only while it is a draft). Once locked, events become a permanent, tamper-evident part of the timeline.
Population-Health Analytics
An aggregation layer turns anonymised records into national intelligence — disease surveillance, medication trends, chronic-disease prevalence, and geographic distribution filterable by time period.
Who benefits
Designed for every layer of the health system — from individual patients to national health authorities.
Patients & Citizens
A permanent record they own and can read anytime. Safer emergency care — allergies and conditions are always available. No need to re-explain history at every new provider.
Doctors & Nurses
Complete, trustworthy history at the point of care — reducing duplicate tests, drug-interaction risk, and diagnostic delay.
Hospitals & Clinics
A shared record that reduces paperwork, prevents duplicate patient identities, and lets referrals carry full context between institutions.
Emergency Services
Instant access to critical information — blood type, allergies, chronic conditions, emergency contacts — even when the patient cannot speak.
Ministry of Health
Near-real-time disease surveillance, chronic-illness prevalence, and demographic trends for proactive, data-driven public-health policy.
Feature set
A complete platform covering patient registration, clinical documentation, care management, and population-health analytics.
- Universal patient search by KMA ID, national ID, name, or phone
- Lifelong medical timeline — newest events first, newest always on top
- 14-category event authoring with free-text and file attachments
- Draft → Lock lifecycle — locked events are permanent and tamper-evident
- Care-management section — consultations, referrals, and follow-up plans
- Patient insights charts — per-patient visual history
- Population-health dashboard — interactive charts with time-period toggles
- Read-only patient mobile app backed by the same live API
- Analytics demo at ~248,500 synthetic patients to demonstrate scale
Technology stack
Built on proven, production-grade open-source tools — fast to build, easy to operate, straightforward to extend.
Web frontend
React 18 + Vite 5, React Router 6
Mobile app
React Native 0.81, Expo SDK 54, TypeScript
Backend API
Node.js ≥22 + Express 4
Database
PostgreSQL 16 (prod) / SQLite (dev)
Authentication
JWT + bcrypt password hashing
File uploads
Multer 2.x — PDF & image attachments
Deployment
Docker + Docker Compose on Linux VPS
TLS
Let's Encrypt — auto-renewing HTTPS
Mobile builds
EAS Build → signed Android APK
Future roadmap
The current build proves the concept end-to-end. The roadmap takes it to full national scale.
Access & identity
- Biometric mobile login (fingerprint / face)
- Emergency break-glass access
- National-ID / e-government integration
Clinical depth
- Full FHIR compliance & HL7 interoperability
- e-Prescribing with drug-interaction alerts
- Immunisation registry & child-growth tracking
Intelligence
- AI clinical assistant — surface risks & suggest follow-ups
- Real epidemiological analytics with outbreak-detection alerting
- Predictive public-health modelling
Platform & reach
- iOS release alongside Android
- Full Arabic & Kurdish (RTL) localisation
- Offline-first mobile mode for low-connectivity areas
The story behind this project
This project started as a personal challenge. My nephew had an idea — a lifelong medical record that belongs to the patient, not the institution — and submitted it to the Medical Exhibition Erbil as an entry in the medical-tech category. She had the vision; the technical implementation was mine.
I designed the data model, built the full-stack platform (web portal, mobile app, and backend API), and prepared a working demo with synthetic patient data at scale. Every part of the engineering — architecture, code, deployment — came from me.
The project was presented at the exhibition on August 11, 2026 in Erbil, Kurdistan Region. It is the kind of system the region genuinely needs, and this prototype shows it is entirely buildable today.
From the exhibition
Photos from Medical Exhibition Erbil · August 11, 2026
Photos will be added after the exhibition.
Interested in KMA?
If you're working in healthcare, government, or digital health investment — I'd love to talk about where this goes next.