FirstAide-iOS

Introduction

FirstAide-iOS is an iOS app developed in swift

Peace Corps is committed to providing a compassionate and supportive response to all Volunteers who have been sexually assaulted. To that end, the Peace Corps makes the following commitment to our Volunteers who are victims of sexual assault.

This project is to support the initiative by creating a mobile app that PCVs can readily have accessible to report or gain information on Peace Corps Safety and Security procedures.

Watch a video walkthrough of this app here

You can learn more about the Systers organization, whose members work on the development of this app here and join our mailing list here

Getting Started

Update to XCode 8.0 or above

###Installation: Go to your terminal and execute this command

$ git clone https://github.com/systers/FirstAide-iOS.git

Or download the ZIP file from above Also you can clone the git repository through XCode

Navigate to FirstAide directory (within your cloned directory) via the terminal and execute

$ pod install

If pod is not setup in your Mac OS X, install cocoapods [cocoapods] (https://guides.cocoapods.org/using/getting-started.html)

###Opening and Running

1. Launch XCode
2. Click on open another project
3. Browse to the directory where you cloned (extracted the zip) FirstAide/ and open workspace file
4. Let XCode to open the project and build.
5. If building process finishes select a device or a simulator like iPhone 6 to launch.
6. Wait for a few seconds and the app should start on your device(iOS device or simulator)

Documentation

Latest documentation for FirstAide can be found here

Contributing

If you want to contribute to FirstAide-iOS, subscribe to our systers-dev mailing list and shoot an introductory email. Pick an open issue from the issue list taged "free", claim it in the comments, fix the issue and send us a pull request. If you find an issue yourself you can report it, a community member will get back to you and approve the issue. Then you can fix it and submit a PR. Please go through our issue list first and make sure the issues you are reporting do not replicate the issues already reported. If you have issues on multiple pages, report them separately. Do not combine them into a single issue.

Avoid doing the following mistakes

1. Fix a new issue and submit a PR without reporting and getting it approved at first.
2. Fix an issue assigned to somebody else and submit a PR before the assignee does.
3. Report issues which are previously reported by others. (Please check the closed issues too before you report an issue).
4. Suggest completely new developments in the issue list. (Please use the mailing list for this kind of suggestions. Use issue list to suggest bugs/features in the already implemented sections.)

Best Practices

1. Issue Reporting Best Practices
2. [PR Best Practices] (https://github.com/systers/FirstAide-Android/wiki/PR-Best-Practices)

Troubleshooting/Issues

If there are any other questions or concerns, please contact the Systers contributors.