HealthCompanion

A comprehensive healthcare management platform with 28+ fully functional modules providing inclusive, patient-centered care with robust mental health support, advanced trend analysis, AI insights, and complete file management. Built with React, TypeScript, Vite, and Supabase.

🔗 GitHub Repository: https://github.com/Nili-L/HealthCompanion

Overview

HealthCompanion is a full-featured healthcare portal supporting both patient and provider workflows. The platform emphasizes mental health tracking, evidence-based assessments, inclusive care practices, intelligent data analytics with AI-powered insights, community support, and comprehensive health journey visualization.

🎯 All Modules (28 Fully Functional)

Personal Health Management

Patient Profile - Demographics, providers, emergency contacts, kupat holim
Health History - Mental, physical, familial, genetic history tracking
Period Tracking ✨ NEW - Menstrual cycle monitoring with predictions
Patient Journal ✨ NEW - Private reflections and knowledge base

Medical Records & Documentation

Medical Documents - File upload/download with Supabase Storage
Medical Imaging ✨ NEW - X-rays, MRI, CT scans, ultrasounds
OCR Scanning ✨ NEW - Extract text from medical documents
Media Library ✨ NEW - Art, music, photos, therapeutic content

Clinical Tracking & Monitoring

Medication Tracking - Schedules, adherence, refill requests
Symptom Tracking - Daily logs with AI-powered trend analysis
Lab Results & Vitals - Charts with week-over-week trends
Appointment Scheduling - Calendar-based booking system

Mental Health & Assessments

Mental Health Questionnaires - PHQ-9, GAD-7, PCL-5, ASRS, PSS-10, Y-BOCS with score trends

Communication & Care

Secure Messages - Patient-provider and patient-patient messaging
Community Platform ✨ NEW - Peer support, forums, anonymous posting
Care Team - Healthcare provider directory
Follow-Up Plans ✨ NEW - Post-appointment action tracking

Financial & Insurance

Insurance & Billing - Policies, claims, payment history
Financial Management ✨ NEW - Receipts, refunds, authorizations, permits

Goals & Planning

Health Goals - Goal setting with progress tracking
To-Do Lists ✨ NEW - Manual and OCR-generated tasks

Analytics & Insights

Health Insights ✨ NEW - AI-generated reports with comparisons
Health Timeline ✨ NEW - 3D visualization of health journey

Tools & Organization

Mind Maps ✨ NEW - Visual health factor connections
Request Templates ✨ NEW - Pre-filled forms for common requests

Support & Help

Support Tickets ✨ NEW - Issue tracking system
Help & FAQs ✨ NEW - Documentation and tutorials
Search & Export - Integrated across multiple modules

✨ Latest Features (v1.2.0)

🆕 16 New Modules Added

Health Tracking Enhancements

Period Tracking: Cycle monitoring, symptom tracking, flow intensity, predictions
Medical Imaging: Comprehensive imaging study management (X-Ray, MRI, CT, Ultrasound, PET, Mammogram)
OCR Scanning: Automatic text extraction from medical documents and prescriptions

Personal Tools

Patient Journal: Private reflections, mood tracking, searchable entries with tags
Media Library: Store art, music, photos, and therapeutic content with categorization
To-Do Lists: Task management with manual, OCR-extracted, and system-generated tasks
Mind Maps: Node-based visualization of health connections and relationships

Communication & Community

Community Platform: Social support network with forums, anonymous posting, likes, and comments
Follow-Up Plans: Post-appointment care tracking with due dates and task management

Financial & Administrative

Financial Management: Complete system for receipts, refunds, payments, authorizations, and permits
Support Tickets: Priority-based issue tracking with categories and status management
Request Templates: Pre-filled forms for records, referrals, prescriptions, appointments, and authorizations

Analytics & Visualization

Health Insights: AI-generated reports with side-by-side trend comparisons
Health Timeline: Interactive 3D visualization of health journey over time

Support & Documentation

Help & FAQs: Comprehensive documentation, searchable FAQs, video tutorials

📊 Intelligent Trend Analysis

Symptom Tracking Trends

Week-over-week comparison with AI-powered pattern recognition
Visual trend indicators (TrendingUp/Down) with color-coded alerts
Correlation detection (e.g., "Higher stress correlates with poorer sleep")
Multi-metric analysis tracking anxiety, depression, stress, pain, sleep quality
Smart insights: "Anxiety improved 25%" or "Pattern: stress affects sleep"

