• 🌟 Why Prescripto?
• ✨ Features
• 📸 Screenshots
• 🛠 Tech Stack
• 📁 Project Structure
• ⚙️ Installation & Setup
• 🔐 Environment Variables
• 🔌 API Reference
• 🔮 Future Roadmap
• 🙏 Acknowledgements
• 🤝 Contributing
• 👨‍💻 Author
• 📄 License

Most clinics and hospitals still rely on manual appointment books, phone calls, and paper prescriptions. Prescripto replaces all of that with a seamless digital platform — reducing no-shows, eliminating paperwork, and giving every stakeholder (patient, doctor, admin) their own intelligent portal.

• Account Management — Register, login, update profile with photo
• Unique Patient ID — Auto-generated immutable ID for every patient
• Doctor Discovery — Browse doctors by 6 specialities with availability status
• Slot-Based Booking — Real-time 30-minute slot availability (10 AM – 9 PM)
• Appointment Management — View and cancel appointments
• Digital Prescriptions — View complete prescriptions issued by doctors
• Secure Password Reset — 3-step OTP flow via email (2-minute expiry + resend)
• Responsive Design — Works perfectly on mobile, tablet, and desktop

• Personalized Dashboard — Earnings, appointment count, patient count at a glance
• Appointment Management — View all appointments, complete or cancel them
• Prescription Writing — Detailed digital prescription with:
  • Diagnosis & Symptoms
  • Medicines & Instructions
  • Lab Tests & Documentation
  • Next Visit date
• Prescription Editing — Edit issued prescriptions with full edit history tracking
• Patient History — View complete history of all treated patients
• Profile Management — Update fees, address, and availability status

• Platform Dashboard — Total doctors, appointments, and patients overview
• Doctor Management — Add, edit, or toggle availability of doctors
• Image Upload — Doctor profile photos via Cloudinary
• Appointment Oversight — View and cancel any appointment on the platform
• Appointment History — View completed appointments, delete records
• Dual Login — Admin and Doctor login from the same panel

Prescripto/
│
├── 📦 frontend/ # Patient-facing app (Port: 5173)
│ └── src/
│ ├── assets/ # Images, SVGs, speciality data
│ ├── components/
│ │ ├── Navbar.jsx # Sticky responsive navbar
│ │ ├── Footer.jsx # Footer with contact info
│ │ ├── Header.jsx # Hero section
│ │ ├── Banner.jsx # CTA banner
│ │ ├── TopDoctors.jsx # Featured doctors grid
│ │ ├── RelatedDoctors.jsx # Same-speciality suggestions
│ │ ├── SpecialityMenu.jsx # Scrollable speciality filter
│ │ └── CountdownTimer.jsx # OTP resend countdown
│ ├── context/
│ │ └── AppContext.jsx # Global state + all API calls
│ └── pages/
│ ├── Home.jsx
│ ├── Doctors.jsx # Browse & filter doctors
│ ├── Appointment.jsx # Book appointment page
│ ├── Login.jsx # Sign up / Login
│ ├── MyProfile.jsx # Patient profile editor
│ ├── About.jsx
│ ├── Contact.jsx
│ ├── EmailVerify.jsx # Password reset: Step 1
│ ├── OtpVerify.jsx # Password reset: Step 2
│ └── ResetPassword.jsx # Password reset: Step 3
│
├── 📦 admin/ # Admin + Doctor panel (Port: 5174)
│ └── src/
│ ├── components/
│ │ ├── Navbar.jsx
│ │ └── Sidebar.jsx # Role-based sidebar (Admin/Doctor)
│ ├── context/
│ │ ├── AdminContext.jsx # Admin state + API calls
│ │ ├── DoctorContext.jsx # Doctor state + API calls
│ │ └── AppContext.jsx # Shared utilities
│ └── pages/
│ ├── Login.jsx # Shared login for Admin & Doctor
│ ├── Admin/
│ │ ├── Dashboard.jsx # Stats + latest bookings
│ │ ├── AppointmentHistory.jsx
│ │ ├── AddDoctor.jsx
│ │ └── DoctorsList.jsx
│ └── Doctor/
│ ├── DoctorDashboard.jsx
│ ├── DoctorAppointments.jsx
│ ├── DoctorProfile.jsx
│ └── PatientHistory.jsx
│
└── 📦 backend/ # Express REST API (Port: 4000)
 ├── config/
 │ ├── mongodb.js # Mongoose connection
 │ ├── cloudinary.js # Cloudinary SDK config
 │ ├── nodemailer.js # Gmail transporter
 │ └── EmailTemplates.js # HTML OTP email template
 ├── middlewares/
 │ ├── authUser.js # Verify user JWT
 │ ├── authDoctor.js # Verify doctor JWT (dToken)
 │ ├── authAdmin.js # Verify admin JWT (aToken)
 │ └── multer.js # Disk storage for uploads
 ├── models/
 │ ├── userModel.js # Patient schema (patientId, OTP, etc.)
 │ ├── doctorModel.js # Doctor schema (slots_booked, etc.)
 │ ├── appointmentModel.js # Appointment schema
 │ ├── prescriptionModel.js # Prescription + edit history schema
 │ └── counterModel.js # Auto-increment for Patient IDs
 ├── controllers/ # Route handlers / business logic
 ├── routes/
 │ ├── userRoute.js
 │ ├── doctorRoute.js
 │ └── adminRoute.js
 └── server.js # App entry point

