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.
### β¦