Skip to content

Native Android app leveraging Firebase to connect donors and recipients for sustainable item reuse with secure authentication, real-time chat, map-based discovery and optimized media handling.

License

Notifications You must be signed in to change notification settings

MMALI3287/ReUse

Repository files navigation

ReUse: Sustainable Item Donation Platform 🌱

Android Build Firebase Java Material Design Gradle Min SDK Google Maps GitHub forks GitHub stars GitHub license wakatime

🎯 Overview

ReUse is a sophisticated Android application designed to revolutionize the way we handle unwanted items in our communities. By connecting donors with recipients, we're creating a sustainable ecosystem for item reuse while reducing environmental waste.

Key Features

  • 🔐 Secure Authentication

    • Email/Password and Google Sign-in integration
    • Profile management with customizable settings
    • Secure user data handling
  • 📱 Intuitive UI/UX

    • Material Design implementation
    • Custom Poppins font family
    • Responsive grid layout for item discovery
    • Dynamic image slider for item photos
    • Category-based filtering system
  • 📍 Location Services

    • Google Maps integration
    • Real-time location tracking
    • In-app navigation
    • Location-based item discovery
    • Custom location search
  • 💬 Real-time Communication

    • Instant messaging system
    • Chat history preservation
    • Message notifications
    • User-to-user direct messaging
  • 📸 Advanced Media Handling

    • Multiple image upload (up to 3 per item)
    • Image compression and optimization
    • Efficient storage management
    • Real-time image loading

🛠️ Technical Stack

Frontend

  • Native Android development with Java
  • Material Design components
  • Custom UI elements
  • Responsive layouts
  • Fragment-based architecture

Backend Services

  • Firebase Authentication
  • Firebase Realtime Database
  • Firebase Cloud Storage
  • Google Cloud Platform

Third-Party Libraries

  • Google Maps SDK & Places API
  • Picasso for image loading
  • Dexter for runtime permissions
  • AutoImageSlider for image galleries

🚀 Getting Started

Prerequisites

  • Android Studio Arctic Fox or later
  • JDK 11 or higher
  • Android SDK (minimum API 21)
  • Google Play Services
  • Firebase account and configuration

Installation

  1. Clone the repository:

    git clone https://github.com/MMALI3287/ReUse.git
  2. Open in Android Studio:

    • Launch Android Studio
    • Select 'Open an Existing Project'
    • Navigate to the cloned directory
  3. Configure Firebase:

    • Add your google-services.json
    • Update Firebase dependencies if needed
  4. Build and run:

    ./gradlew build

🤝 Contributing

We welcome contributions to ReUse! Here's how you can help:

  1. Fork the repository
  2. Create your feature branch: git checkout -b feature/AmazingFeature
  3. Commit your changes: git commit -m 'Add some AmazingFeature'
  4. Push to the branch: git push origin feature/AmazingFeature
  5. Open a Pull Request

👥 Team

📄 License

This project is licensed under the MIT License

Copyright © 2023
MD Musaddique Ali Erfan

About

Native Android app leveraging Firebase to connect donors and recipients for sustainable item reuse with secure authentication, real-time chat, map-based discovery and optimized media handling.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 5