🩺 Symptom Scribe — Smart Health & MedTech Platform

# 🩺 Symptom Scribe — Smart Health & MedTech Platform

Symptom Scribe is an AI-powered health and wellness platform designed to help users track health metrics, analyze symptoms, receive personalized recommendations, and improve overall well-being through intelligent insights and interactive experiences.

🌐 **Live Demo:** https://symptom-scribe-clean.netlify.app/

---

# 📑 Table of Contents

- [Project Overview](#-project-overview)
- [Objectives](#-objectives)
- [Key Features](#-key-features)
- [Technology Stack](#%EF%B8%8F-technology-stack)
- [Screenshots](#-screenshots)
- [Installation & Setup](#-installation--setup)
- [Environment Variables](#-environment-variables)
- [Supabase Edge Function Setup](#%EF%B8%8F-supabase-edge-function-setup)
- [API & Backend Services](#-api--backend-services)
- [Project Structure](#-project-structure)
- [Usage Guide](#-usage-guide)
- [Troubleshooting](#%EF%B8%8F-troubleshooting)
- [FAQ](#-faq)
- [Contributing](#-contributing)
- [Future Enhancements](#-future-enhancements)
- [License](#-license)
- [Author](#%E2%80%8D-author)

---

# 📖 Project Overview

Symptom Scribe provides a centralized health management experience that combines:

* Health tracking
* Symptom analysis
* AI-powered recommendations
* Brain-training activities
* Medical education
* Doctor consultation guidance

The goal is to make healthcare monitoring more accessible, engaging, and personalized.

---

# 🎯 Objectives

* Help users monitor daily health metrics.
* Enable symptom tracking and analysis.
* Provide educational health insights.
* Encourage healthier lifestyles through gamification.
* Support informed healthcare decisions.

---

# 🌟 Key Features

## 🧠 Health & Wellness Tracking

* Track hydration, nutrition, activity levels, and wellness goals.
* View health progress over time.
* Personalized wellness recommendations.

## 🩻 Symptom Analysis

* Log and manage symptoms.
* AI-assisted symptom evaluation.
* Health recommendations based on reported symptoms.

## 🎮 Brain Games

* Interactive games designed to improve:

  * Memory
  * Focus
  * Cognitive performance

## 💡 Health Facts

* Educational health facts and medical trivia.
* Daily learning opportunities.
* "Did You Know?" pop-ups with fascinating human body facts and medical trivia.

## 👨‍⚕️ Doctor Consultation Suggestions

* Intelligent recommendations for professional medical consultation.
* Supports early decision-making for health concerns.

## 📊 Health History & Metrics

* Store historical health records.
* Visualize health trends and patterns.

---

# ⚙️ Technology Stack

| Category        | Technologies              |
| --------------- | ------------------------- |
| Frontend        | React + Vite + TypeScript |
| Styling         | Tailwind CSS + ShadCN UI  |
| Backend         | Supabase                  |
| Authentication  | Supabase Auth             |
| Database        | PostgreSQL (Supabase)     |
| Edge Functions  | Supabase Functions        |
| Deployment      | Netlify                   |
| Version Control | Git & GitHub              |

---

# 📸 Screenshots

> Add screenshots of the following sections:

* Dashboard
* Symptom Analyzer
* Health Metrics
* Brain Games
* Settings Page
* Mobile Responsive View


Example:

```md
![Dashboard](screenshots/dashboard.png)
![Symptom Analyzer](screenshots/analyzer.png)
```

---

# 🚀 Installation & Setup

## 1. Clone Repository

```bash
git clone https://github.com/mohdmaazgani/symptom-scribe-clean.git
cd symptom-scribe-clean
```
## 2. Quick Setup

Run the setup script to install dependencies and create `.env.local` from `.env.example` if it doesn't already exist.

```bash
npm install
npm run setup
```

## 3. Configure Environment Variables

Copy the example env file and add your Supabase browser credentials (Dashboard → Project Settings → API):

```bash
cp .env.example .env.local
```

Add the browser variables to `.env.local`:

- `VITE_SUPABASE_URL` — used by the frontend to build the Supabase client and function URLs.
- `VITE_SUPABASE_PUBLISHABLE_KEY` — canonical browser key for authentication and API access.

> [!NOTE]
> `VITE_SUPABASE_ANON_KEY` is accepted only as a legacy fallback when `VITE_SUPABASE_PUBLISHABLE_KEY` is missing. Prefer `VITE_SUPABASE_PUBLISHABLE_KEY` for new and updated environments.

## 4. Link Supabase & Apply Migrations

To ensure your local database contains all the necessary schemas (like `profiles`, `symptom_history`, and custom functions/triggers) so that data can save correctly, link your project and push migrations:

```bash
# Log in to Supabase CLI
npx supabase login

# Link your local repo to your remote project
npx supabase link --project-ref <your-project-ref>

# Push the schema, triggers, and functions to the linked project
npx supabase db push
```

## 5. Install Dependencies

If you already ran `npm install
npm install
npm run setup`, dependencies are already installed. Otherwise run:

```bash
npm install
```

## 6. Start Development Server

```bash


... (truncated)