ScDor / CommuniDog

A social app for guide dogs foster families

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

CommuniDog

Description:

CommuniDog is an app that provides services based on location to foster families to guide dogs. The app allows to publish a service (sharing food, medicines and dog-sitting) and contact the people offer the services. All the users must be approved by the community center for foster dogs.

Notes for open-source contributers:

  • This project is under the MIT License
  • The app is written in Android Studio using Java - Supported from API level 16 and more.
  • We are using Firebase platform to restore all relevant data about users and app data.
  • The map service is Open-Street Map Package
  • The app requires an internet connection to work properly and it is recommended to activate GPS connection as well.
  • every change in the code, requires a proper and well documented pull request.

improvements and future goals:

small extensions-

  • profile pictures
  • photos album in profile pages

big extensions-

  • trainings schedule planner
  • direct messages between users
  • finding partners for dog gardens (something like sending notifications for the closest users)

feel free to add whatever you like, we will be happy to see what you have thought of.

instructions for installation the app:

  • Install Android Studio: https://developer.android.com/studio/install.
  • Clone this github repository: git clone https://github.com/IdoSagiv/CommuniDog.git
  • Open the project via android studio.
  • Make sure to sync the 'build.gradle' files (in the app folder and in the main folder).
  • You can choose to run the app on your phone or on an emulator that has an android os.
  • For best results, we recommend running the app on your own android phone, or if not possible use pixel 3 emulator
  • If you have any problem during the installation, see Q&A page

instructions for running the app:

  • In your first use you must register. You need to enter a valid Id.
  • Find your dog's service!

About

A social app for guide dogs foster families

License:MIT License


Languages

Language:Java 100.0%