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.
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.
- 🔐 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.
| 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 |
To connect physical sensors to the HEALCONNECT dashboard, you must flash the kit with the provided firmware:
- Software: Install the latest Arduino IDE.
- Open Project: Open
HealthConnect_Kit_Arduino_Code/HealthConnect_Kit_Arduino_Code.ino. - Configuration:
- Update
Network.hwith your WiFi credentials. - Ensure the Firebase Secret/URL matches your project settings.
- Update
- Library Installation: Use the Library Manager to install
Firebase ESP32 ClientandArduinoJson. - Upload: Connect your hardware via USB, select the correct COM port, and click Upload.
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
- Node.js (version 14 or higher)
- Firebase project (setup on Firebase Console)
git clone [https://github.com/Dipanita45/HEALCONNECT](https://github.com/Dipanita45/HEALCONNECT)
cd HEALCONNECTnpm installnpm run devAlthough this project uses a unified Next.js structure, backend services (API routes, database connections, and authentication) require proper environment configuration.
- Node.js (v16+)
- npm or yarn
- Database (MongoDB / PostgreSQL as applicable)
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
npm installnpm run dev- API routes are located inside the
pages/apidirectory - Ensure database connection variables are correctly set
For detailed information about the real-time alert system, see ALERT_SYSTEM_GUIDE.md
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
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.
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.