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

https://github.com/ismail-dev-code/meal-giver-client

MealGiver is a MERN stack-based food donation and redistribution platform that connects restaurants with verified charities and individuals to reduce food waste and support communities.
https://github.com/ismail-dev-code/meal-giver-client

expressjs html-css-javascript html5 mongodb react-router reactjs

Last synced: 2 months ago
JSON representation

MealGiver is a MERN stack-based food donation and redistribution platform that connects restaurants with verified charities and individuals to reduce food waste and support communities.

Awesome Lists containing this project

README

          

# 🥗 MealGiver — Food Donation Platform

**MealGiver** is a MERN stack-based food donation and redistribution platform that connects restaurants with verified charities and individuals to reduce food waste and support communities.

---

## 🌍 Project Links

- 🔗 **Live Site**: [https://meal-giver-web.app](https://meal-giver-web.app)
- 🔗 **Frontend Repository**: [https://github.com/meal-giver-client](https://github.com/ismail-dev-code/meal-giver-client)
- 🔗 **Backend API Repository**: [https://github.com/meal-giver-server](https://github.com/ismail-dev-code/meal-giver-server)

---

## ✨ Features

### 👩‍🍳 For Restaurants
- Add new food donations
- View donation request details
- Track donation status and history
- View and manage donation requests

### 🏥 For Charities
- Request donations
- Track pickup status
- Add to favorites
- Submit reviews
- Role upgrade via Stripe payment

### 👤 For Users
- View verified donations
- Save donations to favorites
- Submit role upgrade request
- Submit reviews

### 🛠 Admin Dashboard
- Manage users and roles
- Approve donations and role requests
- Monitor platform activity

---

## ⚙️ Tech Stack

| Frontend | Backend |
| --------------------------------- | -------------------------------- |
| React, TailwindCSS, SwiperJS | Express.js, MongoDB, Firebase |
| React Router, DOM | Firebase Admin SDK |
| Axios, React Query, TanStack | Stripe API (Payments) |
| DaisyUI, Headless UI, Toastify | Decoded, dotenv, CORS |

---

## 🔑 Roles and Permissions

| Role | Description |
| ------------ | -------------------------------------- |
| `User` | Default user. Can browse and favorite |
| `Charity` | Can request donations, review, pickup |
| `Restaurant` | Can post donations and manage requests |
| `Admin` | Full control over platform |

---

## 🧑‍💻 Developer

**Ismail Hossain**
📧 hm.ismail772@gmail.com
🌍 Noakhali, Bangladesh
🔗 [GitHub](https://github.com/ismail-dev-code) | [LinkedIn](https://www.linkedin.com/in/ismail-hossain24)

---

> Feel free to fork the project, open issues, or contribute via pull requests!