Repository files navigation

SOS App is a cross-platform app that allows the user to send an SOS message with their location to a saved phone number in times of distress.

• Themain branch contains the.NET MAUI 6 project used to build the app that gets the coordinates of the phone through the.NET MAUI Essentials Geolocation API and call the SOSAppwrite Function.

• Theappwrite-function branch contains theAppwrite Function that reverse geocodes the coordinates to get the address from theRadar Geocoding API and usesTwilio Programmable Message to send an SOS message to predecided number.

• Setup an Appwrite instance, create a new admin account and a new project
  • Enable the.NET 6.0 runtime for Appwrite Functions (check the note below)
• Install the Appwrite CLI and login with your Appwrite credentials
• Create an account onTwilio, obtain your Twilio Account SID and Auth Token from your Twilio console, and await a Phone Number (using thisguide)
• Create an account onRadar and grab an API key (Test secret(server) should be fine)
• Visit the SOS Appwrite Function Readme in theappwrite-function branch for more details on setting up and deploying the function
  • Visit the SOS Function's Settings page and addExecute Access forany role

Note: In order to enable the .NET runtime for Appwrite Functions, you need to update the.env file in the Appwrite installation folder. Find the file and adddotnet-6.0 to the comma-separated list in the environment variable_APP_FUNCTIONS_RUNTIMES. This will make the .NET runtime available in Appwrite Functions. You can then load the updated configuration using thedocker-compose up -d command.

• Install latest version ofVisual Studio 2022 with the.NET Multi-platform App UI development workload (Reference)
• Clone this repo
• Open theSOS\ folder and run the following command

  dotnet restore

• Visit theSOS\Constants folder and create a classAppwriteConstants.cs as follows:

  namespaceSOS.Constants{publicstaticclassAppwriteConstants{publicconststringAppwriteUrl="<Enter Appwrite API Endpoint>";publicconststringProjectId="<Enter Appwrite Project Id>";publicconststringFunctionId="<Enter Appwrite Function Id>";}}

• Build your app and deploy it to your preferred mobile platform (Reference)

Thanks to Freepik for themenu,settings, andsos icons used in the flyout menu in the app