FearlessHealth is an open-source hospital management system built for small and medium-sized clinics in Africa. It digitises patient records, appointments, and billing — with XLM payments on Stellar and cryptographic patient consent tokens.
# FearlessHealth
> Healthcare infrastructure for every clinic — powered by Stellar blockchain.
FearlessHealth is an open-source hospital management system built for small and
medium-sized clinics in Africa. It digitises patient records, appointments, and
billing — with XLM payments on Stellar and cryptographic patient consent tokens.
## Live Demo
🌐 **Try the demo →**
📋 **Join the waitlist →**
🔌 **API health →**
## Features
| Module | Description |
|---|---|
| **Auth** | JWT login with role-based access (admin, doctor, nurse, patient) |
| **Patients** | Digital records, full history, blood type, emergency contacts |
| **Doctors** | Directory, specializations, Stellar wallet linked |
| **Appointments** | Scheduling with conflict detection, status tracking |
| **Medical Records** | Diagnosis, treatment, medications — consent-gated |
| **Billing** | Invoices in USD, paid via Stellar XLM |
| **Consent Tokens** | Patient grants/revokes doctor access via Stellar custom assets |
| **Analytics** | Impact dashboard for grant reporting |
| **Waitlist** | Public signup page for clinic interest |
## Stellar Integration
### Payments
Invoices are created in USD, converted to XLM at live market rate, and paid via
Stellar testnet transactions. Every payment is logged with a transaction hash
verifiable on Stellar Expert.
### Patient Consent Tokens
When a patient grants a doctor access to their records, a custom Stellar asset
is issued to the doctor's wallet — cryptographic proof of consent. Revoking access
claws the token back. Access is verified on-chain before records are returned.
## Tech Stack
- **Backend:** Node.js + TypeScript + Express
- **Database:** SQLite (dev) / PostgreSQL (production)
- **Blockchain:** `@stellar/stellar-sdk`
- **Frontend:** React + TypeScript + Vite + Tailwind CSS
## Quick Start
```bash
# Clone and install
git clone
github.com
cd fearlesshealth-app
npm install
# Configure environment
cp .env.example …