Mental Health Questionnaire Score Trends

Latest score prominently displayed on questionnaire cards
Percentage change between assessments with visual arrows
Progress detection: "Your symptoms have improved by 5 points since your last assessment"
Historical comparison in assessment history view

Lab Results & Vitals Trend Indicators

Summary Stats Cards showing latest values for key vitals
Week-over-week trend badges (improving/declining/stable)
Vital sign card comparisons (BP, glucose, heart rate) vs previous readings
Lab result trend tracking comparing current vs previous tests
Color-coded indicators: green (good), red (concerning), gray (stable)
Inverse logic handling (lower BP = better, higher O2 = better)

📁 File Upload/Download System

Medical Documents with Supabase Storage

Real file upload (not just references) with 10MB limit
Supported formats: PDF, Word docs, images (JPG, PNG, GIF), text files
Secure signed URL downloads (60-second expiration)
Automatic file deletion when documents are removed
File metadata tracking (name, size, type, storage path)
Upload progress indicators and file preview
See SUPABASE_STORAGE_SETUP.md for configuration details

Media Library

Upload art, music, photos, videos, and documents
Category-based organization
File type detection and validation
Download and sharing capabilities

🧠 Mental Health Features

Comprehensive Symptom Tracking with AI Insights

Track symptoms across multiple categories:

Depression symptoms (13 specific items)
Anxiety symptoms (15 specific items)
Panic attack tracking (13 symptoms)
PTSD symptoms (12 items)
Complex PTSD symptoms (10 items)
Dissociation scale
EDS/Hypermobility symptoms (15 items + 15 joint locations)
Migraine tracking with phases, aura symptoms
Hormonal tracking for men and women
Cross-cutting: pain scale, fatigue, sleep quality, stress, mood, triggers

AI-Powered Insights Card

Automatic pattern detection across all metrics
Color-coded insights (green = positive, amber = warning, blue = info)
Examples:
- ✅ "Anxiety levels improved by 25% compared to last week. Keep up the great work!"
- ⚠️ "Depression symptoms worsened by 30%. Please consult with your provider."
- ℹ️ "Pattern detected: Higher stress correlates with poorer sleep"
- 🎉 "Excellent progress! 3 key metrics are improving this week"
Correlation analysis between metrics

Evidence-Based Mental Health Assessments

PHQ-9 (Depression): 9-item questionnaire with severity classification
GAD-7 (Anxiety): 7-item scale with clinical cutoffs
PCL-5 (PTSD): 20-item assessment for trauma symptoms
ASRS (ADHD): Adult ADHD Self-Report Scale with Part A & B
PSS-10 (Stress): Perceived Stress Scale
Y-BOCS (OCD): Yale-Brown Obsessive Compulsive Scale

Features:

Interactive questionnaires with progress tracking
Score calculation with severity interpretation
Historical trend analysis comparing assessments over time
Visual indicators showing improvement/decline
Detailed results view with item-level breakdown
Export functionality for sharing with providers

👥 Community & Communication

Community Platform

Forum-style discussions with categories
Anonymous posting option for privacy
Post likes, comments, and sharing
Active member statistics
Safe, supportive peer environment

Secure Messaging

Patient-to-provider messaging
Patient-to-patient communication
Threaded conversations
Read receipts and urgent flags
Attachment support

🗂️ Organizational Tools

To-Do Lists

Manual task entry
OCR-extracted tasks from documents
System-generated tasks from appointments
Priority levels and due dates
Completion tracking

Mind Maps

Node-based visualization system
Create connections between health factors
Drag-and-drop interface
Export and share functionality

Request Templates

Pre-filled forms for:

Medical records requests
Specialist referrals
Prescription refills
Appointment requests
Insurance authorizations
Lab results requests

💰 Financial Management

Complete Financial Tracking

Receipts: Download and organize medical receipts
Refunds: Track refund requests and status
Payments: Payment history with status badges
Authorizations: Pre-authorization tracking for procedures
Permits: Medical parking permits, equipment permits

📈 Analytics & Visualization

Health Insights Reports

AI-generated trend analysis
Side-by-side metric comparisons
Mental health trends (anxiety, stress, sleep)
Physical health trends (BP, pain, energy)
Comprehensive 30-day health summary
PDF export and email to provider

Health Timeline

Interactive 3D visualization
Scroll through health history
Key events timeline
Trend summaries by period
Week/month/year/all-time views

