Skip to content

ConsultX is a full-stack doctor appointment platform built with Next.js and Clerk, featuring a credit-based booking system, secure authentication, subscription plans, PayPal payouts, and an admin dashboard for management.

Notifications You must be signed in to change notification settings

AmjustGettingStarted/Apothecary

Repository files navigation

🩺 ConsultX – Doctors Appointment Platform

A modern, full-stack platform for booking, managing, and monetizing doctor appointments. Built with Next.js, Clerk authentication, and a robust credit-based system for patients and doctors


🚀 Features

  • User Roles: Patient, Doctor, Admin, Unassigned (Onboarding)
  • Authentication: Secure sign-in/sign-up with Clerk
  • Credit System: Patients purchase credits to book appointments; doctors earn credits for completed appointments
  • Subscription Plans: Free, Standard, Premium (powered by Clerk Billing)
  • Payouts: Doctors can request payouts via PayPal
  • Admin Dashboard: Manage users, credits, and payouts
  • Responsive UI: Stylish, mobile-friendly design with modern UI components
  • Notifications: Real-time feedback for actions and errors

🛠️ Tech Stack

  • Frontend: Next.js , Tailwind CSS , ShadcnUI
  • Backend: Next.js API routes, Prisma ORM
  • Auth & Billing: Clerk
  • Database: PostgreSQL (or your preferred DB)
  • Payments: Clerk Commerce, PayPal (for doctor payouts)
  • Icons & UI: Lucide, Shadcn/UI

📦 Getting Started

1. Clone the Repository

git clone https://github.com/your-username/Apothecary.git
cd Apothecary

2. Install Dependencies

npm install
# or
yarn install

3. Configure Environment Variables

Copy .env.example to .env.local and fill in your Clerk, database, and PayPal credentials.

cp .env.example .env.local

4. Set Up the Database

npx prisma migrate dev

5. Run the Development Server

npm run dev
# or
yarn dev

Visit http://localhost:3000 to view the app.


🧑‍💻 Project Structure

/components      # Reusable React components (UI, Header, Pricing, etc.)
/actions         # Server actions for credits, payouts, etc.
/pages or /app   # Next.js pages or app router
/prisma          # Prisma schema and migrations
/public          # Static assets (logo, images)
/styles          # Tailwind and global styles

✨ Screenshots

Home Page Price Plans Page Doctors List


📝 Customization

  • Plans & Pricing: Edit plans in Clerk dashboard and update PLAN_CREDITS in /actions/credits.js
  • UI Theme: Customize Tailwind config and component styles
  • Payout Logic: Adjust payout calculations in /actions/payout.js

📬 Contact

Questions? Suggestions?
Open an issue or reach out at gamerhmv2050@gmail.com.


About

ConsultX is a full-stack doctor appointment platform built with Next.js and Clerk, featuring a credit-based booking system, secure authentication, subscription plans, PayPal payouts, and an admin dashboard for management.

Topics

Resources

Stars

Watchers

Forks

Contributors 2

  •  
  •