An open API service indexing awesome lists of open source software.

https://github.com/m-yash/mealmate

MERN based web app
https://github.com/m-yash/mealmate

expressjs geoapify geospatial mongo nodejs reactjs windmill-ui

Last synced: 2 months ago
JSON representation

MERN based web app

Awesome Lists containing this project

README

          

**Introduction**

MealMate is a platform designed to connect individuals who enjoy cooking together or wish to earn by fulfilling food requests nearby. Users can post requests, appeal for requests, and collaborate with others for a shared cooking experience. This guide will help you understand how to navigate and use the MealMate application effectively. Whether you're a new user or looking to troubleshoot an issue, this manual provides all the necessary information.

**Getting Started**

*Step 1: Registration and Login*
- Navigate to the MealMate homepage.
- Click on Sign Up.
- Fill out the registration form with:
- Name
- Email
- Password
- Phone number
- Address
- [Optional] If you’re a chef, upload your food handling certificate to activate chef-specific features
- Click Register.

![image](https://github.com/user-attachments/assets/e8d5ddc9-2cbd-4c4e-af1d-b5a55ce09d03)
- Use your credentials to log in.

![image](https://github.com/user-attachments/assets/fbde2545-af51-4786-bfa5-b628c3327e68)

*Step 2: Navigating the Dashboard*
- Once logged in, the Dashboard is the central hub.
- Key sections:
- Requests: View and manage food requests.
- Appeals: Respond to nearby requests.
- Profile: Update personal details.
- Use the sidebar for easy navigation.

![image](https://github.com/user-attachments/assets/b38e6878-cabb-4720-bc30-d2610ccd7217)

![image](https://github.com/user-attachments/assets/92f6effa-b0fa-4f80-8609-930164342ae5)

**Main Features**

*Posting a Food Request (For Requesters)*

1. Click on the ‘Find a mate’ button.

![image](https://github.com/user-attachments/assets/2cfd5b4e-bafe-40fd-b564-e824a1c4723a)

2. Fill in the request form:
- Food preferences
- Budget
- Date and time
- Location (auto-filled or manually entered)
3. Submit the request.
4. View your posted requests in the My Requests section.

![image](https://github.com/user-attachments/assets/00fd340a-d59c-4930-90b9-c37e97afc306)


*Responding to Requests (For Chefs)*

1. Open the Available Requests tab.
2. Filter requests within your 3 km radius.
3. Click Appeal to respond to a request.

![image](https://github.com/user-attachments/assets/1c564825-b887-483e-a1c7-9322c5d3ea88)

4. Provide a message and details about your offer.

![image](https://github.com/user-attachments/assets/c3280ee5-9fb5-4f24-a0f9-be2eb6f8c17b)

5. Wait for the requester to accept or reject your appeal.

*Managing Appeals and Bookings*

1. Requesters can view all appeals for their posted requests in the Available Appeals section.

![image](https://github.com/user-attachments/assets/99d35d7c-ebcf-4c04-af5d-d68343109d52)

2. Accept or reject an appeal based on the chef's rating and response.
3. Confirm accepted bookings and finalize details.
4. Chefs can track accepted bookings in their My Mates section.

![image](https://github.com/user-attachments/assets/608247ba-3219-4d00-8793-f07a7f6e5b11)

5. Requester can give rating to the chef.

![image](https://github.com/user-attachments/assets/548d9e4f-b2b9-4ec6-8089-d69ced047417)

**Profile Management**

*Updating Personal Information*

1. Navigate to the Profile section from profile icon.
2. Edit fields such as:
- Name
- Phone number
- Email address
- Password (requires current password for verification).
3. Save changes.

![image](https://github.com/user-attachments/assets/abf8a4f1-cb62-48b2-84a5-37af683a7437)


*Uploading Food Handling Certificates (For Chefs)*

1. In the Profile section, click on Upload Certificate.
2. Choose the file and upload it.
3. Upon approval, chef-specific features will be activated.

**Statistics**

Total Food Requests
- Description: This card shows the total number of food requests made in the last 30 days.

Total Appeals
- Description: This card displays the total number of appeals made in the last 30 days.

Average Appeals per Request
- Description: This card shows the average number of appeals made per food request over the last 30 days.

Monthly Data Chart
- Description: A bar chart visualizes the number of food requests and appeals over the last six months.

![image](https://github.com/user-attachments/assets/95a54f80-6cbf-4510-ba58-afbf249ec098)