🏥 Clinico – Medical Appointment Booking System

Live Demo

Clinico is a full-stack medical appointment booking platform designed to simplify the scheduling process for doctors and patients. With a clean interface and secure backend, users can easily create accounts, manage profiles, and book or accept appointments, all in real time.

---

🛠️ Technologies Used

Frontend:

• ⚛️ React (TypeScript)
• 💅 Shadcn UI + Tailwind CSS
• 🔄 React Query for data fetching
• 🌐 React Router DOM

Backend:

• 🧠 ASP.NET Core Web API
• 🗃️ PostgreSQL (via Supabase)
• 🐳 Docker for containerization
• 🔐 JWT Authentication

Dev Tools:

• 📦 Vite
• 🔧 VS Code, Git, GitHub
• 🐘 PgAdmin
• 🔁 Render.com (backend deployment)
• ▲ Vercel (frontend deployment)

---

🚀 Installation Instructions

Prerequisites

• Node.js
• .NET 8 SDK
• Docker
• PostgreSQL (or Supabase account)

Clone the Repo

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

Frontend
cd clinico-frontend
yarn install
yarn dev

👩‍⚕️ Usage Example
Patient: Register → Login → Browse doctors → Book appointment → View upcoming sessions
Doctor: Login → View bookings → Accept or reject appointments → Manage profile

✨ Features and Functionality
🔐 Secure JWT-based login & role-based access (Doctor / Patient)

📅 Real-time appointment booking and approval

📝 Doctor profiles and availability

👤 Patient dashboard with history and upcoming visits

📨 Notifications for booking status

🐳 Fully Dockerized backend

📱 Responsive and accessible UI




🤝 Contributing Guidelines
Fork the repo

Create a new branch: git checkout -b feature/your-feature

Commit your changes: git commit -m 'Add new feature'

Push to the branch: git push origin feature/your-feature

Create a pull request

All contributions are welcome—whether it's UI improvement, feature addition, or bug fixes!

📄 License
MIT License © 2025 TurkiSaeed