Skip to content

shaikhhabib001/monitor-health

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Monitor Health

Smart Health Monitoring Dashboard — collect, visualize, and alert on vital sign data in (near) real time.


🚀 Features

  • Real-time data ingestion of physiological metrics (heart rate, SpO₂, temperature, etc.)
  • Trend charts and historical views
  • Alerts / thresholds (notify when values go out of safe bounds)
  • User management & authentication (if implemented)
  • Configurable via environment variables
  • Extensible — add new metrics, sensors, alert types

🧰 Tech Stack

Layer Technology
Frontend React, Charts.js
Backend Node.js, Express
Database MongoDB Atlas
Env config dotenv / .env

📁 Repository Structure

monitor-health/
├── backend/
│ ├── controllers/
│ ├── models/
│ ├── routes/
│ ├── server.js (or app.js)
│ └── package.json
├── frontend/
│ ├── src/
│ ├── public/
│ └── package.json
├── .gitignore
└── README.md


🛠️ Installation & Setup

Follow these steps to get the project running locally. (Yes, I insist you read this.)

Prerequisites

  • Node.js (v14 or newer is safe)
  • npm or yarn
  • A running MongoDB instance (local or hosted)

Steps

  1. Clone the repo

    git clone https://github.com/shaikhhabib001/monitor-health.git
    cd monitor-health
    
  2. Install dependencies

    cd backend
    npm install
    cd ../frontend
    npm install
  3. Set environment variables

    In backend/, create a .env file. Example contents:

    MONGO_URI=your_mongodb_connection_string
    PORT=5000
    

    Adjust names and values according to how your code reads them.

  4. Run in development mode

    In one terminal:

    cd backend
    npm run dev    # or `node server.js` if dev script not present

    In another terminal:

    cd frontend
    npm start
    • Frontend usually lives at http://localhost:3000
    • Backend at http://localhost:5000 (or your chosen port)

🧭 Usage

  • Create an account / log in (if authentication is included)
  • Send metric data over API endpoints or via sensor integration
  • View dashboard: current values, historical charts
  • Receive alerts when values exceed configured thresholds

⚙️ Configuration & Customization

  • Add new environment variables to .env
  • Extend backend routes, controllers, or models
  • Tweak frontend UI, chart styles, new metrics
  • Add alert channels (email, SMS, push)

🎯 Deployment

  • Use a cloud-hosted MongoDB (Atlas, etc.)
  • Deploy backend and frontend as separate services (e.g. Heroku, Vercel + Node server)
  • Set environment variables accordingly in production
  • Use SSL / HTTPS
  • Secure your API (auth, rate limits, validation)

📝 Notes & Tips

  • Validate sensor / input data carefully
  • Rate-limit or batch data ingestion
  • Use logging & error tracking (Sentry, Winston, etc.)
  • Back up your database
  • Monitor performance as data grows

📜 License

This project is licensed under the MIT License — you’re free to use, modify, share, as long as you include attribution.


🤝 Contributing

  • Open an issue to discuss feature ideas or bugs
  • Fork the repo, make changes, submit a pull request
  • Follow code style, add documentation & tests

📬 Contact

Feel free to reach out via GitHub issues / PRs. Let’s make health data more actionable (and less opaque).

About

A full-stack smart health monitoring dashboard. Tracks vitals, visualizes trends, issues alerts, built with React (frontend), Node.js + Express (backend), and MongoDB.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors