DocEase is a full-stack doctor appointment platform built with Next.js.
It allows doctors and patients to register, book appointments, manage schedules, and more.
- Role-based login (Doctor / Patient / Admin)
- Appointment booking & management
- Google OAuth login
- Cloudinary image uploads
- Email notifications
- Frontend & Backend: Next.js (API routes in
pages/api) - Database: MongoDB
- Auth: NextAuth.js
- Image Hosting: Cloudinary
- Email: Resend API / Gmail
git clone https://github.com/Crystlfly/docease.git cd docease
npm install
Create a file named .env.local in the root folder and copy the format from .env.example:
MongoDB connection string (Local or Atlas)
MONGODB_URI=your_mongodb_connection_string
Google OAuth Credentials
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
NextAuth configuration
NEXTAUTH_SECRET=your_nextauth_secret
NEXTAUTH_URL=http://localhost:3000
Cloudinary configuration
CLOUDINARY_CLOUD_NAME=your_cloudinary_cloud_name
CLOUDINARY_API_KEY=your_cloudinary_api_key
CLOUDINARY_API_SECRET=your_cloudinary_api_secret
JWT configuration
JWT_SECRET=your_jwt_secret
Admin credentials
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=Admin
Email service credentials
EMAIL_USER=youremail@example.com
EMAIL_PASS=your_email_password
Resend API Key
RESEND_API_KEY=your_resend_api_key
Google OAuth Refresh Token for email sending (if applicable)
REFRESH_TOKEN=your_google_refresh_token
Make sure MongoDB is running:
mongod Or use MongoDB Atlas and replace MONGODB_URI with your connection string.
npm run dev Open http://localhost:3000 in your browser.