Skip to content

About

🏥 El-Shefa Medical Clinic - Professional online doctor appointment booking system with Arabic/English support, custom branding, and senior-friendly UI. Built with React + Vite + TailwindCSS + Bun.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🏥 El-Shefa Medical Clinic - Online Booking System

El-Shefa Clinic Logo

نظام حجز مواعيد الأطباء أونلاين مع دفع إلكتروني وتوليد روابط الاجتماعات تلقائياً

Online doctor appointment booking system with electronic payment and automatic meeting links

✨ Features | المميزات

🔥 Core Features

  • 🔍 Doctor Search - Search by name or specialization | بحث بالاسم أو التخصص
  • 📅 Smart Calendar - Simple weekly view optimized for seniors | تقويم أسبوعي بسيط مناسب لكبار السن
  • 💳 Multiple Payments - Apple Pay + Credit Cards | Apple Pay + بطاقات ائتمان
  • 🔗 Auto Meeting Links - Google Meet integration | روابط اجتماعات تلقائية
  • 🌐 Bilingual Support - Arabic & English RTL/LTR | دعم العربية والإنجليزية
  • 📱 Mobile Responsive - Works on all devices | متجاوب مع جميع الأجهزة
  • 👴 Senior-Friendly - Large buttons, clear text | مناسب لكبار السن
  • 🎯 Onboarding Flow - Step-by-step guidance | تدريج واضح للمستخدم

🏥 Clinic Features

  • 🎨 Custom Branding - Logo, colors, contact info | هوية مخصصة للعيادة
  • 👨‍⚕️ Doctor Management - Add, edit, remove doctors | إدارة الأطباء
  • ⚙️ Admin Panel - Real-time configuration | لوحة تحكم شاملة
  • 📋 Config Editor - Visual configuration tool | أداة تحرير البيانات

🛠️ Tech Stack | التقنيات

  • Frontend: React 19 + Vite 7
  • Styling: TailwindCSS 4 + Custom Theme
  • Routing: React Router 7
  • Icons: Lucide React
  • Runtime: Bun (Ultra-fast)
  • Fonts: Cairo (Arabic) + Inter (English)

🚀 Quick Start | البدء السريع

# Install dependencies | تثبيت المكتبات
bun install

# Start development server | تشغيل السيرفر
bun run dev

# Open in browser | فتح في المتصفح
http://localhost:5173

📂 Project Structure | هيكل المشروع

doctor-booking-demo/
├── src/
│   ├── components/          # Reusable UI components
│   │   ├── BrandedNavbar.jsx       # Custom clinic navbar
│   │   ├── SimpleCalendar.jsx      # Senior-friendly calendar
│   │   ├── OnboardingSteps.jsx     # Progress indicator
│   │   └── DoctorCard.jsx          # Doctor profile cards
│   ├── pages/              # Application pages
│   │   ├── DoctorList.jsx          # Doctors listing + search
│   │   ├── BookingPage.jsx         # Calendar + patient info
│   │   ├── PaymentPage.jsx         # Payment processing
│   │   └── AdminPanel.jsx          # Configuration panel
│   ├── context/            # React Context for state
│   │   ├── LanguageContext.jsx     # AR/EN language switching
│   │   └── BookingContext.jsx      # Booking state management
│   ├── config/             # Customization files
│   │   ├── branding.js            # Clinic branding config
│   │   ├── doctors.js             # Doctors database
│   │   └── config-editor.html     # Visual config editor
│   ├── data/               # Data layer
│   └── App.jsx            # Main application component
└── README.md              # This file

🏥 Clinic Configuration | إعدادات العيادة

Method 1: Admin Panel | الطريقة الأولى: لوحة الإدارة

http://localhost:5173/admin

Method 2: Visual Editor | الطريقة الثانية: المحرر المرئي

# Open in browser | افتح في المتصفح
src/config/config-editor.html

Method 3: Direct File Edit | الطريقة الثالثة: تحرير مباشر

src/config/branding.js    # Clinic info, colors, contact
src/config/doctors.js     # Doctors list and availability

👨‍⚕️ Default Doctors | الأطباء الافتراضيون

Doctor Specialization Fee Experience
د. أحمد محمد السالم Cardiology | طب القلب 350 SAR 15 years
د. فاطمة الزهراني OB/GYN | نساء وولادة 300 SAR 12 years
د. خالد العتيبي Pediatrics | أطفال 250 SAR 10 years
د. نورا الغامدي Dermatology | جلدية 400 SAR 8 years

📱 User Journey | رحلة المستخدم

  1. 🏠 Home Page - Choose doctor from list | اختر طبيب من القائمة
  2. 📅 Booking - Select date & time + patient info | اختر موعد وادخل البيانات
  3. 💳 Payment - Apple Pay or Card payment | ادفع بـ Apple Pay أو البطاقة
  4. ✅ Confirmation - Get meeting link | احصل على رابط الاجتماع

🎨 Branding Customization | تخصيص الهوية

// src/config/branding.js
export const brandingConfig = {
  clinicName: {
    ar: "عيادة الشفاء الطبية",
    en: "El-Shefa Medical Clinic"
  },
  logo: "https://your-logo-url.com",
  colors: {
    primary: "#2E7D32" // Green theme
  },
  contact: {
    phone: "920000800",
    whatsapp: "+966501234567"
  }
};

🔧 Development Commands | أوامر التطوير

# Development | تطوير
bun run dev

# Build for production | بناء للإنتاج
bun run build

# Preview production build | معاينة البناء
bun run preview

# Lint code | فحص الكود
bun run lint

# Install new package | تثبيت مكتبة جديدة
bun add <package-name>

🌍 Internationalization | الترجمة

The app supports Arabic and English with:

  • RTL/LTR text direction | اتجاه النص
  • Localized date formats | تنسيقات التاريخ المحلية
  • Cultural color preferences | تفضيلات الألوان الثقافية
  • Arabic numerals support | دعم الأرقام العربية

🔐 Security Features | الأمان

  • 🔒 Secure Payments - Encrypted transaction processing
  • 🛡️ Data Privacy - Local storage for demo, secure backend ready
  • 🔑 Admin Protection - Admin panel access control
  • 📱 HTTPS Ready - SSL certificate support

🚀 Deployment Options | خيارات النشر

Vercel (Recommended)

bun add -g vercel
vercel --prod

Netlify

bun run build
# Drag & drop dist/ folder to Netlify

Traditional Hosting

bun run build
# Upload dist/ folder to your server

📋 TODO | المهام المطلوبة

Phase 1: Demo Enhancement

  • Add more payment methods (mada, STC Pay)
  • Implement real-time availability checking
  • Add appointment reminders (SMS/Email)
  • Enhance mobile experience

Phase 2: Production Ready

  • Backend integration (.NET/Node.js)
  • Database setup (PostgreSQL/MongoDB)
  • Real payment gateway (Stripe/PayPal)
  • Google Calendar API integration
  • User authentication system

Phase 3: Advanced Features

  • Doctor dashboard
  • Patient history
  • Video consultation
  • Analytics dashboard
  • Multi-clinic support

🤝 Contributing | المساهمة

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📞 Support | الدعم الفني

📄 License | الترخيص

This project is licensed under the MIT License - see the LICENSE.md file for details.


Built with ❤️ for El-Shefa Medical Clinic

🚀 Powered by Bun + React + TailwindCSS

Made in Saudi Arabia 🇸🇦

About

🏥 El-Shefa Medical Clinic - Professional online doctor appointment booking system with Arabic/English support, custom branding, and senior-friendly UI. Built with React + Vite + TailwindCSS + Bun.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages