Skip to content

A mobile solution that transforms local sharing, enabling easy donation and request of critical items across communities

License

Notifications You must be signed in to change notification settings

itz-Hiru/care-bridge

Repository files navigation

🌉 Care Bridge

🚀 Community Donation & Sharing Platform

GitHub stars GitHub last commit Android Build

📖 Overview

Care Bridge is a mobile application designed to foster community support by enabling seamless donation and request of essential items like food, books, and other necessities.

🗂 Project Structure

Carebridge/
│
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/carebridge/
│   │   │   │   ├── activities/
│   │   │   │   │
│   │   │   │   ├── adapters/
│   │   │   │   │   ├── CarousalAdapter.java
│   │   │   │   │   ├── DonationAdapter.java
│   │   │   │   │   ├── FoodViewPagerAdapter.java
│   │   │   │   │   ├── NavigationViewPagerAdapter.java
│   │   │   │   │   └── NotificationAdapter.java
│   │   │   │   │
│   │   │   │   ├── models/
│   │   │   │   │   ├── Donation.java
│   │   │   │   │   └── Notification.java
│   │   │   │   │
│   │   │   │   └── fragments/
│   │   │   │       ├── HomeFragment.java
│   │   │   │       ├── NotificationFragment.java
│   │   │   │       └── SettingsFragment.java
│   │   │   │
│   │   │   ├── res/
│   │   │   │   ├── layout/
│   │   │   │   ├── drawable/
│   │   │   │   ├── values/
│   │   │   │   └── menu/
│   │   │   │
│   │   │   └── AndroidManifest.xml
│   │   │
│   │   └── test/
│   │       └── java/
│   │           └── com/carebridge/
│   │               └── UnitTests.java
│   │
│   ├── libs/
│   └── build.gradle
│
├── gradle/
│   └── wrapper/
│
├── .gitignore
├── build.gradle
├── google-services.json (not tracked)
└── README.md

🏗 Structure Explanation

📁 Main Packages

  • activities/: Core app screens and user interactions
  • adapters/: RecyclerView adapters for lists
  • models/: Data models representing app entities
  • fragments/: Modular UI components

🔑 Key Components

  • User Authentication
  • Donation Management
  • Request Tracking
  • Profile Management

✨ Key Features

  • 🎁 Item Donation Platform
  • 📋 Item Request System
  • 🔐 Secure User Authentication
  • 🔔 Real-time Notifications

📚 Libraries & Technologies

🔍 Core Libraries

  • Navigation: AAndroidx ViewPager Navigation Library
  • QR Code: Zixin QR Code Generator/Scanner
  • Chart Visualization: MP Android Charts
  • Photo Manipulation: Piccasso Library

🔥 Firebase Integration

  • Firebase Authentication
  • Firebase Realtime Database
  • Firebase Storage

🛠 Tech Stack

  • Language: Java
  • IDE: Android Studio
  • Backend: Firebase
  • Architecture: MVVM

📦 Dependencies

Add these to your build.gradle:

dependencies {
    implementation 'com.google.zxing:core:3.4.1'
    implementation 'com.journeyapps:zxing-android-embedded:4.3.0'
    implementation 'androidx.viewpager2:viewpager2:1.1.0'
    implementation 'com.github.PhilJay:MPAndroidChart:3.1.0'
    implementation 'com.github.dhaval2404:imagepicker:2.1'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.15.1'
    implementation 'com.github.bumptech.glide:glide:4.15.1'
    implementation 'com.squareup.picasso:picasso:2.71828'
}

🚀 Quick Start

Prerequisites

  • Android Studio
  • Java JDK 11+
  • Firebase Account

Installation Steps

  1. Clone the repository

    git clone https://github.com/itz-Hiru/care-bridge.git
    
  2. Firebase Setup

    • Create project in Firebase Console
    • Download google-services.json
    • Place in app/ directory
  3. Configure Zixin Libraries

    • Add library dependencies
    • Initialize in MainActivity

🔒 Security Features

  • Firebase Authentication
  • Secure QR Code Generation
  • Data Encryption
  • Role-Based Access Control

🤝 Contributing

  1. Fork the Project
  2. Create Feature Branch
  3. Commit Changes
  4. Push to Branch
  5. Open Pull Request

📝 License

Distributed under [Your License]. See LICENSE for more information.

📞 Contact


Made with ❤️ for Community Sharing

About

A mobile solution that transforms local sharing, enabling easy donation and request of critical items across communities

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages