ResQFood: Bridging the Gap Between Leftovers and Hungry Stomachs

Feel free to star ⭐ the repository if you find it valuable.

<img src="logo.png" width="1000" height="500" alt="banner"/>

About

ResQFood's vision is to build a world where delicious food doesn't end up in the trash. By bringing together restaurants and individuals, we create a win-win scenario for everyone involved.

This platform is dedicated to the noble cause of reducing food wastage by facilitating the redistribution of surplus food during late-night hours before restaurant closures. Our mission is to ensure that excess inventory finds a purposeful destination rather than ending up in landfills, contributing to a more sustainable and compassionate food ecosystem.

It is a mobile app designed to connect restaurants with individuals looking for a delicious and affordable meal while tackling food waste. It empowers restaurants to utilize leftover food instead of discarding it and provides individuals with access to great deals on quality food.

💻 Tech Stack:

<!-- Kotlin --> <img src="https://img.shields.io/badge/kotlin-%230095D5.svg?style=for-the-badge&logo=kotlin&logoColor=white" alt="Kotlin logo"> <!-- Jetpack Compose --> <img src="https://img.shields.io/badge/jetpack%20compose-%233D3D3D.svg?style=for-the-badge&logo=jetpack-compose&logoColor=white" alt="Jetpack Compose logo">

⛏️ Tools:

• Firebase
• Google Map SDK

App Features: TODO

Design Idea:

• https://www.figma.com/design/93qkrzana3qZ1jup0D6GjY/Untitled?node-id=0%3A1&t=Rxda2auBzo0To2WM-1

Welcome & Onboarding Screens

• Welcome Screen: Show the app's name, a tagline like "Delicious Meals, Less Waste," and a "Get Started" button.
• Onboarding Screens:
• A series of 3-4 screens explaining the app's purpose and key features with illustrations.
  • Screen 1: "Save Money on Quality Meals"
  • Screen 2: "Help Reduce Food Waste"
  • Screen 3: "Support Local Restaurants"
  • Screen 4: "Join a Sustainable Community"
• Login/Signup Screen: Options to sign up with email, Google, or Facebook. Include a "Continue as Guest" option

Home Screen (For Individuals)

• Top Navigation Bar: App logo, search bar, profile icon.
• Search & Filter Options: Filters for location, cuisine type, price, and pickup window.
• Featured Listings: Carousel of highlighted leftovers with images, names, and prices.
• Nearby Restaurants: List of nearby restaurants with available leftovers.
• Categories: Tabs for Appetizers, Main Courses, Desserts, etc.
• Map View: Toggle option to switch between list view and a map view showing restaurant locations.

Restaurant Profile Screen

• Profile Information: Restaurant name, contact info, cuisine type, operating hours.
• About Us: Short description of the restaurant.
• Food Listings: Grid or list of available leftovers with images, descriptions, quantities, and prices.
• Reviews & Ratings: User reviews and average rating.

Adding Leftovers (For Restaurants)

• Add Item Screen: Form to add leftover items.
• Item Name: Text field.
• Description: Text area.
• Category: Dropdown menu (Appetizers, Main Courses, Desserts, etc.).
• Quantity: Number input.
• Estimated Value: Number input.
• Price: Number input (option for free).
• Pickup Window: Time picker.
• Add Image: Option to upload a photo.
• Submit Button: Button to save the listing.

Ordering & Pickup (For Individuals)

• Item Details Screen: Detailed view of a leftover item.
• Image: Large image of the item.
• Description: Detailed description.
• Pickup Time: Display pickup window.
• Price: Display price.
• Claim Button: Button to claim the item.
• Order Confirmation Screen: Confirmation details of the order with directions to the restaurant.
• Payment Integration: Integrated payment options for items with a fee.

Notifications

• Notification Center: List of notifications.
• Order Confirmations: Notifications for confirmed orders.
• Ready for Pickup: Alerts when an item is ready for pickup.
• New Listings: Notifications about new leftovers from favourite restaurants.

Tracking & Analytics (For Restaurants)

• Dashboard Screen: Visual stats and graphs.
• Food Saved: Amount of food saved from waste.
• Total Orders: Number of orders fulfilled.
• User Feedback: Summary of user reviews and ratings.

Communication

• Messaging Screen: In-app messaging interface.
• Chat List: List of ongoing conversations.
• Chat Window: Individual chat with text input and send button.
• Notifications for Messages: Alerts for new messages.

Profile & Settings

