AI-powered health assistant for Ghana — malaria checker, maternal health, ANC passport, CHW tools & Mama Circle community
# AkomaHealth 🇬🇭
**AI-powered health assistant for Ghana** — malaria checker, maternal health triage, digital ANC passport, child growth tracker, CHW visit log, outbreak map, and Mama Circle peer community.
---
## Project Structure
```
akomahealth/
├── index.html ← App shell — all HTML screens
├── css/
│ └── styles.css ← All styles (single file, ~30KB)
├── js/
│ ├── i18n.js ← Translations: English, Twi, Hausa + applyLang()
│ ├── app.js ← Core clinical modules (malaria, ANC, growth, CHW…)
│ └── mama-circle.js ← Mama Circle community feature
├── backend/
│ ├── server.js ← Node.js/Express API server (Supabase + Anthropic)
│ ├── schema.sql ← Supabase database schema (run once in SQL Editor)
│ ├── api.js ← Frontend API client (connects app to backend)
│ ├── package.json ← Backend dependencies
│ └── .env.example ← Environment variable template
├── .gitignore
└── README.md
```
---
## Running the App
### Option A — Frontend only (no backend needed for UI review)
Just open `index.html` in any browser. All screens, navigation, facility finder, prevention tips, growth calculator, and dosing calculator work without a backend.
AI features (malaria checker, maternal triage, health Q&A) need an Anthropic API key — see Configuration below.
### Option B — With backend (full AI + persistent data)
```bash
# 1. Set up Supabase
# - Create a project at supabase.com
# - Run backend/schema.sql in the Supabase SQL Editor
# 2. Configure environment
cd backend
cp .env.example .env
# Edit .env with your keys
# 3. Install and run
npm install
npm start
# 4. Open index.html (use Live Server or: npx serve .)
```
---
## Configuration
### API Key (for standalone AI features)
Open `js/app.js` and find:
```js
const API_KEY = '';
```
Paste your Anthropic API key between the quotes.
> **Leave empty** when running inside claude.ai — authentication is automatic.
### …