🍲 Food Donation Application

Introduction

Welcome to the Food Donation Application repository! This Android application aims to bridge the gap between food donors and organizations in need. By providing a seamless way to donate surplus food, we strive to reduce food waste and support communities. The app utilizes Firebase for backend services, ensuring real-time data handling and secure authentication.

Features

• 🔒 User Authentication: Secure login and registration using Firebase Authentication.
• 📋 Create Donations: Users can easily create new food donation entries.
• 🗺️ View Donations: Organizations can view available food donations nearby.
• 📊 Manage Donations: Real-time donation management using Firebase Realtime Database.
• 🛠️ Admin Dashboard: Comprehensive dashboard for managing users and donations.

Installation

Prerequisites

• Android Studio (latest version)
• Java JDK (version 8 or higher)
• Firebase Account

Steps

1. Clone the repository:

   git clone https://github.com/premkumarmistry/FoodDonation.git
   cd FoodDonation

2. Open the project in Android Studio:

   • Launch Android Studio.
   • Select "Open an existing Android Studio project".
   • Navigate to the cloned directory and open it.

3. Set up Firebase:

   • Go to the Firebase Console.
   • Create a new project or use an existing one.
   • Add an Android app to your project and follow the setup steps.
   • Download the google-services.json file and place it in the app directory of your Android project.

4. Configure Firebase:

   • Open the build.gradle files (both project-level and app-level) and ensure you have the necessary Firebase dependencies added.
   • Sync your project with Gradle files.

5. Run the application:

   • Connect your Android device or start an emulator.
   • Click on the "Run" button in Android Studio to install and launch the app.

Usage

1. Register an account: Sign up using the registration form within the app.
2. Create a new donation: Fill in the details of the food donation you want to offer.
3. View donations: Browse available food donations nearby.
4. Manage donations: Accept or decline donations, and track their status.

Contributing

We welcome contributions to enhance the Food Donation Application. To contribute:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature-name).
3. Make your changes and commit them (git commit -m 'Add some feature').
4. Push to the branch (git push origin feature/your-feature-name).
5. Open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For questions or support, please contact:

• Prem Kumar Mistry: [email protected]
• GitHub Issues: Open an issue on the repository for bug reports or feature requests.