• User Profile Screen: User information, order history, saved restaurants.
• Restaurant Profile Settings: Edit restaurant details, manage listings and view analytics.
• Security & Privacy Settings: Options to manage account security, notifications, and privacy settings.

Community Building

• Community Feed: Social feed for sharing tips on reducing food waste, sustainability articles, and success stories.
• Events & Campaigns: Information on community events related to food waste and sustainability.

<!-- - For Restaurants: 1. Listing & Profile: Restaurants can create profiles, and add their contact information, cuisine type, and operating hours. Food Inventory: 2. Adding Leftovers: Restaurants can easily add leftover food items (quantity, description, estimated value). 3. Categorization: Ability to categorize leftovers (e.g., appetizers, main courses, desserts) for easier search. 4. Pricing: Restaurants can set prices (free, discounted, etc.) for leftovers. 5. Pickup Window: Restaurants can specify a pickup time window to avoid leftovers sitting out for too long. 6. Notifications: Receive real-time notifications when someone claims their leftovers. 7. Tracking & Analytics: Restaurants can see how much food they've saved from waste and track overall usage. - For Individuals: 1. Search & Filter: Users can search for leftover food based on location, cuisine type, price, and pickup window. 2. Ordering & Pickup: Users can claim leftovers and receive directions to the restaurant for pickup. 3. Payment Integration: Users can pay for leftovers if the restaurant has a fee. 4. Order History: Users can keep track of their previous orders. 5. Rating & Reviews: Users can review restaurants and leftovers to help other users. - For Both: 1. Communication: In-app messaging system for restaurants and users to communicate about orders (e.g., special requests, dietary restrictions). 2. Location Services: Accurate location mapping for finding nearby restaurants and pickup locations. 3. Safety & Security: Measures to ensure the safety of both parties involved (e.g., verified restaurant profiles, user ratings). 4. Community Building: A platform to connect restaurants and individuals to raise awareness about food waste and sustainability. - Additional Features (Optional): 1. Food Donation: Partner with food banks or charities to facilitate donations of leftover food. 2. Delivery Service: Offer a delivery service for leftovers (could be a paid feature). 3. Sustainability Features: Integrate features that educate users about food waste and sustainability (e.g., carbon footprint calculators). ## How it Works ResQFood streamlines the process of connecting restaurants with either Directly with the needy ones or to a nearby establishments or charitable organizations, enabling them to efficiently redistribute surplus food. Through our platform, restaurants can easily upload information about the available surplus food, and establishments or organizations in need can browse and request donations. This seamless connection ensures that surplus food gets to those who need it most, even during the late hours when traditional donation channels may not be available. ## Social Benifits - **Efficient Redistribution**: Our platform enables restaurants to quickly connect with nearby establishments or charitable organizations to redistribute surplus food before closing time. - **Real-time Updates**: Restaurants can update available surplus food in real-time, ensuring accurate and timely information for potential recipients. - **Sustainability**: By diverting surplus food from landfills, ResQFood contributes to a more sustainable food ecosystem and reduces environmental impact. - **Compassionate Giving**: Charitable organizations and establishments in need can easily browse and request donations, ensuring that surplus food reaches those who need it most. ## Technologies - Jetpack - [Compose](https://developer.android.com/jetpack/compose): Modern toolkit for building native UI. - [Navigation](https://developer.android.com/jetpack/compose/navigation): Navigation component for Jetpack Compose. - [ViewModel](https://developer.android.com/topic/libraries/architecture/viewmodel): Store UI-related data that isn't destroyed on UI changes. - [Room](https://developer.android.com/jetpack/androidx/releases/room): SQLite object mapping library. - [Paging 3](https://developer.android.com/topic/libraries/architecture/paging/v3-overview): Load and display small chunks of data at a time. - [Hilt](https://developer.android.com/training/dependency-injection/hilt-android): Dependency injection library for Android. - [Retrofit](https://square.github.io/retrofit/): Type-safe HTTP client for Android and Java. - [Coroutines](https://developer.android.com/kotlin/coroutines): For managing background threads with simplified code and reducing needs for callbacks. with [Flow](https://kotlinlang.org/docs/flow.html). - [Coil](https://coil-kt.github.io/coil/): Image loading library for Android backed by Kotlin Coroutines. - [Gson](https://github.com/google/gson) : A Java serialization/deserialization library to convert Java Objects into JSON and back. ## Architecture ResQFood follows the MVVM (Model-View-ViewModel) architecture pattern, which separates the presentation layer from the business logic and data handling. This architecture p