## Voluny- iOS App for the 2018 IEEEmadC Mobile Application Development Contest

Voluny is a quick, easy and simple volunteering app that is tailored specifically for volunteers who love to help out their community as well as to recruiters, who are seeking for volunteers for their organizations. ## The Bay Area Team We consist of 2 team members that make this wonderful app happen: Uyen Vicky Vo as the UIUX designer and [Marton Zeisler](https://github.com/Marton-Zeisler) as the programmer. We came up with the idea together and have been working hard on Voluny starting from scratch. We use Photoshop, Illustrator, and Sketch for UIUX designing and Xcode/Swift for developing. In addition, Firebase, Google APIs (Geocoding & Places API) was being used for the back-end development. ## Installation Guidelines There are two ways to test Voluny: - This repository contains an executable .ipa file in the ipa folder. In order to install and run this file you need to have a jailbroken iPhone. Download the .ipa file using this link: [Download Voluny.ipa](https://drive.google.com/uc?export=download&id=1zHikbY5PuwYGUCoc4V14TX5YO0BnkTfu) - Another way to install Voluny is by inviting me to an Apple developer account and allowing me to upload the application to Testflight. TestFlight is Apple's online service for testing mobile applications but it is only possible with paid Apple developer accounts. An Apple developer account costs 99 dollars per year. ## User accounts for testing The following volunteer and recruiter accounts have been created for testing purposes. Please use them to test Voluny. - Password for all accounts: 123456 - Volunteer accounts: user1@user1.com, user2@user2.com, user3@user.com, user4@user4.com, user5@user5.com, user6@user6.com, user7@user7.com, user8@user8.com, user9@user9.com user10@user10.com - Recruiter accounts for New Delhi: ind1@ind1.com, ind2@ind2.com, ind3@ind3.com - Recruiter accounts for Budapest: bp1@bp1.com, bp2@bp2.com, bp3@bp3.com, bp4@bp4.com, bp6@bp6.com - Recruiter accounts for San Francisco: sf1@sf1.com, sf2@sf2.com, sf4@sf4.com, sf5@sf5.com ## Promotional Video We created a promotional video and uploaded it to Youtube. Please click on the image to watch our video:[![Watch our video](https://raw.githubusercontent.com/Marton-Zeisler/Voluny/master/ReadMe-Images/VolunyYouTube.jpg)](https://www.youtube.com/watch?v=Zy44ONV4ASs) ## Description

“Alone, we can do so little; together, we can do so much” – Helen Keller. We believe in the power of people. You and I, as individuals, do great things. But did you know that we do greater things when we come together. If I ask anyone, “Do you like helping people?”, the morality answer is always, “Yes”. Of course, everyone wants to help everyone else. Do you have the time? Yes. Do you have the will? Yes. Do you care about your community? Yes. But really, do you have the patience to sit for hours on your computer? To search on countless websites for volunteer experiences? To apply through a long chain of emails only to find out that the time doesn’t work for you? Yeah, we don’t think so. That’s where Voluny comes in and solves this problem.

So… what’s our goal? Our goal is simple, just like how we want our app to be, because let’s be real, finding volunteer experiences should not be painful or stressful or take up your whole day. We don’t believe in making users sign up or commit to anything until they find what they are looking for. We want the user experience to be seamless. We want them to focus on just one thing that matters: looking for the volunteer opportunities they love.

As the volunteer, the decision is all yours. Apply to 1, 2 or 10 experiences you want. No one is stopping you. We can’t. You can join, search, and apply for volunteer experiences within a few minutes. In addition, we created a variety of categories including Children, Pets, Homeless, Education and more. It is important that we let you have the flexibility to choose your cause and the volunteer experiences you wish to apply–giving total control to you.

The other goal of Voluny is to make the user experience seamless, without any confusion. We care about your experience, that’s why it’s important for us to design a seamless UX management tool that only shows you what you want to know. After you apply, you can easily keep track of your applications to see if you are a good match to what the organization is looking for, receive all the information you need to start without having to contact back and forth with the organizations.

To ensure that everyone has the best experience, we also created a rating system to help you express yourself. The ratings will be seen by everyone and will help future volunteers to understand more about the experience they had with the organization and easily decide where they want to volunteer next.

We understand that as a recruiter, you already have enough things to worry about. With our app as the recruiter, who represents the organization, you can post new volunteer experiences within minutes without complicated hassles. The recruiter can manage current or past listings through the recruiter portal.

Our intention is to make things quick and simple. It is important that making decision should not take away your precious time. That’s why we make it simple for you to decide if the candidate is a good match by simply clicking “Accept” or “Decline” after you preview their information. With our easy managing tool, you will be able to edit, delete or modify your listing, as well as having an overview of your volunteer experience.

With user-friendly and elegant UI, this quick and easy to use app should be a go-to Volunteer app for everyone. Volunteering made simple, that’s our goal. Let’s volunteer together! ## Screenshots

## Disclaimer Voluny is a product designed and developed by Marton Zeisler and Uyen Vicky Vo. All photos used in the app or promotional collaterals are open-source and royalty free from Unsplash.com. ## License MIT License Copyright (c) 2018 Marton Zeisler Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.