🛠️ Technical Stack

Frontend

React 18 with TypeScript
Vite for fast build tooling
Tailwind CSS for styling
shadcn/ui component library (50+ Radix UI components)
Recharts for data visualization
Lucide React for icons

Backend

Supabase for authentication and storage
Hono server framework on Deno
Edge Functions for serverless API
KV Store for data persistence

Features

File Upload: Supabase Storage with signed URLs
Authentication: JWT-based with Supabase Auth
Real-time Updates: Optimistic UI updates
Responsive Design: Mobile-first approach

🚀 Getting Started

Prerequisites

Node.js 18+ and npm
Supabase account (free tier works)

Installation

# Clone the repository
git clone https://github.com/Nili-L/HealthCompanion.git
cd HealthCompanion

# Install dependencies
npm install

# Start development server
npm run dev

The app will open at http://localhost:3000

Demo Accounts

Demo accounts start with empty profiles for users to fill in their own information.

Patient: patient@demo.com / demo123
- Empty profile ready to be completed
- No pre-filled data - start fresh
Provider: provider@demo.com / demo123

Note: Demo accounts provide a clean slate for testing the application with your own data.

📡 API Endpoints

Authentication

POST /make-server-50d6a062/signup - Create new account
POST /make-server-50d6a062/login - User login
GET /make-server-50d6a062/user - Get user info

Health Records

GET/PUT /make-server-50d6a062/profile - Patient profile
GET/PUT /make-server-50d6a062/health-history - Health history

Medications & Providers

GET/POST/PUT/DELETE /make-server-50d6a062/medications
GET/POST/PUT/DELETE /make-server-50d6a062/providers
GET/POST/PUT/DELETE /make-server-50d6a062/emergency-contacts
GET/POST/PUT/DELETE /make-server-50d6a062/kupat-holim

Documents & Imaging

GET/POST/DELETE /make-server-50d6a062/documents
POST /make-server-50d6a062/documents/upload - File upload
GET /make-server-50d6a062/documents/:id/download - Signed URL
GET/POST /make-server-50d6a062/imaging - Medical imaging

Clinical Data

GET/POST/PUT/DELETE /make-server-50d6a062/appointments
GET/POST /make-server-50d6a062/lab-results
GET/POST /make-server-50d6a062/vitals
GET/POST/DELETE /make-server-50d6a062/symptoms

Mental Health

GET/POST/PUT/DELETE /make-server-50d6a062/questionnaires
GET/POST /make-server-50d6a062/questionnaire-responses
GET/PUT /make-server-50d6a062/assigned-questionnaires

Communication

GET/POST /make-server-50d6a062/messages
GET/POST/DELETE /make-server-50d6a062/care-team

Financial & Planning

GET/PUT /make-server-50d6a062/insurance
GET/POST/PUT/DELETE /make-server-50d6a062/goals
GET/POST /make-server-50d6a062/follow-up-plans

New Module Endpoints ✨

GET/POST /make-server-50d6a062/periods - Period tracking
GET/POST/DELETE /make-server-50d6a062/media - Media library
GET/POST/DELETE /make-server-50d6a062/journal - Patient journal
GET/POST/PUT /make-server-50d6a062/todos - To-do lists
GET/POST /make-server-50d6a062/tickets - Support tickets
GET/POST /make-server-50d6a062/community/posts - Community posts
POST /make-server-50d6a062/community/posts/:id/like - Like post

🗂️ Project Structure

