Skip to content

studycom69-debug/momsafe

Repository files navigation

MomSafe AI

MomSafe AI

Typing animation



Stars Forks Last Commit License

React 19 TypeScript Supabase Tailwind v4 Vercel


IoT Contract




πŸš€ Live Application

Production deployment β€” live and fully functional

Open MomSafe AI


πŸ‘† Click to open the live app Β· Deployed on Vercel Β· No installation required



Pregnancy is one of the most critical health periods in a person's life. MomSafe AI delivers a real-time intelligence layer for expectant mothers β€” combining AI risk scoring, clinical vitals monitoring, and IoT wearable hardware into one beautifully designed platform.


🌍 Why MomSafe?

The Problem

Maternal health complications remain a significant challenge worldwide. Many risks develop between clinical visits, where continuous monitoring and proactive guidance are often unavailable.

The Solution

MomSafe AI combines real-time vitals monitoring, maternal risk scoring, AI-powered guidance, nutrition tracking, daily health logging, hospital discovery, and wearable integration into a unified maternal healthcare platform.

The Vision

Every pregnancy deserves intelligent care. MomSafe AI aims to make maternal healthcare more proactive, accessible, and data-driven through AI and real-time health insights.


πŸ“Š Platform Highlights

Highlight Detail
🧩 8+ healthcare modules Dashboard · Vitals · AI Guidance · Nutrition · Daily Logs · Alerts · Analytics · Hospital Finder
πŸ€– AI-powered maternal guidance Rule-based risk engine + guidance engine β€” explainable, real-time, trimester-aware
πŸ’“ Real-time vitals monitoring Heart rate Β· BP Β· SpOβ‚‚ Β· temperature Β· weight β€” persisted to Supabase
⚑ React 19 + TypeScript frontend Fully type-safe · Vite 7 · Tailwind CSS v4 · Framer Motion
πŸ—„οΈ Real-time Supabase backend PostgreSQL with Row Level Security Β· live data sync
πŸ” Google OAuth authentication Secure sign-in via Supabase Auth β€” no passwords stored
πŸ”Œ ESP32 wearable integration C++/Arduino firmware Β· Wi-Fi vitals ingestion via Edge Functions
🌐 Live production deployment Hosted on Vercel · zero-config CI/CD · always-on

✨ Current Features

πŸ₯ Command Center πŸ’“ Vitals Intelligence πŸ€– AI Guidance
Proprietary Maternal Risk Index synthesizes all health data into one color-coded score with live AI alerts Heart rate Β· blood pressure Β· SpOβ‚‚ Β· temperature Β· weight β€” with trimester-specific safe-zone overlays Explainable rule-based engine generates "Do This Now" action cards β€” no black-box AI
πŸ“Š Analytics πŸ₯— Nutrition & Daily Logs πŸ“ Hospital Finder
Health trend charts for vitals over time β€” heart rate, BP, SpOβ‚‚, weight β€” powered by Recharts Meal logging with AI macro analysis Β· calorie goals Β· water intake Β· sleep Β· mood Β· symptom tracking Geolocated Leaflet map surfaces nearby medical facilities Β· Emergency SOS mode

πŸ”Œ Full IoT Layer β€” C++/Arduino firmware on ESP32 auto-ingests temperature and step data over Wi-Fi into Supabase Edge Functions, closing the loop from wearable sensor to dashboard in seconds.


πŸ—οΈ Architecture

MomSafe AI β€” Maternal Health AI Ecosystem Architecture Diagram

Flow: ESP32 β†’ Edge Function (validate + write) β†’ PostgreSQL β†’ TanStack Query β†’ AI risk engine β†’ real-time dashboard update.


πŸ“Έ Screenshots

Command Center Β· MRI score Β· live vitals Β· AI alerts Vitals Intelligence Β· heart rate Β· BP Β· SpOβ‚‚ Β· trends
AI Guidance Engine Β· trimester-aware "Do This Now" recommendations Analytics Overview Β· multi-factor health correlation charts
πŸ“· View all screenshots β€” Nutrition, Medication, Hospital Finder
Analytics & Health Trends Nutrition Tracker
Meal Logging & Food Recommendations Medication Schedule (UI)
Hospital Finder

πŸ› οΈ Tech Stack

Layer Technology
Frontend React 19 Β· Vite 7 Β· TypeScript 5
Styling & Motion Tailwind CSS v4 Β· Framer Motion
Data & Charts TanStack Query v5 Β· Recharts
UI System Radix UI Β· shadcn/ui Β· Lucide React
Backend Supabase β€” PostgreSQL Β· Google OAuth Β· Realtime
Serverless Supabase Edge Functions (esp32-ingest)
IoT ESP32 Β· C++/Arduino
Hosting Vercel

πŸš€ Getting Started

Prerequisites: Node.js 20+, Supabase project, Google OAuth configured.

git clone https://github.com/studycom69-debug/momsafe.git
cd momsafe && npm install

Create .env.local:

VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_ANON_KEY=your-anon-key
# Apply migrations in Supabase SQL Editor β†’ artifacts/momsafe-ai/supabase/migrations/
npm run dev

πŸ”Œ Deploy ESP32 edge function: npx supabase functions deploy esp32-ingest Β· Full guide in ESP32_INTEGRATION.md


πŸ—ΊοΈ Future Roadmap

  • Medication persistence β€” save schedules and doses to the database
  • Fetal kick counter & movement tracking
  • Glucose monitoring integration
  • Doctor / care-team shared dashboard
  • Push notifications on threshold breach
  • PWA + offline sync mode
  • Bluetooth LE wearable support

🀝 Contributing

git checkout -b feat/your-feature
# make changes
npm run typecheck   # must pass
git commit -m "feat: your feature description"
# open PR against main

All contributions welcome β€” clinical accuracy, mobile UX, i18n, new sensor types, accessibility.


Built with πŸ’™ for every mother and child.

MomSafe AI β€” Because every pregnancy deserves intelligent care.

Live Demo

About

AI-powered maternal healthcare platform with real-time vitals monitoring, maternal risk scoring, AI guidance, nutrition tracking, medication management, hospital discovery, and ESP32 wearable integration.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages