chewtoys / animavita

Trigger life-saving alerts, register animals for adoption and find the closest pet friend to adopt :dog:

A minimal, clean and beautiful mobile app to help people find the closest pet friend to adopt, rescue lives and change the world.

"How to save a life?" - The Fray

Why • Roadmap • Tech Stack • Contributing • License • About Me

         

😊 Why?

Animavita is a combination of two Latin words, ‘Animal’ and ‘Vitae’, which means respectively ‘Animal’ and ‘Life’. This is an idea to create or animate something that was born a while ago, when I realized that facebook is used to publicize adoption and also ask for help for animals that lives on the streets.

Animavita's purpose is not to change how people use facebook to the activities described above, but to centralize the helpful information in a single application. Anyone can make an adoption request, but it doesn’t mean that the pet will be automatically adopted. It means that the person interested can talk to the person who registered the pet, allowing both sides to have a conversation, and the user to research and decide his favorite pet.

💫 Roadmap

Check the Roadmap to more details about itens below.

• Rescue system (WIP)
• Write CONTRIBUTING.md + Install instructions
• Make it work on IOS
• Write tests in backend
• Write tests in frontend
• Transform into responsive
• Create Landing Page
• i18n
• Offline-first
• Create/Apply Dataloaders
• Update to latest React Native version

Install instructions

Getting Started

1) Clone & Install Dependencies

• 1.1) git clone https://github.com/wendelfreitas/animavita
• 1.2) cd animavita - cd into your newly created project directory.
• 1.3) Install NPM packages with yarn install Note: NPM has issues with React Native so yarn is recommended over npm.
• 1.4) [iOS] cd ios and run pod install - if you don't have CocoaPods you can follow these instructions to install it.
• 1.5) [Android] If you haven't already generated a debug.keystore file you will need to complete this step from within the /android/app folder. Run keytool -genkey -v -keystore debug.keystore -storepass android -alias androiddebugkey -keypass android -keyalg RSA -keysize 2048 -validity 10000

2) Start your app

• 2.1) [iOS] Build and run the iOS app, run react-native run-ios (to run on simulator) or react-native run-ios --device (to run on real device) from the root of your project. The first build will take some time.
• 2.2) [Android] If you haven't already got an android device attached/emulator running then you'll need to get one running (make sure the emulator is with Google Play / APIs). When ready run react-native run-android from the root of your project.

⚡ Tech Stack

• Facebook Login
• React Native
• Styled Components
• Reactotron
• Eslint
• Redux
• MongoDB
• Formik + Yup
• Apollo
• GraphQL
• Kraken
• OneSignal
• AWS
• Redux-Persist

and much more...

🤝 Contributing

This project is for study purposes too, so send me an email telling me what you are doing and why you are doing it, teach me what you know

All kinds of contributions are very welcome and appreciated!

• ⭐️ Star the project
• 🐛 Find and report issues
• 📥 Submit PRs to help solve issues or add features
• ✋ Influence the future of Animavita with feature requests

And make sure to read the Contributing Guide before making a pull request.

You can also contribute money to help secure Animavita's future.

🎩 License

For more details read License

Copyright (c) 2019 Wendel de Freitas Branco

🎨 About Me

Linkedin - @wendelfb
Twitter - @hey_wendelzinho
E-mail - [email protected]