/DocDirect

Primary LanguageJavaScript

DocDirect

DocDirect is a comprehensive hospital management system built using the MERN stack (MongoDB, Express.js, React, and Node.js). The platform provides an efficient way to manage patient information, appointments, and administrative tasks, enhancing the overall patient and admin experience.

Table of Contents

Features

  • Patient Management: Easily manage patient records, including personal information, medical history, and appointments.
  • Appointment Scheduling: Schedule, reschedule, and cancel appointments with ease.
  • Admin Dashboard: A comprehensive dashboard for administrators to manage doctors, patients, and appointments.
  • User Authentication: Secure login and registration for patients and admins.
  • Responsive Design: A user-friendly interface that works on all devices.

Installation

To run DocDirect locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/Gibrail404/DocDirect.git
cd DocDirect

  2. Install backend dependencies:

    cd backend
npm install

  3. Install frontend dependencies:

    cd ../frontend
npm install

  4. Set up environment variables: Create a .env file in the backend directory and add the following variables:

    MONGO_URI=<Your MongoDB URI>
JWT_SECRET=<Your JWT Secret>

  5. Run the application: Open two terminal windows or tabs:

    • In the first terminal, run the backend server: 
      cd backend
npm start
    • In the second terminal, run the frontend: 
      cd frontend
npm start

  6. Access the application: Open your web browser and navigate to http://localhost:3000.

Usage

After setting up the project, you can log in as an admin or patient to access different features of the application.

  • Admin: Can manage doctors, patients, and appointments.
  • Patient: Can view and manage their own appointments and medical records.

Demo

Check out the Live Demo of DocDirect.

Check out the Admin Dashboard of DocDirect.

Video

Watch a detailed video walkthrough of DocDirect to see all features in action.

Technologies

MongoDB Express.js React Node.js JWT Toastify Axios React-Icons React-Router

Contributing

We welcome contributions! Follow these steps to contribute:

  1. Fork the repository.
  2. Create a new branch: 
    git checkout -b feature/YourFeature
  3. Make your changes and commit them: 
    git commit -m "Add feature: YourFeature"
  4. Push to the branch: 
    git push origin feature/YourFeature
  5. Create a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contact

For any inquiries or issues, feel free to contact me: