Medora is a modern and responsive healthcare platform built using Laravel (API) and React (frontend). It enables patients to easily find and book appointments with nearby doctors, offering a smooth and accessible user experience on all devices.

• User-friendly appointment booking - Easy to navigate interface for finding and scheduling medical appointments
• Doctor search and filtering - Find healthcare professionals by specialty, location, and availability
• Responsive design - Seamless experience across desktop, tablet, and mobile devices
• Secure authentication - Protected user accounts and medical information
• Real-time notifications - Appointment reminders and booking confirmations
• Admin dashboard - Comprehensive management system for healthcare providers

• Backend: Laravel 12.x (PHP 8.x)
• Frontend: React 19.x with modern JavaScript
• Database: MySQL
• Authentication: Laravel Sanctum
• Styling: Tailwind CSS
• API: RESTful API architecture

Before you begin, make sure you have the following installed:

• Node.js (v20 or higher)
• Composer
• https://git-scm.com/downloads
• PHP (v8.0 or higher)
• https://www.mysql.com/ or another database system

git clone https://github.com/7xmohamed/Medora.git
cd Medora

composer update

Set up environment variables:

cp .env.example .env

Generate application key:

php artisan key:generate

Configure your database in the .env file:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=medora
DB_USERNAME=root
DB_PASSWORD=your_password

Run database migrations and seeders:

php artisan migrate --seed

Start the Laravel development server:

php artisan serve

The API will be available at http://localhost:8000

Navigate to the frontend directory:

cd /frontend

Install Node.js dependencies:

npm install

Set up environment variables:

cp .env.example .env

Configure your API URL in the .env file:

REACT_APP_API_URL=http://localhost:8000/api

Start the React development server:

npm start

The frontend will be available at http://localhost:3000

Medora/
├── backend             # Laravel-based backend application
│   ├── app               # Core application logic (controllers, models, etc.)
│   ├── bootstrap           # Bootstrapping scripts (e.g., app.php)
│   ├── config              # Configuration files for services and settings
│   ├── database            # Database-related files (migrations, seeders, factories)
│   ├── public              # Publicly accessible files (e.g., index.php, assets)
│   ├── resources           # Blade views, uncompiled assets (Sass, JS, etc.)
│   ├── routes              # API and web route definitions
│   ├── storage             # Generated files, logs, cached views, session data
│   ├── tests               # Unit and feature tests for backend logic
│   └── vendor              # Composer dependencies (Laravel framework, third-party packages)
│
├── frontend            # React-based (or similar) frontend application
│   ├── public            # Static assets (images, icons, robots.txt, etc.)
│   └── src               # Source code for the frontend
│       ├── components      # Reusable UI components
│       ├── contexts        # React Context API providers for state management
│       ├── data            # Mock data or static JSON/data files
│       ├── layouts         # Layout wrappers (e.g., headers, footers)
│       ├── lib             # Utility functions or libraries
│       ├── pages           # Page-level components (organized by role or section)
│       ├── routes          # Routing configuration for frontend navigation
│       ├── services        # API calls to communicate with the backend
│       ├── styles          # Global CSS/SCSS styling
│       └── utils           # Helper functions and shared tools
│
└── imgs                # Miscellaneous images used for demos, documentation, or references    

1. Patients

   • Browse doctors and specialties
   • Book and manage appointments
   • View medical history
   • Receive notifications

2. Doctors

   • Manage schedule and availability
   • View upcoming appointments
   • Access patient medical records

3. Administrators

   • Manage users and permissions
   • View analytics and system usage
   • Configure system settings
   • Oversee all platform activities

1. CORS errors: Ensure your Laravel CORS configuration is set up properly in config/cors.php:

   'paths' => ['api/*'],
   'allowed_origins' => ['http://localhost:3000'],

2. Database connection issues: Verify your database credentials and ensure the database exists.

3. Node modules issues: If you encounter errors with Node modules, try:

   rm -rf node_modules
   npm cache clean --force
   npm install

4. Composer dependency conflicts: Try:

   composer update --ignore-platform-reqs

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Commit your changes: git commit -m 'Add some feature'
4. Push to the branch: git push origin feature-name
5. Submit a pull request

This project is licensed under the MIT License - see the LICENSE file for details.

• Mohamed – Core Development & Project Setup – 7xmohamed
• Anass – Development Support & Collaboration – AnassA7

For support, email [email protected] or open an issue on the GitHub repository.