Pulseo - AI Health Diagnosis & Symptom Checker for Africa
# Pulseo — AI Health Assistant
Pulseo is a mobile-first AI-powered symptom checker and health management app built for Africa. Users describe their symptoms through a guided flow and receive preliminary AI-powered insights via Google Gemini. The app also manages personal health records, locates nearby clinics, and provides emergency SOS with contact notification.
**Live URL:**
pulseo-297868129457.us-cent…
---
## Prerequisites
- **Node.js** 22 or later (matches the production Docker image)
- A **Firebase** project with Firestore, Authentication, and Storage enabled
- A **Google Gemini** API key (`gemini-2.0-flash` or later)
- A **Google Places** API key (for nearby doctor search)
---
## Local Setup
```bash
# 1. Install dependencies
npm install
# 2. Copy the environment template and fill in values (see section below)
cp .env.local.example .env.local
# 3. Start the development server
npm run dev
```
Open
localhost in your browser. The root route redirects to `/welcome`.
---
## Environment Variables
Create `.env.local` with the following keys:
| Variable | Description | Where to get it |
|---|---|---|
| `NEXT_PUBLIC_FIREBASE_API_KEY` | Firebase web API key | Firebase Console → Project Settings → General |
| `NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN` | Firebase auth domain (` .firebaseapp.com`) | Firebase Console → Project Settings |
| `NEXT_PUBLIC_FIREBASE_PROJECT_ID` | Firebase project ID | Firebase Console → Project Settings |
| `NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET` | Storage bucket (` .appspot.com`) | Firebase Console → Storage |
| `NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID` | Cloud Messaging sender ID | Firebase Console → Project Settings → Cloud Messaging |
| `NEXT_PUBLIC_FIREBASE_APP_ID` | Firebase app ID | Firebase Console → Project Settings → Your apps |
| `NEXT_PUBLIC_FIRESTORE_DATABASE` | Firestore database name (omit for `(default)`) | Firebase Console → Firestore |
| `NEXT_PUBLIC_GOOGLE_PLACES_API_KEY` | Google Places API …