FoodShare: A web based Donation Application

Description

Foodshare is a web-based platform designed to facilitate the donation of items to those in need.Foodshare ensures transparency, traceability, and accountability in the donation process. The platform connects donors with recipients through a user-friendly interface that leverages geolocation services and matching algorithms to optimize the donation process.

Dependancies

To run this project you will need to install the following dependancies

1. MySQL - Serves as Database

• Installation: Download mysql

2. NodeJs
   • Installation: Download nodejs
3. Laravel

• Installation: Download Laravel

4. Node Package Manager(NPM)

• Installation NPM

5. Composer - Dependancy manager for PHP

• Installation Composer

Installation

• Fork the Repository: Click on the Fork button at the top right corner of this page.

• Clone Your Fork:

  git clone https://github.com/tanuithecreator/IS1.git

• Install dependencies with *composer install*

• Copy *.env.example* to *.env* and configure your environment variables

• Generate application key with *php artisan key:generate*

• Migrate database with *php artisan migrate*

• Serve the application with *php artisan serve*

Features

• User registration and authentication
• Donation form for users to input food donation details
• Matching system to connect donors with recipients
• Admin panel to manage donations and users
• Reporting and analytics for tracking donations

License

This project is licensed under the MIT license.

Contact

For any inquiries or feedback, please reach out to:

• Julian Tanui - Julian
• Jeremy Chege - Jeremy

Project Structure

Project Root

├── .editorconfig
├── .env.example
├── .gitattributes
├── .gitignore
├── README.md
│
├── app
│   ├── Http
│   │   └── Controllers
│   │       ├── AboutController.php
│   │       ├── AdminController.php
│   │       ├── BlogController.php
│   │       ├── CategoryController.php
│   │       ├── CauseController.php
│   │       ├── ContactController.php
│   │       ├── Controller.php
│   │       ├── DetailsController.php
│   │       ├── HomeController.php
│   │       └── VolunteerController.php
│   │
│   ├── Models
│   ├── Providers
│   └── View
│
├── bootstrap
│
├── config
│
├── database
│
├── public
│
├── resources
│   ├── views
│   │   ├── About.blade.php
│   │   ├── Blog.blade.php
│   │   ├── Cause.blade.php
│   │   ├── contact.blade.php
│   │   ├── dashboard.blade.php
│   │   ├── home.blade.php
│   │   ├── navigation-menu.blade.php
│   │   ├── policy.blade.php
│   │   ├── terms.blade.php
│   │   │
│   │   ├─── Category
│   │   ├─── components
│   │   ├─── Details
│   │   ├─── emails
│   │   ├─── layouts
│   │   ├─── profile
│   │   └─── Volunteer
│
├── routes
│
├── storage
│
└── tests