Skip to content

ojhaprathmesh/Stray_Haven_Repo

Repository files navigation

🐾 Stray Haven

Stray Haven is an Android application built to bridge the gap between rescuers, NGOs, and animal lovers. The app allows users to report stray animals in need, donate to verified NGOs for their treatment, and adopt rescued animals-creating a smoother rescue-to-care ecosystem.


✨ Features

  • 🚨 Report and Rescue: Users can report stray animals in distress.
  • 💰 NGO Fundraising: NGOs can receive donations for treatment and care.
  • 🏠 Adoption Portal: Allows users to adopt stray animals through the app.
  • 🔔 Notifications: Get real-time updates on adoption, donations, or rescue status.
  • 👤 Profile Management: Users can edit their profile and view history.
  • 🔒 Secure Authentication: Integrated with Firebase Authentication & Google Sign-In.

⚙️ Tech Stack

  • Language: Java
  • Build System: Gradle Kotlin DSL (build.gradle.kts)
  • UI: Material Design, ViewPager2, RecyclerView, ConstraintLayout
  • Firebase Services:
    • Firebase Authentication
    • Firebase Firestore
  • Google Sign-In Integration

📱 Minimum Requirements

  • Min SDK: 28
  • Target SDK: 35
  • Java Version: 11
  • Android Studio: Flamingo or newer recommended

🚀 Getting Started

1. Clone the Repository

git clone https://github.com/ojhaprathmesh/Stray_Haven_Repo.git

2. Open in Android Studio

  • Open Android Studio.
  • Click "Open an existing project".
  • Navigate to the cloned folder.
  • Let Gradle sync (internet required).

3. Run the App

  • Connect an Android device or use an emulator.
  • Click on Run > Run 'app' or press Shift + F10.

📂 Project Structure Overview

StrayHaven/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/app/main/activity/
│   │   │   ├── res/
│   │   │   └── AndroidManifest.xml
│   ├── build.gradle.kts
├── build.gradle.kts
└── README.md

🤝 Contributing

Pull requests and feature suggestions are welcome! If you find bugs or issues, feel free to open an issue.


📄 License

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


Contributors ✨

Thanks goes to these wonderful people:

Prathmesh Ojha
Prathmesh Ojha

💻
Vaishnavi Singh
Vaishnavi Singh

💻
Anuj Pratap
Anuj Pratap

💻
Jhankar Bansal
Jhankar Bansal

💻
Ayush Singh
Ayush Singh

💻

About

Android app bridging rescuers, NGOs, and adopters — report stray animals, donate to verified NGOs, and adopt rescued pets. Built with Java, Firebase, and Material Design 3.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages