MediSync

Unified health intelligence platform with a React + Vite frontend and Node.js + Express backend, including wearable data streaming, medication tracking, care planning, nutrition logs, insurance, documents, and AI-style health insights.

Features

• Health dashboard and profile experience
• Medication and symptom tracking
• Provider/doctor planning tools
• Live wearable stream (WebSocket)
• Intelligence insights and correlation analysis
• Family medication tracking
• Nutrition logging
• Insurance support workflows
• Document management and timeline support

Tech Stack

• Frontend: React, Vite, React Router, TailwindCSS
• Backend: Node.js, Express
• Database: SQLite + Knex migrations
• Realtime: WebSocket (ws)

Repository Structure

mediSync/
├── client/          # React frontend
├── server/          # Express API, services, routes, tests
├── knexfile.js      # Knex/SQLite config
├── .env.example     # Environment template
└── package.json     # Root scripts for full-stack dev

Prerequisites

• Node.js 18+ (recommended)
• npm 9+ (recommended)

Setup

1. Clone and enter the project.

2. Install dependencies:

   npm run install:all

3. Create environment file:

   cp .env.example .env

4. Update .env keys as needed.
   The app supports mock/fallback behavior when many keys are missing.

Run the App

Start frontend + backend together

npm run dev

• Client: http://localhost:5173
• Server: http://localhost:3001

Start backend only

npm run server

Start frontend only

npm run client

Database

The backend uses SQLite (server/data/medisync.sqlite3) and runs migrations at server startup.

Manual migration commands:

npm run migrate
npm run migrate:rollback

Seed demo data:

npm run seed

Core API Modules

• /api/users
• /api/medications
• /api/symptoms
• /api/drugs
• /api/providers
• /api/wearable
• /api/intelligence
• /api/family
• /api/insurance
• /api/nutrition
• /api/documents
• /api/timeline
• /api/symptom-logs

Health check endpoint:

• GET /health

Build and Test

Frontend build:

npm --prefix client run build

Server tests:

node --test server/tests/*.test.js

Environment Variables

See .env.example for all keys. Integrations include:

• openFDA
• Infermedica
• Nutritionix
• USDA FoodData Central
• Healthcare.gov
• Anthropic (optional insight explanations)

Notes

• Current client lint script references ESLint, but ESLint is not present in client/devDependencies.
• Large frontend bundle warnings may appear during production build; functionality is unaffected.