Hospital Management System

Built as a project while learning MERN Stack from Sheryians Coding School

---

📋 Table of Contents

1. 🤖 Introduction
2. ⚙️ Tech Stack
3. 🔋 Features
4. 🚀 Getting Started
5. 🤝 Contributing
6. 👤 About Me
7. 📜 License

---

🤖 Introduction

The Hospital Management System is a web application designed to streamline hospital operations including patient registration, doctor appointments, admin management, and real-time data updates. The platform enhances communication between patients and medical staff while providing secure and scalable solutions using the MERN stack.

---

⚙️ Tech Stack

• MongoDB – NoSQL Database
• Express.js – Backend Framework
• React.js – Frontend Framework
• Node.js – Backend Runtime Environment
• Tailwind CSS – UI Styling
• JWT Auth – User Authentication
• Mongoose – MongoDB ORM

---

🔋 Features

✅ Patient Registration
✅ Doctor Login & Dashboard
✅ Appointment Scheduling
✅ Admin Panel for Managing Doctors, Patients & Appointments
✅ User Authentication with JWT
✅ CRUD Operations for All Modules
✅ Responsive UI with Tailwind CSS
✅ Search & Filter Functionalities
✅ Form Validation & Error Handling
✅ Dark Mode (Optional)
✅ Mobile-Friendly Design

---

🚀 Getting Started

To use this project on your local machine:

📦 Prerequisites

• Node.js
• npm
• MongoDB

🧑‍💻 Installation

git clone https://github.com/Zuhaib-dev/HMS.git
cd hospital-management-system
npm install

🔐 Environment Setup

Create a .env file in the root directory and add the following:

PORT=5000
MONGODB_URI=your_mongodb_uri
JWT_SECRET=your_secret_key

Replace the values with your actual environment settings.

🏃 Run the Project

npm start

Visit http://localhost:5000 or the frontend if hosted separately.

---

🤝 Contributing

If you'd like to use or contribute to this project:

1. ⭐ Star this repository
2. 📥 Clone the repo
3. 🛠️ Make your changes
4. 🔁 Submit a Pull Request

To use the code directly:

npm install
npm run dev

Feel free to fork and customize it!

---

👤 About Me

This project was developed by Zuhaib Rashid while learning the MERN Stack from Sheryians Coding School.

📧 Email: [email protected]
📞 Phone: 6006414088
📍 Location: Srinagar, Jammu and Kashmir
🔗 GitHub: github.com/Zuhaib-dev
🔗 LinkedIn: linkedin.com/in/xuhaib-rashid-661345318
🔗 X.com: x.com/xuhaib_x9

---

📜 License

This project is open-source and available under the MIT License.

---

Made with ❤️ by Zuhaib Rashid