Live Preview: https://x-clinic.sh-resource.cloud/

X-Clinic is a modern, enterprise-grade Patient Management System designed to streamline healthcare operations for clinics and hospitals. Built with the latest technologies—Next.js 16 (React 19), Django 5, and PostgreSQL—it offers a robust, secure, and scalable solution for managing appointments, patients, and staff.

Whether you run a small private clinic or a busy hospital department, X-Clinic provides everything you need: role-based dashboards, automated SMS/Email reminders, detailed analytics, and a beautiful, mobile-responsive interface.

Why Choose X-Clinic?

• 🚀 Modern Tech Stack: Built with Next.js 16, TypeScript, Tailwind CSS, and Python Django.
• 🔐 Role-Based Access: distinct portals for Administrators, Doctors, and Patients.
• 📅 Smart Scheduling: Conflict-free appointment booking with day, week, and month views.
• 🔔 Automated Notifications: Reduce no-shows with email (SendGrid) and SMS (Twilio) reminders.
• 📊 Powerful Analytics: Visual statistics for appointments, patient demographics, and staff performance.
• 🌍 Global Ready: Multi-timezone support and GDPR compliance features.
• 🐳 Docker Ready: Production-ready Docker Compose setup included for easy deployment.

Perfect For: Private Clinics, Dental Practices, Medical Centers, and Healthcare Startups looking for a premium, white-label solution.

Core Features

• 3 User Roles: Super Admin, Doctor, and Patient dashboards.
• Appointment Management: Create, reschedule, cancel, and track appointment status (Pending, Confirmed, Completed, Cancelled).
• Timezone Support: Auto-detects and adjusts times for international patients and staff.
• Medical Notes: Private notes for doctors and shared comments on appointments.
• User Management: comprehensive profiles, history tracking, and soft-delete/restore functionality.

Frontend & UI (Next.js)

• Beautiful Design: Crafted with Shadcn UI and Tailwind CSS.
• Responsive: Fully optimized for desktops, tablets, and mobile phones.
• Dark Mode: Sleep-friendly dark mode support.
• Dashboard Analytics: Chart.js integration for visual data reporting.
• Export Data: Download reports and appointment lists to Excel/CSV.

Backend & Security (Django)

• Secure API: JWT Authentication and HTTP-only cookies.
• Rate Limiting: Protection against brute-force attacks.
• Data Encryption: Sensitive patient data encrypted at rest.
• Background Tasks: Celery & Redis for handling emails and notifications asynchronously.

Integrations

• SendGrid: Transactional emails and reminders.
• Twilio: SMS notifications and verification.
• Google Maps: Clinic location integration.

To run X-Clinic efficiently, we recommend the following server environment:

Recommended Setup (Docker)

• VPS: 4GB RAM minimum (8GB+ recommended for production)
• OS: Ubuntu 20.04/22.04/24.04 LTS
• Docker: Engine 24.0+
• Docker Compose: v2.0+

Manual Installation Requirements

• Backend: Python 3.12+, PostgreSQL 14+, Redis 6+
• Frontend: Node.js 18+ (Node 20/22/24 recommended), NPM or PNPM

Third-Party Services (Optional but Recommended)

• SendGrid Account: For email notifications.
• Twilio Account: For SMS notifications.
• Google Maps API Key: For location features.

X-Clinic comes with a comprehensive Production Deployment Guide tailored for Dokploy (a free, self-hosted PaaS) on a VPS, making deployment incredibly easy.

Quick Start (Docker Compose)

1. Upload the source code to your VPS.
2. Rename .env.example to .env and configure your database and API keys.
3. Run the application:

   <code>docker-compose -f docker-compose-prod.yml up -d --build</code>
   
   
   
   
   

4. Access the Admin panel to create your first Superuser.

Included Documentation

• PRODUCTION_DEPLOYMENT_GUIDE.md: Step-by-step VPS setup, SSL configuration, domain connection and local development setup instructions.
• README.md: In depth details about X-Clinic(Patient Management System). It can be used for Project showcase and Project marketing purpose.

Support: We provide free installation support if you encounter any issues with the initial setup!