• Node.js >= 18.x
• MongoDB Atlas account
• Cloudinary account
• Gmail account (with App Password enabled)

git clone https://github.com/ARQUM21/Prescripto.git
cd Prescripto

cd backend
npm install

Create .env in backend/ directory — see the Environment Variables section below.

npm run server # Development with auto-restart
# OR
npm start # Production

✅ API running at: http://localhost:4000

cd ../frontend
npm install

Create .env in frontend/:

VITE_BACKEND_URL=http://localhost:4000

npm run dev

✅ Patient portal at: http://localhost:5173

cd ../admin
npm install

Create .env in admin/:

VITE_BACKEND_URL=http://localhost:4000

npm run dev

✅ Admin panel at: http://localhost:5174

Create a .env file inside the backend/ folder:

# ─── Server ───────────────────────────────────────────────
PORT=4000
# ─── Database ─────────────────────────────────────────────
MONGODB_URI=mongodb+srv://<username>:<password>@cluster.mongodb.net
# ─── Authentication ───────────────────────────────────────
JWT_SECRET=your_strong_random_jwt_secret_key
# ─── Admin Credentials ────────────────────────────────────
ADMIN_EMAIL=admin@yourclinicdomain.com
ADMIN_PASSWORD=your_secure_admin_password
# ─── Cloudinary (Image Storage) ───────────────────────────
CLOUDINARY_NAME=your_cloudinary_cloud_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_SECRET_KEY=your_cloudinary_api_secret
# ─── Email / OTP (Gmail) ──────────────────────────────────
SENDER_EMAIL=your_gmail@gmail.com
APP_PASSWORD=your_16_digit_gmail_app_password

Gmail App Password Setup: Google Account → Security → 2-Step Verification → App Passwords → Generate for "Mail"

Base URL: https://your-backend.vercel.app

Prescripto is architected with scalability in mind. Here is the planned evolution for clinics and hospitals who want enterprise-grade capabilities:

• Online Payments — Stripe / JazzCash / Easypaisa for appointment fees
• SMS Notifications — Appointment reminders via Twilio SMS
• Email Confirmations — Auto booking confirmation emails
• Doctor Search & Filters — Search by name, fee range, rating, experience
• Ratings & Reviews — Patients can rate and review doctors

• Multi-Branch Support — One admin managing multiple clinic locations
• Department Management — Organize doctors by hospital departments
• Bed / Room Management — Track inpatient availability
• Lab Test Module — Order tests, upload results, share with patients
• Medical Records Vault — Upload X-rays, MRIs, and reports securely
• Pharmacy Integration — Send prescriptions directly to hospital pharmacy

• Advanced Analytics Dashboard — Revenue, peak hours, doctor performance
• Patient Demographics — Age, gender, location-based insights
• No-Show Prediction — ML model to reduce appointment no-shows
• AI Symptom Checker — Pre-appointment chatbot assessment
• Smart Doctor Recommendations — Suggest best doctor based on symptoms

• React Native Mobile App — iOS & Android for patients
• Doctor Mobile App — Manage appointments on the go
• Video Consultation — WebRTC-based telemedicine
• Real-time Chat — In-app messaging between patient and doctor
• Multi-language Support — Urdu, Arabic, and regional languages

• Audit Logs — Full activity logs for regulatory compliance
• Data Export — Patient data as PDF / Excel reports
• HIPAA / HL7 FHIR Compliance — International healthcare standards

This project was built with the help of some amazing open-source tools, services, and communities:

• React — The UI library that powers all three portals
• Vite — Blazing fast frontend build tool
• Tailwind CSS — Utility-first CSS framework for rapid UI development
• Express.js — Minimal and flexible Node.js web framework
• MongoDB Atlas — Cloud-hosted NoSQL database
• Mongoose — Elegant MongoDB object modeling for Node.js
• Cloudinary — Cloud image storage and delivery
• Nodemailer — Node.js module for sending emails
• JWT — Secure stateless authentication standard
• Lucide React — Beautiful & consistent icon library
• Vercel — Seamless deployment platform for frontend & backend
• Shields.io — Beautiful README badges
• The entire open-source community whose tools made this project possible 🌍

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

This project is licensed under the MIT License — free to use, modify, and distribute.