🎉 Welcome! Thank you for visiting our page!

"Guardianess" is a mobile application (iOS and Android compatible) created by 4 passionate female engineering students to elevate women's safety. In our personal experience, we did not feel particularly safe on the streets of San Francisco, US. There is no application with centralized information about safety and tangible sources on where to go in a dangerous situation.

In an emergency scenario, one is likely to panic and feel frightened. The application provides a sense of assurance when navigating through the streets, provides a tangible sense of security, and potentially could save lives in an emergency.

Submitted to Black Wings Hack 2024 as a team Illusion of Greatness -- DevPost

Contributed by Alina, Erela, Ivanna, & Polina with 💗.

Table of Contents

• Demo of the application
• User Story
• How to use our application
• User Flows
• Project Timeline
• Future Directions
• Appendix and FAQ

Here is the link to Demo.

Below are some pictures from mobile application.

Feature: Check how safe a location is

  Scenario: User wants to visit a new location
    Given I'm a logged-in User
    When I go to the Main page
    And I search for a location
    Then I see the safety score of the location
    And receive advice on safety measures

Feature: See a safety ranking of the neighborhoods

    Given I'm a logged-in User
    When I go to the Main page
    The app shows how safe each neighborhood is, the darker the color, the more dangerous it is.

Feature: Send an emergency signal to chosen contacts

  Scenario: User is in a dangerous situation
    Given I'm a logged-in User
    When I go to the Main page
    And I click "Emergency" for 3 seconds
    Then my chosen contacts are notified about an emergency 
    with my geolocation  
    And I receive directions to the closest safe place

Feature: Find the closest safe location

  Scenario: User feels unsafe
    Given I'm a logged-in User
    When I go to the Main page
    And I click on any of the bookmarked safe places
    Then the app calculates the route
    And I see the route information on Google Maps

Follow the following 5 steps to try our application.

1. Clone our repository git clone <url>
2. npm install to install dependencies
3. Install ExpoGo from App Store/Play Market
4. Runnpx expo start to build the app
5. Scan the QR code with a camera (iOS) or ExpoGo (Android)

In the following user flows, we show

• the user registration process (Numbered 1-4)
• 3 features
  • A: Safety level check upon location search
  • B: Emergency button press
  • C: Check the route to the closest safe spot when you're in danger

sequenceDiagram
User->>OUR APP: 1. Register App

Note right of OUR APP: 2. Store user info & emergency contacts

OUR APP->>User: 3. Ask location sharing

User ->>OUR APP: 4. Share Location

User-->> OUR APP: A.Check the safety of the area

Note right of OUR APP: (Render Google Map)

User-->> OUR APP: B1. Press Emergency Button

OUR APP-->>User: B2. Notify contacts with geolocation

User-->> OUR APP: C1. Check routes to the safe spot nearby

OUR APP-->>Google Map: C2. Redirect users to directions

The times provided are in GMT.

gantt
    dateFormat YYYY-MM-DD HH:mm
     axisFormat %I%p

Brainstorm Ideas: milestone, m1, 2024-02-02 21:00, 1m

Start Hacking: milestone, m1, 2024-02-03 11:00, 1m
section Frontend
    User authentication :fr, 2024-02-03 11:00, 2024-02-03 14:00
    Map :fr2, 2024-02-03 13:00, 2024-02-03 22:00

    section Backend
    Location Sharing :ba, 2024-02-03 13:00, 2024-02-03 15:00
    Map Interaction :ba2, 2024-02-03 14:00, 2024-02-03 23:00
    Map Shading :ba3, 2024-02-03 19:00, 2024-02-03 23:00
    Map Routing :ba4, 2024-02-03 22:00, 2024-02-04 00:00
    Location Search :ba5, 2024-02-03 23:00, 2024-02-04 03:00

Final Submission: milestone, m1, 2024-02-04 16:00, 1m

If we have more time to develop, here are some features we find meaningful to implement on top of the current version.

• Expansion to more cities across the US and beyond
• Community features
• Widget on mobile devices to activate the nearest safe location search
• Call a car-sharing application/taxi to pick you up when you're in danger
• Motion tracker empowered by Machine Learning

ℹ️ For the Safety ratings displayed on our application we are using Safe Places API. Their scores come from GeoSure GeoSafeScores, which are (1) updated regularly and (2) based on a variety of sources, data science methods, and surveys of locals residing in the areas. You can read more about GeoSafeScores here.

Find this document incomplete? Leave a comment!