{"id":31644452,"url":"https://github.com/apexryan/food-cloud","last_synced_at":"2026-05-20T05:01:55.366Z","repository":{"id":312107018,"uuid":"1043839558","full_name":"apexryan/Food-Cloud","owner":"apexryan","description":"A MERN stack web application designed to help NGOs manage and redistribute surplus food from donors (restaurants, events, households) to the underprivileged.","archived":false,"fork":false,"pushed_at":"2025-08-28T16:14:34.000Z","size":7644,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-28T21:51:04.743Z","etag":null,"topics":["cloudinary","jwt-authentication","mern-stack","postman","restful-api"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apexryan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-24T18:16:05.000Z","updated_at":"2025-08-28T16:14:40.000Z","dependencies_parsed_at":"2025-08-28T22:02:27.559Z","dependency_job_id":null,"html_url":"https://github.com/apexryan/Food-Cloud","commit_stats":null,"previous_names":["apexryan/food-cloud"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/apexryan/Food-Cloud","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apexryan%2FFood-Cloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apexryan%2FFood-Cloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apexryan%2FFood-Cloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apexryan%2FFood-Cloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apexryan","download_url":"https://codeload.github.com/apexryan/Food-Cloud/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apexryan%2FFood-Cloud/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278722768,"owners_count":26034461,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudinary","jwt-authentication","mern-stack","postman","restful-api"],"created_at":"2025-10-07T04:52:55.364Z","updated_at":"2026-05-20T05:01:55.357Z","avatar_url":"https://github.com/apexryan.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🥗 FoodCloud: Cloud-Based NGO \u0026 Waste Food Management System\n\nA cloud-powered MERN stack web application designed to help NGOs manage and redistribute surplus food from donors (restaurants, events, households) to the underprivileged. It bridges the gap between food donors and volunteers using real-time tracking, secure authentication, and optimized delivery logistics.\n\n---\n\n## 🚀 Key Features\n\n- 🔐 **User Management**: Role-based login (NGO, Donor, Volunteer, Admin)\n- 📦 **Donation Management**: Real-time food request form with image and location and availability tagging\n- 🗺️ **Admin Management**: Comprehensive admin tools to manage users, food posts and system operations\n- 🗺️ **Pickup \u0026 Delivery**: Route optimization for volunteers\n- 📊 **Analytics Dashboard**: Track total donations, meals served, and more\n- 🛡️ **Security**: JWT authentication, bcrypt hashing, HTTPS\n  \n\n\n---\n\n## 📸 Screenshots\n\n### 🔐 Login Screen\n![Login Screen](images/Login.png)\n\n### 🏠 Home Page\n![HomePage](images/HomePage.png)\n\n### 🧑 Donor Dashboard\n![Donor Dashboard](images/DonorDB.png)\n\n### 🧑‍💻 Admin Dashboard\n![Admin Dashboard](images/AdminDB.png)\n\n### 🥗 Food Posts\n![Food Post](images/Foodpost.png)\n\n---\n\n## 🧰 Tech Stack\n\n### 🌐 Frontend\n- React.js (Vite)\n- HTML5, CSS3, Bootstrap 5\n- Axios\n\n### ⚙️ Backend\n- Node.js + Express.js\n- JWT Authentication\n- Cloudinary for image uploads\n- RESTful APIs\n\n### 🗄️ Database\n- MongoDB Atlas (Cloud)\n- Mongoose ODM\n\n### ☁️ Cloud \u0026 Hosting\n- Render / Docker (Backend deployment)\n- Vercel / Netlify (Frontend deployment)\n\n### ✅ Testing\n- Jest, Mocha\n- Postman for API testing\n\n---\n\n## 📂 Project Structure\n\n```bash\n├── Client/\n│   └── frontend/                   # React Frontend\n│       ├── public/\n│       │   └── vite.svg\n│       └── src/\n│           ├── assets/\n│           ├── components/\n│           │   ├── auth/          # Authentication components\n│           │   ├── Chat/          # Real-time chat feature\n│           │   │   ├── Controls/\n│           │   │   └── Loader/\n│           │   ├── food/          # Food post management\n│           │   ├── ngo/           # NGO specific components\n│           │   └── volunteer/     # Volunteer components\n│           ├── contexts/          # React Context providers\n│           └── services/          # API services\n├── Server/                        # Node.js Backend\n│   ├── config/                   # Configuration files\n│   ├── controllers/              # Request handlers\n│   ├── middleware/               # Custom middleware\n│   ├── models/                   # Database models\n│   ├── routes/                   # API routes\n│   └── services/                 # Business logic\n└── images/                       # Project screenshots\n```\n\n## 📦 Prerequisites\n\n- Node.js\n- MongoDB Atlas\n- Postman for testing APIs\n\n## 🛠️ Installation\n\n```bash\n# 1. Clone the repository\ngit clone https://github.com/username/Food-Cloud.git\n\n# 2. Navigate into the project folder\ncd foodcloud\n\n# 3. Install backend dependencies\ncd server\nnpm install\n\n# 4. Install frontend dependencies\ncd client\ncd frontend\nnpm install\n\n# 5. Build frontend (optional for deployment)\nnpm run build\n```\n## 🧪 Usage (Dev Mode)\n\n```bash\n# Run the backend server\ncd server\nnpm start\n\n# Run the frontend app\ncd client\ncd frontend\nnpm run dev\n\nThen open http://localhost:5173 in your browser.\n```\n## 🧾 Agile Milestones (6 Weeks)\n\n| Week | Sprint Goal                                |\n| ---- | ------------------------------------------ |\n| 1️⃣  | Planning, Environment Setup, Schema Design |\n| 2️⃣  | User Authentication, Role Management       |\n| 3️⃣  | Food Posting \u0026 Request Module              |\n| 4️⃣  | Volunteer Assignment \u0026 Status Lifecycle    |\n| 5️⃣  | Admin Dashboard, Cloud Deployment          |\n| 6️⃣  | Testing, UI Polishing, Documentation       |\n\n## 📈 Future Enhancements\n\n- 🔔 Push Notifications via Firebase\n- 🌐 Multi-language support\n- 📱 SMS reminders for pickups\n- 📦 QR code-based delivery verification\n\n## 🤝 Contributors\n- Rupayan Kumar\n- Subhajit Sadhukhan\n- Rishab Das\n- Saptarshi Dutta\n\n## 📃 License\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapexryan%2Ffood-cloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapexryan%2Ffood-cloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapexryan%2Ffood-cloud/lists"}