Inspiration
Medi-Doc was inspired by the need for a simple, modern, and secure way to manage patient information, medical records, and appointments in one place. The goal was to create a healthcare-focused web application that feels practical for clinics and easy for staff to use.
What it does
Medi-Doc is a full-stack medical records management system that allows users to:
register and manage patients create and view medical records schedule and manage appointments authenticate users with role-based access view health and dashboard information from the backend use a polished React-based frontend for day-to-day operations It brings together patient management and clinic workflow into a single streamlined experience.
How I built it
The project was built as a full-stack application with:
Frontend: React with React Router, Axios, and custom CSS styling Backend: Node.js and Express Database: MongoDB with Mongoose Authentication: JWT-based authentication with protected routes Testing: Jest and Supertest for backend API coverage Deployment readiness: environment-based API configuration, production build support, and improved project structure The app is organized into separate client and server folders to keep the frontend and backend cleanly separated.
Challenges I ran into
Some of the main challenges included:
setting up secure authentication and JWT handling correctly making the app work smoothly in both development and production-style environments fixing issues with backend auth flow and environment configuration ensuring the frontend could communicate correctly with the backend API improving the UI design while keeping the app functional and maintainable
Accomplishments that I'm proud of
I’m proud that the project now:
runs successfully as a full-stack application passes its backend test suite builds successfully as a production React app has a cleaner and more modern user interface includes a more production-ready setup with better configuration and deployment friendliness
What I learned
This project helped me strengthen my understanding of:
full-stack application architecture REST API design and backend routing authentication and protected routes React frontend state and routing deployment-oriented project setup and environment management how to refine UI/UX while maintaining app stability
What's next for mediflow
The next steps for Medi-Doc include:
adding more advanced medical record workflows improving appointment management with richer scheduling features adding dashboards and analytics for clinic staff supporting file uploads for medical documents integrating notifications and reminders preparing the app for real-world deployment with a hosted backend and database If you want, I can also turn this into a polished README section or a Hackathon-style project submission format.
Log in or sign up for Devpost to join the conversation.