EmihleMaxengana/purple-safety

App built to minimize GBV is South Africa. # Purple Safety Purple Safety is a Flutter mobile application providing personal safety features such as emergency alerts, contact management, location sharing, and safety tools. It supports Android and iOS and includes platform-specific native code and integrations for Firebase and device services. ## Features - Emergency alerts and incident reporting - Manage emergency contacts and next-of-kin - Location sharing and live map view - Biometric / fingerprint setup for secure access - Integration with Firebase (Auth, Firestore, Messaging) ## Prerequisites - Flutter SDK (recommended >= 3.0) - Android SDK / Android Studio for Android builds - Xcode for iOS builds (macOS only) - A Firebase project for your app (you'll add platform-specific config files) ## Getting Started 1. Clone the repository: ```bash git clone github.com cd purple-safety ``` 2. Install dependencies: ```bash flutter pub get ``` 3. Add platform Firebase config files (detailed steps below). 4. Run on an emulator or device: ```bash flutter run ``` ## Detailed Firebase Setup Follow these steps to connect the app to Firebase and enable required services. 1. Create a Firebase project - Visit and create a new project. 2. Add Android app in Firebase - Register package name (match `applicationId` in `android/app/build.gradle.kts`). - Add a nickname (optional). - Add debug and release SHA-1 keys (important for authentication and Google Sign-In): ```bash # Get debug SHA-1 keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android ``` - Download `google-services.json` and place it at `android/app/google-services.json` (or `android/app/`). - Update `android/build.gradle.kts` and `android/app/build.gradle.kts` as required by Firebase Android setup (the project already includes Gradle KTS files; follow Firebase console instructions if needed). 3. Android permissions and setup - Ensure require …