src/
├── components/
│   ├── ui/                          # shadcn/ui components (50+)
│   ├── PatientProfile.tsx           # Profile management
│   ├── HealthHistory.tsx            # Health intake
│   ├── MedicationManager.tsx        # Medication tracking
│   ├── MedicalDocuments.tsx         # Document management
│   ├── AppointmentScheduling.tsx    # Appointments
│   ├── LabResultsVitals.tsx         # Labs & vitals with trends
│   ├── SymptomTracking.tsx          # Symptom tracking with AI
│   ├── SecureMessages.tsx           # Messaging system
│   ├── CareTeam.tsx                 # Provider directory
│   ├── InsuranceBilling.tsx         # Insurance & billing
│   ├── HealthGoals.tsx              # Goal tracking
│   ├── MentalHealthQuestionnaires.tsx # Assessments
│   ├── PeriodTracking.tsx           # ✨ NEW
│   ├── MediaLibrary.tsx             # ✨ NEW
│   ├── OCRScanning.tsx              # ✨ NEW
│   ├── CommunityPlatform.tsx        # ✨ NEW
│   ├── PatientJournal.tsx           # ✨ NEW
│   ├── TodoLists.tsx                # ✨ NEW
│   ├── InsightReports.tsx           # ✨ NEW
│   ├── FollowUpPlans.tsx            # ✨ NEW
│   ├── FinancialManagement.tsx      # ✨ NEW
│   ├── TicketSystem.tsx             # ✨ NEW
│   ├── TimelineVisualization.tsx    # ✨ NEW
│   ├── RequestTemplates.tsx         # ✨ NEW
│   ├── MindMaps.tsx                 # ✨ NEW
│   ├── HelpManual.tsx               # ✨ NEW
│   ├── MedicalImaging.tsx           # ✨ NEW
│   └── HealthcareDashboard.tsx      # Main dashboard
├── supabase/
│   └── functions/
│       └── server/
│           ├── index.tsx            # API server (440+ endpoints)
│           └── kv_store.tsx         # Data persistence
└── utils/
    └── supabase/
        ├── client.tsx               # Supabase client
        └── info.tsx                 # Configuration

🔐 Security & Privacy

HIPAA-Aware Design: Secure data handling practices
Authentication: JWT tokens with Supabase Auth
Private Storage: RLS policies on Supabase Storage
Signed URLs: Time-limited file access (60s)
User Isolation: Data segregated by user ID
Anonymous Options: Community posts can be anonymous

🌟 Inclusive Care Features

Chosen Name & Pronouns: Respect patient identity
Gender-Affirming Care: Specialized tracking
Customizable Forms: Flexible intake questions
Accessibility: WCAG 2.1 considerations
Cultural Sensitivity: Inclusive language throughout

📦 Build & Deploy

# Development
npm run dev

# Production build
npm run build

# Preview production build
npm run preview

Build output: build/ directory

Bundle size: ~1,280 KB (334 KB gzipped)
2,428 modules transformed
Build time: ~22 seconds

🗺️ Roadmap

Near-Term

Implement dynamic imports for code splitting
Add unit tests for components
Provider-specific module variations
Enhanced data visualization
Mobile app (React Native)

Future Enhancements

📄 License

MIT License - see LICENSE file for details

🤝 Contributing

Contributions welcome! Please read CONTRIBUTING.md for guidelines.

📞 Support

Documentation: See /help in the app
Issues: GitHub Issues
Email: support@healthcompanion.example

🙏 Acknowledgments

Built with shadcn/ui
Icons by Lucide
Charts by Recharts
Backend by Supabase

Version: 1.2.0 Last Updated: 2025-10-02 Status: ✅ Production Ready - 28 Fully Functional Modules

Name		Name	Last commit message	Last commit date
Latest commit History 19 Commits
.claude		.claude
.github/workflows		.github/workflows
.husky		.husky
electron		electron
public		public
src		src
supabase/migrations		supabase/migrations
.env.example		.env.example
.gitignore		.gitignore
.lintstagedrc.json		.lintstagedrc.json
.npmrc		.npmrc
ANDROID_BUILD.md		ANDROID_BUILD.md
BEFORE_AFTER_SUMMARY.md		BEFORE_AFTER_SUMMARY.md
BUILD.md		BUILD.md
BUILD_SUMMARY.md		BUILD_SUMMARY.md
CLAUDE.md		CLAUDE.md
FINAL_REPORT.md		FINAL_REPORT.md
HIPAA_COMPLIANCE.md		HIPAA_COMPLIANCE.md
IMPROVEMENTS_SUMMARY.md		IMPROVEMENTS_SUMMARY.md
QUICK_START_ANDROID.md		QUICK_START_ANDROID.md
README.md		README.md
RELEASE_NOTES.md		RELEASE_NOTES.md
REVIEW_SUMMARY.md		REVIEW_SUMMARY.md
SECURITY.md		SECURITY.md
SUPABASE_STORAGE_SETUP.md		SUPABASE_STORAGE_SETUP.md
UX_IMPROVEMENTS_SUMMARY.md		UX_IMPROVEMENTS_SUMMARY.md
UX_REVIEW_REPORT.md		UX_REVIEW_REPORT.md
capacitor.config.ts		capacitor.config.ts
eslint.config.js		eslint.config.js
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts
vitest.config.ts		vitest.config.ts

Folders and files

Latest commit

History

Repository files navigation