🏥 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.

---

🚀 Key Features

• 🔐 Secure Auth: Multi-role Firebase Authentication (Admin, Doctor, Patient).
• 🗄️ Real-time Database: Cloud Firestore for zero-latency health parameter updates.
• 📈 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.

---

🛠 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/                     # Firebase Config, Custom Hooks & Alert System
│   ├── alertSystem.js       # Core alert monitoring & generation
│   ├── thresholdDefaults.js # Medical threshold configurations
│   └── useAlertMonitor.js   # Real-time monitoring hooks
├── pages/                   # Next.js Routing & API Logic
│   ├── admin/               # Admin dashboard & threshold management
│   ├── doctor/              # Doctor dashboard with alerts
│   └── patient/             # Patient dashboard
├── 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

---

🖼️ Website Preview

Click to view Screenshots

Homepage

Monitoring

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.

---

💬 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