MedSignal 🏥💊

A comprehensive medication management platform connecting patients and physicians through secure, FHIR-compliant healthcare data sharing.

MedSignal is a React Native mobile application that helps patients track their medications, maintain adherence, and seamlessly share health data with their physicians. Built with healthcare interoperability standards and enterprise-grade security, MedSignal bridges the gap between personal medication management and professional healthcare oversight.

📱 What is MedSignal?

MedSignal is a dual-interface healthcare application designed for two distinct user roles:

For Patients

A personal medication assistant that:

Tracks your medications and schedules with intelligent reminders
Analyzes prescription photos using AI to automatically extract medication details
Monitors your medication adherence and provides insights
Connects you with trusted contacts (family/caregivers) for support
Enables secure data sharing with your healthcare providers
Helps you find nearby pharmacies and healthcare services
Provides medication alternatives and detailed drug information

For Physicians

A practice management dashboard that:

Monitors patient medication adherence in real-time
Manages patient lists with comprehensive health metrics
Sends prescription requests directly to patients
Tracks key performance indicators (7-day, 30-day adherence rates)
Connects with patients through secure QR code pairing
Accesses FHIR-compliant patient medication data

✨ Core Features

🎯 Patient Features

Medication Management

Smart Entry System: Add medications manually with autocomplete powered by NIH drug database
AI Prescription Scanning: Take a photo of your prescription bottle or label, and OpenAI Vision API automatically extracts:
- Medication name
- Dosage strength
- Quantity
- Instructions
Flexible Scheduling: Set custom medication times (e.g., 8:00 AM, 12:00 PM, 8:00 PM)
Visual Organization: See all your medications in a clean, organized list with edit/delete capabilities

Intelligent Reminders

Push Notifications: Timely medication reminders delivered as notifications
Interactive Actions: Respond directly from notifications:
- ✅ Taken: Mark medication as taken
- ⏰ Snooze: Reminder reappears in 10 minutes
- ❌ Skip: Mark as intentionally skipped
Custom Sounds: Distinctive notification sounds for medication alerts
Persistent Reminders: Notifications work even when app is closed

Adherence Tracking

Visual Analytics: See your medication compliance at a glance
Historical Trends: Track adherence over 7-day and 30-day periods
Per-Medication Stats: Individual compliance metrics for each medication
Streak Tracking: Monitor consecutive days of perfect adherence

Trusted Contacts Network

Add Caregivers: Invite family members or friends to help monitor your medications
Accountability Support: Trusted contacts can receive adherence updates (feature in development)
Emergency Access: Designated contacts for healthcare emergencies
Easy Management: Add, edit, or remove trusted contacts anytime

Prescription Request Management

Physician Integration: Receive prescription requests from your doctors
One-Tap Acceptance: Accept requests to automatically add medications to your tracking
Request History: View all past and pending prescription requests
Notification Alerts: Get notified when physicians send new prescriptions

Healthcare Provider Connections

QR Code Pairing: Scan your physician's QR code to establish secure connection
Secure Data Sharing: Share medication data using FHIR healthcare standards
Privacy Controls: Choose what data to share and with whom
Connection Management: View and manage all physician connections

Location Services

Nearby Pharmacies: Find pharmacies near your current location
Healthcare Providers: Locate doctors, clinics, and hospitals
Interactive Map: Visual map interface powered by React Native Maps
Navigation Integration: Get directions to selected locations

Drug Information

Medication Alternatives: Find generic or alternative medications
Drug Details: Access comprehensive medication information
Cost Comparisons: View pricing information for alternatives
Side Effects: Understand potential side effects and interactions

👨‍⚕️ Physician Features

Practice Dashboard

Real-time KPIs: Monitor key metrics at a glance:
- Total active patients
- Patients seen today
- Average 7-day adherence across practice
- Average 30-day adherence across practice
Animated Statistics: Engaging number animations for metric updates
Professional Interface: Clean, medical-grade user experience

Patient Management

Comprehensive Patient List: View all patients with:
- Name and contact information
- Current medications
- Adherence rates (7-day and 30-day)
- Last visit date
- Risk indicators
Detailed Patient Profiles: Deep dive into individual patient data:
- Complete medication history
- Adherence trends and patterns
- Prescription request history
- Trusted contacts information
Search and Filter: Quickly find patients or filter by adherence level

Prescription Management

Send Prescriptions: Create and send prescription requests to patients
Request Tracking: Monitor which prescriptions have been accepted/declined
Medication Details: Specify dosage, frequency, and duration
Patient Notifications: Patients receive instant alerts for new prescriptions

QR Code System

Secure Pairing: Generate unique QR codes for patient connections
Session-based Security: QR codes expire after use for enhanced security
Easy Onboarding: Patients simply scan to connect with your practice
No Manual Entry: Eliminates errors from manual ID entry

Analytics & Insights

Adherence Trends: Identify patients who need additional support
Practice Performance: Track overall practice medication compliance
Risk Stratification: Flag patients with declining adherence
Data-driven Care: Make informed decisions based on real medication data

🔐 Security & Compliance

Authentication & Authorization

JWT Token System: Industry-standard JSON Web Tokens for authentication
- Access tokens (1-hour expiration)
- Refresh tokens (7-day expiration)
Role-based Access Control: Strict separation between patient and physician interfaces
Secure Password Storage: Argon2 and bcrypt hashing algorithms
Session Management: Persistent, encrypted sessions with automatic cleanup

Data Security

Encrypted Storage: All sensitive data encrypted using Expo SecureStore
HTTPS Communication: All API calls encrypted in transit
Token Isolation: Separate storage for access/refresh tokens (2KB limit compliance)
Automatic Session Validation: Corrupted sessions automatically cleared

Healthcare Compliance

FHIR R4 Standard: Full compliance with healthcare interoperability standards
Medplum Integration: Professional healthcare data platform integration
HIPAA-ready Architecture: Built with healthcare privacy regulations in mind
Audit Logging: Comprehensive logging for security and compliance

API Security

Bearer Token Authentication: RFC 6750 compliant token handling
CORS Protection: Configured cross-origin resource sharing
Request Validation: Server-side validation of all API requests
Rate Limiting: Protection against API abuse (ready for production)

🏗️ Technical Architecture

Frontend Stack

React Native 0.81.4: Cross-platform mobile development
Expo ~54.0.10: Managed workflow with powerful SDKs
TypeScript: Full type safety and developer experience
React Navigation 7: Role-based navigation system
Expo Notifications: Rich push notification system
Expo Camera: QR code scanning capabilities
React Native Maps: Location services and map display

Backend Stack

Node.js with Express 5.1.0: RESTful API server
Better-SQLite3: Fast, embedded database
JWT & Jose: Token generation and validation
Argon2/Bcrypt: Password hashing algorithms
Medplum Client: FHIR healthcare data integration
OpenAI API: AI-powered prescription image analysis
CORS Middleware: Secure cross-origin handling

Healthcare Integration

FHIR R4: Healthcare interoperability standard
Medplum Platform: Professional FHIR server
Patient Resources: Standardized patient data format
MedicationStatement: FHIR medication tracking
RxNorm Coding: Standardized medication identifiers

External Services

NIH Drug API: Medication autocomplete and information
OpenAI Vision API: Prescription image analysis
Medplum FHIR Server: Healthcare data sync and storage
Expo Push Notifications: Cloud notification delivery

🚀 Getting Started

Prerequisites

Node.js 16 or higher
npm or yarn package manager
Expo CLI (installed automatically with dependencies)
iOS Simulator (Mac) or Android Emulator, or physical device
Expo Go app (for device testing)

Installation

Clone the repository:

git clone <repository-url>
cd HackGT12_Attempt2

Install dependencies:
```
npm install
```
Set up environment variables:
```
cp .env.example .env
```
Configure your .env file with:
- MEDPLUM_BASE: Medplum FHIR server URL
- MEDPLUM_CLIENT_ID: Your Medplum client ID
- MEDPLUM_CLIENT_SECRET: Your Medplum client secret
- OPENAI_API_KEY: OpenAI API key for prescription scanning
- PORT: Backend server port (default: 3000)

Running the Application

Windows:

npm run dev-separate

macOS:

npm run dev-separate-mac

Linux:

npm run dev-separate-linux

Single Terminal (All Platforms):

npm run dev

These commands will:

Start the backend server on port 3000
Launch the Expo development server
Open the Expo DevTools in your browser

Testing on Device

Physical Device:

Install Expo Go from App Store (iOS) or Play Store (Android)
Scan the QR code displayed in the terminal
App will load on your device

iOS Simulator (Mac only):

npm run ios

Android Emulator:

npm run android

📖 User Guide

For Patients

Getting Started

Launch App: Open MedSignal
Choose Role: Select "Patient"
Create Account: Sign up with email and password
Grant Permissions: Allow notifications and camera access

Adding Medications

Manual Entry:

Navigate to "Medication Entry" tab
Tap in the medication name field
Start typing - autocomplete suggestions appear
Select your medication from the list
Enter dosage (e.g., "500 mg")
Set quantity on hand
Choose times per day (1-6)
Set specific times for each dose
Tap "Save Medication"

AI Prescription Scanning:

Navigate to "Medication Entry" tab
Tap "📷 Scan Prescription" button
Choose "Take Photo" or "Choose from Library"
Take a clear photo of your prescription label
AI extracts medication details automatically
Review and adjust any details if needed
Tap "Save Medication"

Managing Medications

Edit: Tap medication card, modify details, save changes
Delete: Swipe left on medication or tap delete button
View Schedule: See all doses in the Adherence tab
Mark as Taken: Tap checkmark when you take medication

Responding to Reminders

When a notification appears:

Taken: Tap to mark as taken (tracks adherence)
Snooze: Reminds you again in 10 minutes
Skip: Mark as intentionally skipped (affects adherence)

Tracking Adherence

Navigate to "Adherence" tab
View overall adherence percentage
See per-medication compliance
Check 7-day and 30-day trends
Identify missed doses

Connecting with Physicians

Visit your physician's office
Ask to scan their MedSignal QR code
Open "Share" tab in app
Tap "Scan Physician QR Code"
Allow camera access and scan code
Confirm connection
Your medication data is now securely shared

Managing Prescription Requests

Receive notification of new prescription
Tap notification or open "Prescription Requests" from home
Review medication details from physician
Tap "Accept" to add to your tracking
Or "Decline" if incorrect/unwanted

Adding Trusted Contacts

Navigate to "Trusted Contacts" from home screen
Tap "Add Trusted Contact"
Enter contact information:
- Name
- Relationship (spouse, parent, child, friend, caregiver)
- Phone number
- Email
Tap "Save Contact"
Contact is added to your support network

For Physicians

Getting Started

Launch App: Open MedSignal
Choose Role: Select "Physician"
Create Account: Sign up with credentials
Access Dashboard: View practice overview

Viewing Dashboard Metrics

Total Patients: See total active patient count
Seen Today: Patients with activity today
7-Day Adherence: Average compliance last week
30-Day Adherence: Average compliance last month

Managing Patients

From dashboard, tap "View All Patients"
Browse patient list with adherence indicators
Tap patient card to view details
Review:
- Current medications
- Adherence rates
- Medication history
- Risk indicators

Connecting New Patients

Navigate to "QR Code" tab
Display your unique QR code
Have patient scan code with their device
Connection established automatically
Patient data becomes accessible

Sending Prescriptions

Open patient detail screen
Tap "Send Prescription"
Enter medication details:
- Drug name
- Dosage
- Frequency
- Duration
Tap "Send to Patient"
Patient receives notification instantly
Track acceptance status

Monitoring Patient Adherence

Green indicators: High adherence (>80%)
Yellow indicators: Moderate adherence (60-80%)
Red indicators: Low adherence (<60%)
Detailed view: Tap patient for daily logs

🧪 Testing & Development

Available Scripts

npm run backend          # Run backend server only
npm start                # Run Expo frontend only
npm run dev              # Run both (single terminal)
npm run dev-separate     # Run both (Windows, separate windows)
npm run dev-separate-mac # Run both (macOS, separate terminals)
npm run smoke:share      # Run security test suite

Security Testing

npm run smoke:share

Validates:

JWT token generation
Bearer authentication
API security
BOLA/IDOR protection

Database Management

node initialize-db.js    # Initialize database
node migrate-*.js        # Run migrations
node test-*.js           # Test database operations

🗂️ Project Structure

HackGT12_Attempt2/
├── App.tsx                      # Main app entry point
├── server.js                    # Backend Express server
├── database.js                  # Database operations
├── medsignal.db                 # SQLite database
├── package.json                 # Dependencies
├── app.json                     # Expo configuration
│
├── src/
│   ├── auth/                    # Authentication system
│   │   ├── AuthContext.tsx      # Auth state management
│   │   ├── RoleGuard.tsx        # Role-based routing
│   │   └── session.ts           # SecureStore session management
│   │
│   ├── components/              # Reusable components
│   │   ├── AuthFlow.tsx         # Auth navigation
│   │   ├── DrugSearchField.tsx  # Medication autocomplete
│   │   ├── QRScanner.tsx        # QR code scanner
│   │   └── ...
│   │
│   ├── screens/                 # App screens
│   │   ├── HomeScreen.tsx       # Patient home
│   │   ├── MedicationEntryScreen.tsx
│   │   ├── AdherenceScreen.tsx
│   │   ├── PhysicianDashboard.tsx
│   │   ├── PatientsList.tsx
│   │   └── ...
│   │
│   ├── navigators/              # Navigation setup
│   │   ├── PatientNavigator.tsx
│   │   └── PhysicianNavigator.tsx
│   │
│   ├── services/                # External services
│   │   ├── openaiVision.ts      # Prescription scanning
│   │   ├── physicianApi.ts      # Backend API calls
│   │   └── ...
│   │
│   └── notifications/           # Notification system
│       ├── actions.ts           # Channel setup
│       └── responseHandler.ts   # Action handlers
│
├── scripts/                     # Utility scripts
├── docs/                        # Documentation
└── assets/                      # Images and sounds

🔧 Configuration

Backend Configuration (`.env`)

# Medplum FHIR Integration
MEDPLUM_BASE=https://api.medplum.com/fhir/R4
MEDPLUM_CLIENT_ID=your_client_id
MEDPLUM_CLIENT_SECRET=your_client_secret

# OpenAI Integration
OPENAI_API_KEY=your_openai_api_key

# Server Configuration
PORT=3000
JWT_SECRET=your_secure_jwt_secret

# Environment
NODE_ENV=development

Expo Configuration (`app.json`)

App Name: HackGT12_Attempt2
Bundle ID: com.medsignal.app
Permissions: Camera, Notifications, Location
Plugins: Notifications, SecureStore, Barcode Scanner

🌟 Key Differentiators

Why MedSignal?

AI-Powered: First medication app with prescription scanning using OpenAI Vision
FHIR Compliant: Built on healthcare interoperability standards from day one
Dual Interface: Seamlessly connects patients and physicians in one platform
Adherence Focus: Not just tracking, but actionable compliance insights
Enterprise Security: JWT authentication, encrypted storage, role-based access
Interactive Notifications: Respond to reminders without opening app
Trusted Contacts: Family support network built into the platform
Professional Grade: Healthcare provider dashboard with real analytics

🚧 Roadmap

Coming Soon

Family dashboard for trusted contacts
Apple Health & Google Fit integration
Medication interaction warnings
Refill reminders and pharmacy integration
Telemedicine appointment scheduling
Multi-language support
Wearable device integration (Apple Watch, Fitbit)
Voice-activated medication logging

Under Development

Insurance and cost optimization
Medication disposal guidance
Clinical trial matching
Patient education videos
Social features (community support)

📄 License

🤝 Contributing

MedSignal is a healthcare application handling sensitive medical data. Contributions must maintain:

HIPAA compliance considerations
FHIR standard adherence
Security best practices
Comprehensive testing

📞 Support

For Technical Issues

Check troubleshooting section in docs
Review error logs in server-log.txt
Verify environment configuration

For Healthcare Integration

Medplum documentation: https://www.medplum.com/docs
FHIR specification: https://www.hl7.org/fhir/

Common Issues

Notifications not working:

Grant notification permissions in device settings
Ensure backend server is running
Check notification channel setup (Android)

QR code scanning not working:

Grant camera permissions
Ensure adequate lighting
Hold camera steady over QR code

Backend connection failed:

Verify backend is running on port 3000
Check EXPO_PUBLIC_BACKEND_URL environment variable
Ensure device/emulator is on same network

🏆 Acknowledgments

Built with:

React Native & Expo for cross-platform development
Medplum for FHIR healthcare data management
OpenAI for AI-powered prescription scanning
NIH for comprehensive drug information database
The open-source community for incredible tools and libraries

MedSignal - Empowering patients and physicians through intelligent medication management 🏥💊

Name		Name	Last commit message	Last commit date
assets		assets
components		components
docs		docs
notifications		notifications
screens		screens
scripts		scripts
services		services
src		src
temp/rate_limits		temp/rate_limits
.env.example		.env.example
.env.local.example		.env.local.example
.gitignore		.gitignore
ALTERNATIVES_SCREEN_FIX.md		ALTERNATIVES_SCREEN_FIX.md
AUTH_IMPLEMENTATION_COMPLETE.md		AUTH_IMPLEMENTATION_COMPLETE.md
App.tsx		App.tsx
CAMERA_QR_SCANNING_IMPLEMENTATION.md		CAMERA_QR_SCANNING_IMPLEMENTATION.md
DEV_SETUP.md		DEV_SETUP.md
FHIR-BACKEND.md		FHIR-BACKEND.md
FIXES_SUMMARY.md		FIXES_SUMMARY.md
PASSWORD_FEATURES_IMPLEMENTED.md		PASSWORD_FEATURES_IMPLEMENTED.md
PATIENT_REMOVAL_FEATURES.md		PATIENT_REMOVAL_FEATURES.md
PHYSICIAN_DATA_IMPLEMENTATION.md		PHYSICIAN_DATA_IMPLEMENTATION.md
PRESCRIPTIONS.md		PRESCRIPTIONS.md
PRESCRIPTION_IMPLEMENTATION_COMPLETE.md		PRESCRIPTION_IMPLEMENTATION_COMPLETE.md
PRESCRIPTION_STATUS.md		PRESCRIPTION_STATUS.md
QUICK_TEAM_FIX.md		QUICK_TEAM_FIX.md
REACT_NATIVE_FIX.md		REACT_NATIVE_FIX.md
REACT_NATIVE_PASSWORD_GUIDE.md		REACT_NATIVE_PASSWORD_GUIDE.md
README.md		README.md
SECURITY.md		SECURITY.md
SECURITY_IMPLEMENTATION.md		SECURITY_IMPLEMENTATION.md
SMOKE_TEST_REPORT.md		SMOKE_TEST_REPORT.md
TEAM_SETUP.md		TEAM_SETUP.md
TOKEN_REFRESH_GUIDE.md		TOKEN_REFRESH_GUIDE.md
WARP.md		WARP.md
add-sample-physician-data.js		add-sample-physician-data.js
adherence-calculator.js		adherence-calculator.js
app.json		app.json
auth-config.js		auth-config.js
auth-config.md		auth-config.md
auth-middleware.js		auth-middleware.js
auth-routes.js		auth-routes.js
auth-utils.js		auth-utils.js
check-aspirin.js		check-aspirin.js
check-db-migration.js		check-db-migration.js
check-users.js		check-users.js
cleanup-sample-data.js		cleanup-sample-data.js
clear-accounts.js		clear-accounts.js
clientStorage.js		clientStorage.js
config.js		config.js
create-test-physician.js		create-test-physician.js
database.js		database.js
debug-asyncstorage.js		debug-asyncstorage.js
debug-error.js		debug-error.js
debug-joshhevelow-meds.js		debug-joshhevelow-meds.js
debug-password.js		debug-password.js
debug-prescription.js		debug-prescription.js
debug-profile.js		debug-profile.js
debug-react-error.js		debug-react-error.js
debug-relationships.js		debug-relationships.js
debug-trusted-contact.js		debug-trusted-contact.js
demo-prescription-feature.js		demo-prescription-feature.js
demo-realtime-validation.js		demo-realtime-validation.js
examine-medication-list.js		examine-medication-list.js
force-restart.js		force-restart.js
healthcare.db		healthcare.db
index.js		index.js
initialize-db.js		initialize-db.js
investigate-system.js		investigate-system.js
jwt-manager.js		jwt-manager.js
manual-migrate.js		manual-migrate.js
medication-fix-summary.js		medication-fix-summary.js
medplum.js		medplum.js
medplum.ts		medplum.ts
medsignal.db		medsignal.db
metro.config.js		metro.config.js
migrate-dose-events.js		migrate-dose-events.js
migrate-profiles.js		migrate-profiles.js
network-debug.js		network-debug.js
npm		npm
package-lock.json		package-lock.json
package.json		package.json
populate-physician-portal.js		populate-physician-portal.js
profile-routes.js		profile-routes.js
provider-patient-routes.js		provider-patient-routes.js
quick-test.js		quick-test.js
restart-and-test.js		restart-and-test.js
scheduler.js		scheduler.js
server-log.txt		server-log.txt
server.js		server.js
simple-test.js		simple-test.js
start-expo.bat		start-expo.bat
storage.js		storage.js
temp_local.txt		temp_local.txt
temp_medication.tsx		temp_medication.tsx
temp_original_medication.tsx		temp_original_medication.tsx
temp_upstream.txt		temp_upstream.txt
test-adherence-fix.js		test-adherence-fix.js
test-adherence.js		test-adherence.js
test-ai-endpoints.js		test-ai-endpoints.js

Latest commit

History

Folders and files

Repository files navigation

MedSignal 🏥💊

📱 What is MedSignal?

For Patients

For Physicians

✨ Core Features

🎯 Patient Features

Medication Management

Intelligent Reminders

Adherence Tracking

Trusted Contacts Network

Prescription Request Management

Healthcare Provider Connections

Location Services

Drug Information

👨‍⚕️ Physician Features

Practice Dashboard

Patient Management

Prescription Management

QR Code System

Analytics & Insights

🔐 Security & Compliance

Authentication & Authorization

Data Security

Healthcare Compliance

API Security

🏗️ Technical Architecture

Frontend Stack

Backend Stack

Healthcare Integration

External Services

🚀 Getting Started

Prerequisites

Installation

Running the Application

Windows:

macOS:

Linux:

Single Terminal (All Platforms):

Testing on Device

Physical Device:

iOS Simulator (Mac only):

Android Emulator:

📖 User Guide

For Patients

Getting Started

Adding Medications

Managing Medications

Responding to Reminders

Tracking Adherence

Connecting with Physicians

Managing Prescription Requests

Adding Trusted Contacts

For Physicians

Getting Started

Viewing Dashboard Metrics

Managing Patients

Connecting New Patients

Sending Prescriptions

Monitoring Patient Adherence

🧪 Testing & Development

Available Scripts

Security Testing

Database Management

🗂️ Project Structure

🔧 Configuration

Backend Configuration (.env)

Expo Configuration (app.json)

🌟 Key Differentiators

Why MedSignal?

🚧 Roadmap

Coming Soon

Under Development

📄 License

🤝 Contributing

📞 Support

For Technical Issues

Backend Configuration (`.env`)

Expo Configuration (`app.json`)