https://github.com/firaskahlaoui/we-rescue

"We Rescue" is an Android application designed for pet adoption.
https://github.com/firaskahlaoui/we-rescue

adoption android-application android-studio firebase-auth firebase-realtime-database firebase-storage java pet-project xml

Last synced: about 5 hours ago
JSON representation

"We Rescue" is an Android application designed for pet adoption.

• Host: GitHub
• URL: https://github.com/firaskahlaoui/we-rescue
• Owner: FirasKahlaoui
• License: mit
• Created: 2024-03-22T15:21:21.000Z (8 months ago)
• Default Branch: master
• Last Pushed: 2024-06-23T21:39:02.000Z (5 months ago)
• Last Synced: 2024-06-23T22:36:22.105Z (5 months ago)
• Topics: adoption, android-application, android-studio, firebase-auth, firebase-realtime-database, firebase-storage, java, pet-project, xml
• Language: Java
• Homepage:
• Size: 1.07 MB
• Stars: 10
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# We Rescue - Pet Adoption App

"We Rescue" is an Android application designed for pet adoption, allowing users to post pets for adoption and find pets to adopt. Built using Java, XML, Firebase (Authentication, Realtime Database, Storage), and SQLite, the app features a modern design and intuitive user interface.

## About This Project

"We Rescue" aims to connect pet owners looking to rehome their pets with potential adopters in a user-friendly and efficient manner. The app utilizes Firebase for authentication, realtime database management, and storage of pet images. It also incorporates SQLite for local data storage, ensuring smooth offline functionality.

## Features

- **User Authentication**: Secure login and registration using Firebase Authentication.

- **Pet Listings**: Users can post pets for adoption with details and images.

- **Pet Search and Adoption**: Search for pets based on location, type, and other criteria for adoption.

- **Realtime Updates**: Updates on available pets and adoption statuses through Firebase Realtime Database.

- **Modern Design**: Intuitive user interface with a focus on usability and aesthetics.

## Technologies Used

- Java

- XML

- Firebase (Authentication, Realtime Database, Storage)

- SQLite

- Android SDK

- Material Design

## Installation

1. Clone the repository:

```bash

git clone https://github.com/FirasKahlaoui/we-rescue.git

cd we-rescue

```

2. Set up Firebase:

   - Create a new Firebase project in the Firebase console.

   - Add your Android app to the Firebase project.

   - Download the `google-services.json` file and place it in the `app/` directory of your Android project.

3. Build and run the app on an Android device or emulator.

## Usage

- Register or log in to your account using Firebase Authentication.

- Navigate through the app to view available pets for adoption.

- Post your pet for adoption with details and images.

- Search for pets based on location, type, and other filters.

- Communicate with other users regarding pet adoption inquiries.

## Contributing

Contributions are welcome! Fork the repository and submit pull requests for any enhancements or bug fixes. Please discuss major changes through issues before making modifications.

## License

This project is licensed under the MIT License.