🏥 HEALCONNECT

Smart Remote Health Monitoring & Hospital Management System

Live Demo | Report Bug | Request Feature | Join Discord

---

🩺 About

HEALCONNECT is a professional-grade health monitoring system designed for real-time remote patient care. By bridging the gap between physical sensors and cloud-based dashboards, it allows medical professionals to monitor vital parameters (ECG, Heart Rate, etc.) and manage appointments seamlessly from any location.

---

🌟 Open Source Participation

This project proudly participates in the following open-source programs:

Program	Program Name	Status
❄️	Social Winter of Code (SWOC)	Active
🌍	Open Source Community Group (OSCG)	Active
🚀	Apertre 3.0	Active

💡 We warmly welcome contributors from all the above programs.
Please check open issues and follow the contribution guidelines before submitting a PR.

🚀 Key Features

• 🔐 Secure Auth: Multi-role Firebase Authentication (Admin, Doctor, Patient).
• 🗄️ Real-time Database: Cloud Firestore for zero-latency health parameter updates.
• 🔌 RESTful API: Complete API infrastructure for all entities (patients, vitals, alerts, devices).
• 📊 Service Layer: Business logic abstraction with comprehensive error handling.
• 📈 Live Monitoring: Interactive ECG and health charts using real-time data streams.
• 🚨 Emergency Alerts: Automated real-time alerts when patient vitals exceed safe thresholds.
• 📅 Hospital Management: Integrated appointment booking and prescription systems.
• 🌓 UX Focused: Fully responsive design with Dark Mode support.
• ⚡ Real-time Sync: Live data updates using Firestore subscriptions.

---

🛠 Tech Stack

Layer	Technology
Frontend	React.js (Vite), Next.js
Styling	SCSS / Tailwind CSS
Backend Services	Firebase Auth & Cloud Firestore
Hardware	Arduino (C++) / ESP32
Form Handling	React Hook Form

---

🔌 Hardware Setup & Flashing

To connect physical sensors to the HEALCONNECT dashboard, you must flash the kit with the provided firmware:

1. Software: Install the latest Arduino IDE.
2. Open Project: Open HealthConnect_Kit_Arduino_Code/HealthConnect_Kit_Arduino_Code.ino.
3. Configuration:
   • Update Network.h with your WiFi credentials.
   • Ensure the Firebase Secret/URL matches your project settings.
4. Library Installation: Use the Library Manager to install Firebase ESP32 Client and ArduinoJson.
5. Upload: Connect your hardware via USB, select the correct COM port, and click Upload.

---

📂 Project Structure

HEALCONNECT/
├── .github/workflows/       # Automated CI/CD (GitHub Actions)
├── HealthConnect_Kit_Arduino_Code/ # Hardware Firmware (Arduino/C++)
├── components/              # Reusable UI Components
│   ├── Auth/                # Login & Auth State Logic
│   ├── DoctorComponents/    # Doctor-specific views & Alert System
│   ├── LiveMonitor/         # ECG & Real-time Chart Logic
│   └── PatientComponents/   # Patient-specific views
├── lib/                     # Core Libraries & Services
│   ├── api/                 # API client & middleware
│   ├── db/                  # Database operations & schema
│   ├── services/            # Business logic layer
│   ├── hooks/               # Custom React hooks
│   ├── alertSystem.js       # Core alert monitoring & generation
│   ├── thresholdDefaults.js # Medical threshold configurations
│   └── useAlertMonitor.js   # Real-time monitoring hooks
├── pages/                   # Next.js Routing & API Logic
│   ├── api/                 # RESTful API endpoints
│   │   ├── patients/        # Patient CRUD operations
│   │   ├── vitals/          # Vitals recording & retrieval
│   │   ├── alerts/          # Alert management
│   │   └── devices/         # Device registration & status
│   ├── admin/               # Admin dashboard & threshold management
│   ├── doctor/              # Doctor dashboard with alerts
│   └── patient/             # Patient dashboard
├── docs/                    # Comprehensive Documentation
│   ├── API_DOCUMENTATION.md # Complete API reference
│   ├── DATABASE_SCHEMA.md   # Database structure
│   ├── SETUP_GUIDE.md       # Installation & setup
│   ├── USAGE_EXAMPLES.md    # Code examples
│   └── QUICK_REFERENCE.md   # Quick reference guide
├── public/                  # Static Assets & Images
└── styles/                  # Global SCSS & Tailwind Styles

---

⚙️ Getting Started

✅ Prerequisites

• Node.js (version 14 or higher)
• Firebase project (setup on Firebase Console)

🔧 Installation Steps

Clone the repository

git clone [https://github.com/Dipanita45/HEALCONNECT](https://github.com/Dipanita45/HEALCONNECT)
cd HEALCONNECT

Install dependencies

npm install

Start development server

npm run dev

Backend Setup & Configuration

Although this project uses a unified Next.js structure, backend services (API routes, database connections, and authentication) require proper environment configuration.

Prerequisites

• Node.js (v16+)
• npm or yarn
• Database (MongoDB / PostgreSQL as applicable)

🔐 Environment Configuration

Create a .env file in the root directory and copy the values from .env.example. Focus strictly on Firebase credentials as this project uses Firestore for all database needs.

NEXT_PUBLIC_FIREBASE_API_KEY=your_key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_domain
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_id
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_bucket
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
NEXT_PUBLIC_FIREBASE_APP_ID=your_app_id

Install Dependencies

npm install

Run the Application

npm run dev

Backend/API

• API routes are located inside the pages/api directory
• Ensure database connection variables are correctly set

🚨 Emergency Alert System

For detailed information about the real-time alert system, see ALERT_SYSTEM_GUIDE.md

📚 Database & API Documentation

For comprehensive information about the database and API infrastructure:

• Database & API Overview - Complete implementation guide
• API Documentation - RESTful API endpoints reference
• Database Schema - Firestore collections structure
• Setup Guide - Step-by-step installation
• Usage Examples - Code examples and patterns
• Quick Reference - Cheat sheet for common operations

---

🖼️ Website Preview

Click to view Screenshots

Homepage

Team member (Doctor)

Dark Mode

Appointments

---

🤝 Contributing

Contributions are what make the open-source community an amazing place to learn and inspire. We welcome contributions from everyone! Please read our Contributing Guidelines to get started.

---### 🪜 Steps to Contribute

1. Fork this repository Click the Fork button on the top right corner of this page.

2. Clone your forked repo

   git clone https://github.com/<your-username>/HEALCONNECT.git

3. Create a new branch

   git checkout -b feature/your-feature-name

4. Make your changes Add your improvements or fix bugs.

5. Commit your changes

   git add .
   git commit -m "Added: new feature or improvement"

6. Push to your branch

   git push origin feature/your-feature-name

7. Create a Pull Request Go to your fork on GitHub and click “Compare & pull request”. 🎉 That’s it! Wait for review and merge.

📘 For more details, see the CONTRIBUTING.md file.

🏆 NSoC 2026 Project Selection

We are excited to announce that this project has been officially selected for Nexus Spring of Code 2026 (NSoC '26).

As a Project Kernel, this project will be actively maintained and scaled during the program with support from contributors and the open-source community.

💬 Connect With Us

Join our growing community! Connect with us on Discord for:

• 🗣️ Real-time discussions and support
• 🚀 Project updates and announcements
• 💡 Feature suggestions and feedback
• 🤝 Collaboration opportunities

---

Made with ❤️ by the HEALCONNECT Team Empowering healthcare, one heartbeat at a time.

⬆️ Back to Top