Skip to content

DuaA-A/SeizureSafe

Repository files navigation

SeizureSafe: Advanced Epilepsy Care Platform

A modern, patient-centric digital health platform designed for caregivers, families, and patients.

Delivered as a Solo Freelance Project • Phase 1 completed in a 72-Hour Sprint • Full-Stack Implementation


Role Full-Stack Developer, UI/UX Designer, System Architect (4th-Year Student)
Tech Stack React.js, Firebase (Auth, Firestore), openFDA API, RxNav API
Timeline 72 Hours (Intensive Phase 1 Sprint)
Target Audience Caregivers, Parents, Family Members, and Patients [cite: 6]

Project Overview

SeizureSafe is a comprehensive platform built to bridge the gap between complex medical data and everyday patient safety. The application was completely engineered from the ground up as a premium healthcare dashboard[cite: 14].

Solo Engineering Highlight: Balancing my 4th-year academic studies with freelance work, I single-handedly engineered this complete medical platform in a 72-hour intensive sprint. I handled the responsive UI/UX design, the backend architecture using Firebase, and complex API integrations to build a real-time Drug Interaction Engine. This project demonstrates my ability to independently deliver a full-stack product under tight deadlines.


Key Features & Functionality (Phase 1)

1. Dynamic & Personalized Onboarding

  • Role-Based Profiles: Custom authentication and flows for Patients, Parents, Caregivers, or Friends[cite: 4, 30, 31, 32, 33, 34, 35].
  • Medical Context: Captures patient age groups [cite: 36], specific epilepsy types [cite: 41], and current medications[cite: 49].
  • Smart Homepage: The dashboard dynamically shifts its content based on the user's profile, providing age-specific tips[cite: 55, 70].

2. Advanced Drug Interaction Engine

Engineered a real-time interaction checker leveraging multiple medical APIs for patient safety.

  • Multi-API Integration: Uses RxNorm/RxNav for drug name normalization [cite: 104] and openFDA to fetch real-time drug labels, contraindications, and food/alcohol warnings[cite: 108, 109, 111, 112, 114].
  • Custom Epilepsy Rules DB: A database tracking specific epilepsy interactions[cite: 118].
  • Clear Severity Coding: Results are displayed using a strict medical color code: Green (Safe), Yellow (Caution), Orange (Warning), Red (Dangerous)[cite: 16, 17, 18, 19].

3. Comprehensive Medication Manager

  • Timeline View: Organizes the patient's daily regimen by Morning, Afternoon, Evening, and Bedtime[cite: 130, 131, 132, 133, 134, 135].
  • Smart Alerts: Automatically scans the active medication list and alerts users to duplicate medications, sedation risks, or dangerous interactions[cite: 156, 157, 158, 159].

4. Seizure Emergency Triage Questionnaire

  • A guided, high-stress-optimized questionnaire (Yes/No format) for caregivers during or immediately after a seizure event[cite: 167, 169].
  • Evaluates factors like duration (>5 mins), breathing, and pregnancy to output an immediate Red/Yellow/Green emergency action plan[cite: 170, 173, 175, 177].

5. Clinical Awareness & First Aid Hub

  • Highly visual guides on what to do (and what NOT to do) during a seizure[cite: 183, 190].
  • Myth vs. Fact cards, emergency checklists, and family awareness planning tools[cite: 85, 86].

UI/UX Philosophy: "Calm & Safe"

Designed a responsive UI/UX focused on accessibility for the target audience.

  • Accessibility First: Large readable text, high contrast, and easy tap targets optimized for mobile-first usage[cite: 10, 22, 23, 24].
  • Calm Aesthetics: Uses a clean medical theme, soft colors, rounded cards, and subtle shadows to reduce cognitive load[cite: 9].

Technical Architecture (Full-Stack)

Click to view Backend & Database Schema Details

The backend is fully powered by Firebase (Authentication, Firestore Database) with a custom normalized schema to handle complex medical intersections:

  • medications: Tracks generic/brand names, dosages, and timing[cite: 229].
  • drug_interactions: Maps Drug A to Drug B with severity descriptors[cite: 230].
  • food_interactions: Maps medications to dietary habits (e.g., dairy)[cite: 231].
  • epilepsy_types: Connects specific diagnoses to common triggers and symptoms[cite: 232].

Phase 2: Future Roadmap

While Phase 1 successfully established the core full-stack architecture in just 72 hours, Phase 2 is planned to include:

  • Automated Push Notifications: Real-time reminders for missed doses and schedule changes[cite: 239, 240, 243].
  • Seizure Tracking Diary: A calendar-based logging system to track frequency, duration, and potential triggers over time.
  • Caregiver Syncing: Allowing multiple family members to link to a single patient profile to share monitoring duties.
  • Doctor Export: Generating PDF reports of medication history and seizure logs to hand directly to neurologists.

Developed by Duaa Abd-Elati Abd-Elazeem

4th-Year Student | Full-Stack Developer | UI/UX Designer

About

A modern, patient-centric digital health platform designed for caregivers, families, and patients.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors