WastelessHarvest Frontend ✨

Welcome to the WastelessHarvest Frontend repository 🌱 ! WastelessHarvest is a powerful food waste management system aimed at addressing the global issue of food wastage. This repository contains the frontend codebase for our application.

Table of Contents

• Overview
• Features
• Getting Started
• Technologies Used
• Project Structure
• Contributing
• License
• Contact

Overview 🌎

WastelessHarvest is a revolutionary platform dedicated to reducing food waste by connecting food suppliers (e.g., restaurants, supermarkets, caterers) with individuals or organizations in need of food assistance. The food waste management system connects food suppliers with nearby individuals or organizations in need of food. Food suppliers create listings for their excess food on the platform, describing the type and quantity of food available, as well as the pickup location and time. Recipients search for available listings on the platform and contact the food supplier directly to arrange for pickup. The system provides contact details for the supplier. 🤝

This project is built using the following technologies:

• Frontend: React ⚛️
• Backend: Spring Boot 🍃
• Database: MySQL 🦈

This repository contains the frontend of our application, which is built using React. To fully utilize the application, you need to set up the backend of the project. You can find instructions for setting up the backend by visiting the backend repository. 🚀

Features 🌟

User Authentication 🔐

• Sign In: Users can sign in using their registered email and password.
• Update Account Info: Registered users can update their account details. ✏️

Donation Management 🥫

• Donating: Food suppliers can easily list their excess food inventory on our platform, specifying details such as quantity, expiry date, location, and contact information.
• View Listed Food: Users can browse through the listed surplus food to discover available food items.
• Recipient Actions: Recipients search for available listings on the platform and contact the food supplier directly to arrange for pickup using the contact details provided in the platform.

Supplier-Specific Features 🛒

• Supplier Dashboard: Suppliers can view and manage the food items they have listed on the platform.
• Delete Listed Food Items: Suppliers have the option to remove food items they have listed if needed. 🗑️

Getting Started 🚀

To set up the WastelessHarvest Frontend on your local machine, follow these steps:

System Requirements 🖥️

Before you begin, ensure your system meets the following requirements:

• Node.js: Ensure you have Node.js installed. The project requires a minimum Node.js version of 14.0.0. You can download Node.js from nodejs.org.
• npm: Verify that you have npm (Node Package Manager) installed. npm is typically included with Node.js.

1. Clone this repository to your local environment.
2. Navigate to the project directory.
3. Run npm install to install the required project dependencies.
4. Launch the development server by running npm start.
5. Open your web browser and access the application at http://localhost:3000. 🌐

Technologies Used 🛠️

This project is built with the following key technologies:

• React: A popular JavaScript library for building user interfaces.
• React Router: For handling navigation within the application.
• Axios: For making API requests to the backend.
• CSS Modules: For modular and scoped CSS styles.
• Other dependencies: Listed in the package.json file. 📦

Project Structure 📂

The project's structure is organized as follows:

• src/: Contains the source code for the frontend application.
• public/: Contains public assets and the index.html file.
• package.json: Lists project dependencies and scripts.
• README.md: This detailed README file. 📁

Contributing 🤝

We welcome contributions to the WastelessHarvest frontend project. By contributing, you can play a crucial role in reducing food waste and making a positive impact on our community. There are various ways to get involved and contribute:

• Bug Reports: If you come across any issues, bugs, or unexpected behavior, please create an issue in our repository to report the problem. Be sure to provide detailed information and steps to reproduce the issue. 🐛

• Feature Requests: If you have ideas for new features or improvements, feel free to create a feature request issue. We value your suggestions for enhancing the platform. 🚀

• Pull Requests: We encourage developers to submit pull requests to address issues or contribute new features. Fork our repository, make your changes, and create a pull request for review. 🛠️

• Documentation: If you have expertise in documentation, you can help improve our project's documentation for users and contributors. 📚

We appreciate your contributions and value your input. Thank you for considering contributing to WastelessHarvest. Together, we can create a more sustainable and equitable future. 🌍

License 📜

This project is open-source and is licensed under the MIT License. 📃

Contact 📧

If you have any questions or require assistance, please feel free to reach out to us at [email protected]. We welcome your involvement in our mission to reduce food waste and combat hunger. Together, we can make a significant difference! 💌