A full-stack healthcare platform connecting patients with doctors — seamlessly.
Prescripto is a production-ready, full-stack doctor appointment booking web application. It offers three separate interfaces — a patient portal, a doctor dashboard, and an admin control panel — all powered by a single RESTful backend API.
Patients can discover doctors by speciality, pick available time slots, and complete payments securely via Stripe. Doctors manage their schedules and earnings. Admins control the entire platform from one place.
|
|
|
| Category | Technology |
|---|---|
| Frontend | React.js 18, Vite, Tailwind CSS, Context API, React Router DOM v6 |
| Backend | Node.js, Express.js |
| Database | MongoDB Atlas, Mongoose ODM |
| Auth | JSON Web Tokens (JWT), bcrypt password hashing |
| Payments | Stripe Checkout Sessions |
| File Storage | Cloudinary, Multer |
| Deployment | Vercel (Frontend + Admin), Render (Backend) |
Prescripto/
│
├── 📁 frontend/ # Patient-facing React app (Port 5173)
│ ├── src/
│ │ ├── assets/ # Images, icons, SVGs
│ │ ├── components/ # Navbar, Footer, DoctorCard, etc.
│ │ ├── context/
│ │ │ └── AppContext.jsx # Global state — doctors, user, token
│ │ └── pages/
│ │ ├── Home/ # Landing page
│ │ ├── Doctors/ # Browse by speciality
│ │ ├── Appointment/ # Book appointment
│ │ ├── MyAppointments/ # Patient's bookings
│ │ ├── MyProfile/ # Profile management
│ │ ├── About/
│ │ ├── Contact/
│ │ └── Verify/ # Payment verification
│ ├── vercel.json
│ └── .env
│
├── 📁 admin/ # Admin + Doctor panel (Port 5174)
│ ├── src/
│ │ ├── context/
│ │ │ ├── AdminContext.jsx # Admin state & API calls
│ │ │ └── DoctorContext.jsx # Doctor state & API calls
│ │ └── pages/
│ │ ├── Admin/
│ │ │ ├── Dashboard.jsx
│ │ │ ├── AllAppointments.jsx
│ │ │ ├── AddDoctor.jsx
│ │ │ └── DoctorsList.jsx
│ │ └── Doctor/
│ │ ├── DoctorDashboard.jsx
│ │ ├── DoctorAppointments.jsx
│ │ └── DoctorProfile.jsx
│ ├── vercel.json
│ └── .env
│
├── 📁 backend/ # Express REST API (Port 4000)
│ ├── config/
│ │ ├── mongodb.js # MongoDB Atlas connection
│ │ └── cloudinary.js # Cloudinary setup
│ ├── controllers/
│ │ ├── adminController.js
│ │ ├── doctorController.js
│ │ └── userController.js
│ ├── middlewares/
│ │ ├── authAdmin.js
│ │ ├── authDoctor.js
│ │ └── authUser.js
│ ├── models/
│ │ ├── userModel.js
│ │ ├── doctorModel.js
│ │ └── appointmentModel.js
│ ├── routes/
│ │ ├── adminRoute.js
│ │ ├── doctorRoute.js
│ │ └── userRoute.js
│ ├── server.js
│ └── .env
│
└── .gitignore
Before you begin, make sure you have:
- ✅ Node.js v18 or higher
- ✅ A MongoDB Atlas free cluster
- ✅ A Stripe account (test mode keys)
- ✅ A Cloudinary free account
git clone https://github.com/Sahil-Mansuri-15/Prescripto.git
cd Prescriptocd backend
npm installCreate backend/.env:
MONGODB_URI=mongodb+srv://<username>:<password>@cluster.mongodb.net/prescripto
JWT_SECRET=your_super_secret_jwt_key
# Admin Credentials
ADMIN_EMAIL=[email protected]
ADMIN_PASSWORD=your_admin_password
# Cloudinary
CLOUDINARY_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_SECRET_KEY=your_api_secret
# Stripe
STRIPE_SECRET_KEY=sk_test_your_key
# Currency
CURRENCY=INRnpm run server # Starts on http://localhost:4000cd frontend
npm installCreate frontend/.env:
VITE_BACKEND_URL=http://localhost:4000npm run dev # Starts on http://localhost:5173cd admin
npm installCreate admin/.env:
VITE_BACKEND_URL=http://localhost:4000npm run dev # Starts on http://localhost:5174👤 User Routes — /api/user
| Method | Endpoint | Auth | Description |
|---|---|---|---|
POST |
/register |
❌ | Register new patient |
POST |
/login |
❌ | Login patient |
GET |
/get-profile |
✅ | Get user profile |
POST |
/update-profile |
✅ | Update name, photo, dob, etc. |
POST |
/book-appointment |
✅ | Book a time slot |
GET |
/appointments |
✅ | Get all appointments |
POST |
/cancel-appointment |
✅ | Cancel an appointment |
POST |
/payment-stripe |
✅ | Initiate Stripe payment |
POST |
/verify-stripe |
✅ | Verify payment status |
🩺 Doctor Routes — /api/doctor
| Method | Endpoint | Auth | Description |
|---|---|---|---|
POST |
/login |
❌ | Doctor login |
GET |
/list |
❌ | Get all doctors (public) |
POST |
/appointments |
✅ | Get doctor's appointments |
POST |
/complete-appointment |
✅ | Mark as completed |
POST |
/cancel-appointment |
✅ | Cancel appointment |
GET |
/dashboard |
✅ | Earnings & stats |
GET |
/profile |
✅ | Get profile data |
POST |
/update-profile |
✅ | Update fees, availability |
⚙️ Admin Routes — /api/admin
| Method | Endpoint | Auth | Description |
|---|---|---|---|
POST |
/login |
❌ | Admin login |
POST |
/add-doctor |
✅ | Add doctor with image |
GET |
/all-doctors |
✅ | List all doctors |
POST |
/change-availability |
✅ | Toggle doctor availability |
GET |
/appointments |
✅ | All platform appointments |
POST |
/cancel-appointment |
✅ | Cancel any appointment |
GET |
/dashboard |
✅ | Platform-wide stats |
Use Stripe's test card to simulate payments:
Card Number → 4242 4242 4242 4242
Expiry → Any future date (e.g. 12/27)
CVV → Any 3 digits (e.g. 123)
ZIP → Any 5 digits (e.g. 12345)
| Service | Platform | Config |
|---|---|---|
| Patient Frontend | Vercel | Root: frontend, add VITE_BACKEND_URL |
| Admin Panel | Vercel | Root: admin, add VITE_BACKEND_URL |
| REST API | Render | Root: backend, Start: node server.js |
| Database | MongoDB Atlas | Free M0 cluster |
| Image CDN | Cloudinary | Free tier (25 GB) |
💡 Tip: Add your Render backend URL to UptimeRobot (free) to prevent cold starts on Render's free tier.
Contributions are always welcome!
# 1. Fork the project
# 2. Create your feature branch
git checkout -b feature/YourFeature
# 3. Commit your changes
git commit -m "feat: add YourFeature"
# 4. Push and open a Pull Request
git push origin feature/YourFeatureBuilt with passion by Sahil Mansuri
If this project helped you, consider giving it a ⭐