🛡️ SafeStep – Stay Safe, Live Free

Empowering Women with Real-Time Protection, Safety, and Support.

---

🌟 Overview

SafeStep is an AI-powered personal safety and emergency response mobile application designed to empower women and ensure real-time protection in critical situations.
It enables users to send instant SOS alerts, share live location, access safety routes, and connect with trusted contacts or nearby emergency services.

---

🚀 Key Features

• 🆘 One-Tap SOS – Instantly send alerts with live location to emergency contacts.
• 📍 Real-Time Tracking – Share your live location with trusted guardians.
• 🤖 AI Safety Bot – AI-powered agent chatbot for instant guidance.
• 📞 Emergency Hotlines – Direct access to local police, ambulance, and help lines.
• 🤚 Shake Activation – Trigger SOS without unlocking your phone.
• 🎭 Fake Call – Simulate an incoming call to escape uncomfortable situations.
• 🔒 Privacy First – End-to-end encryption for all sensitive user data.

---

🧠 How It Works

1. User Registration & Setup

   • Register phone number and add trusted contacts.

2. Trigger SOS

   • Press the SMS shortcut button or send a keyword (e.g., HELP).

3. Location Fetch & SMS Delivery

   • System retrieves the user’s GPS location.
   • Generates a Google Maps link.
   • Sends an SMS to trusted contacts via MSpace API.

4. Fake Call

   • Trigger a fake incoming call to escape uncomfortable situations.

5. Privacy & Security

   • All data shared only with authorized contacts.
   • No unnecessary data collection.

---

💻 Tech Stack

Category	Technologies
Frontend (Mobile)	Flutter, Dart
Backend	Firebase, Firestore, Firebase Authentication
APIs & Services	MSpace API, Google Maps API
Version Control	Git & GitHub

---

📡 Links

• SafeStep Introduction Website GitHub: https://github.com/ThasuniInduma/safestep
• Demo Video on YouTube: https://www.youtube.com/embed/9OXSl0eOqj8

---

📲 Screenshots

Create Profile	Share Location	Fake Call Simulation
Report Danger Zone & Safe Chat	Share Location without App	SOS Alert

---

⚙️ Installation & Setup

1. Clone the Repository

   git clone https://github.com/budd9442/SafeStep.git
   cd safestep

2. Configure Secrets ⚠️

   Firebase Setup:

   • Go to Firebase Console
   • Download google-services.json → place in android/app/
   • Download service account JSON → save as backend/service.json
   • Install FlutterFire CLI: dart pub global activate flutterfire_cli
   • Run: flutterfire configure (generates lib/firebase_options.dart)

   API Keys:

   • Get Gemini API key → create .env file:

     GEMINI_API_KEY=your_api_key_here

   • Get Google Maps API key → update android/app/src/main/AndroidManifest.xml:

     <meta-data android:name="com.google.android.geo.API_KEY" android:value="YOUR_KEY" />

   Backend Environment:

   • Create backend/.env with Firebase credentials and MSpace config
   • Use backend/.env.example as template

   📖 Full guide: SECRETS_SETUP.md

3. Install Dependencies

   flutter pub get
   cd backend && npm install

4. Run the App

   flutter run

---

SafeStep is more than just a safety tool — it is a lifeline for anyone, anywhere, providing instant location sharing and emergency alerts via SMS.
By combining simplicity, accessibility, and privacy, it ensures that personal safety is never compromised, even without a smartphone or internet connection.

With SafeStep, we take a step forward in empowering communities and saving lives.

💜 Team DevMates 💜