CarePulse - Hospital Management System

Built as a project while learning Next.js & Fullstack Development 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

CarePulse is a modern healthcare patient management application that allows patients to register, book, and manage their appointments with doctors. Administrators can schedule, cancel, and verify appointments, providing a seamless experience for both patients and healthcare providers.

This application abstracts complex healthcare management into a simple, user-friendly interface using the power of Next.js for the frontend and Appwrite for the backend infrastructure.

---

⚙️ Tech Stack

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS
• UI Components: Shadcn/ui (Radix UI)
• Backend (BaaS): Appwrite (Database, Auth, Storage)
• Form Management: React Hook Form + Zod
• SMS & Notifications: Twilio

---

🔋 Features

✅ Patient Registration – Secure patient onboarding with detailed medical history. ✅ Appointment Scheduling – Easy booking system for patients. ✅ Admin Dashboard – Comprehensive view for admins to manage appointments. ✅ SMS Notifications – Real-time updates via Twilio for appointment confirmations. ✅ File Uploads – Secure storage for identification documents using Appwrite Storage. ✅ Responsive Design – Fully optimized for mobile, tablet, and desktop. ✅ Dark Mode – Modern, eye-friendly user interface.

---

🚀 Getting Started

To use this project on your local machine:

📦 Prerequisites

• Node.js (v18+)
• npm
• Appwrite Account
• Twilio Account (Optional, for SMS)

🧑‍💻 Installation

1. Clone the repository:

   git clone https://github.com/Zuhaib-dev/HMS.git
   cd HMS

2. Install dependencies:

   npm install

🔐 Environment Setup

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

# Appwrite
NEXT_PUBLIC_ENDPOINT=https://cloud.appwrite.io/v1
PROJECT_ID=your_project_id
API_KEY=your_api_key

# Database & Collections
DATABASE_ID=your_database_id
PATIENT_COLLECTION_ID=your_patient_collection_id
DOCTOR_COLLECTION_ID=your_doctor_collection_id
APPOINTMENT_COLLECTION_ID=your_appointment_collection_id

# Storage
NEXT_PUBLIC_BUCKET_ID=your_bucket_id

# Twilio (Optional)
NEXT_PUBLIC_ADMIN_PASSKEY=your_admin_passkey

Note: You will need to set up your Appwrite project (Database, Collections, Storage) to match the schema expected by the application.

🏃 Run the Project

npm run dev

Visit http://localhost:3000 to view the application.

---

🤝 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

---

👤 About Me

This project was developed by Zuhaib Rashid while learning Fullstack Development.

📧 Email: zuhaibrashid01@gmail.com 📞 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