From 68910d5d5d88471178e06bb4633a82f4ae3db1d0 Mon Sep 17 00:00:00 2001
From: MaitryS07 <maitrysantoshwar07@gmail.com>
Date: Mon, 16 Feb 2026 18:12:46 +0530
Subject: [PATCH] Add Raksha SafeHer README

---
 submissions/CodeEcho_Raksha.md | 201 +++++++++++++++++++++++++++++++++
 1 file changed, 201 insertions(+)
 create mode 100644 submissions/CodeEcho_Raksha.md

diff --git a/submissions/CodeEcho_Raksha.md b/submissions/CodeEcho_Raksha.md
new file mode 100644
index 0000000..18a289c
--- /dev/null
+++ b/submissions/CodeEcho_Raksha.md
@@ -0,0 +1,201 @@
+<h1 align="center">
+  <a href="https://github.com/MaitryS07/Raksha-Safeher">
+    Raksha-Safeher
+  </a>
+  <br>
+  Women Safety Application – Smart SOS & Emergency Support
+</h1>
+
+<div align="center">
+By Team SafeHer
+</div>
+<hr>
+
+<details>
+<summary>Table of Contents</summary>
+
+- [Description](#description)
+- [Links](#links)
+- [Tech Stack](#tech-stack)
+
+- [Progress](#progress)
+- [Future Scope](#future-scope)
+- [Applications](#applications)
+- [Project Setup](#project-setup)
+- [Team Members](#team-members)
+- [Mentors](#mentors)
+
+</details>
+
+---
+
+## 📝 Description
+
+**Raksha-Safeher** is a women-safety mobile application designed to provide instant emergency support through a **one-tap SOS alert**, **live location sharing**, and **trusted contacts notifications**.  
+The app helps users register, authenticate securely, manage SOS contacts, and quickly send alerts during unsafe situations.  
+Its goal is to offer real-time assistance, fast communication, and enhanced personal safety using modern technologies.
+
+---
+
+## 🔗 Links
+
+- **GitHub Repository:** https://github.com/MaitryS07/Raksha-Safeher  
+- **Demo Video:** _Coming Soon_  
+- **Screenshots Folder:** _To be added_  
+- **Hosted Website:** _Not hosted yet_
+
+---
+
+## 🤖 Tech-Stack
+
+### **Front-end**
+- Flutter (Android / iOS support)
+
+### **Backend**
+- Flask  
+- JWT Authentication  
+
+### **Utilities / APIs**
+- Twilio API (for SMS sending & emergency calling)  
+- MobileBERT (Transformer model for safety-based predictions)
+
+### **Database**
+- MySQL / SQL-based storage
+
+---
+
+## 🏗️ System Architecture
+
+```mermaid
+graph LR
+    A[User] --> B[Flutter App]
+    B --> C[JWT Authentication Module]
+    C --> D[Flask Backend Server / API]
+    B --> E[Geolocation Service]
+    E --> F[Live Location Tracking]
+    B --> G[Local Storage]
+    G --> H[SQL Database]
+```
+
+---
+
+## 📈 Progress
+
+### ✔️ Fully Implemented Features
+
+- **User Registration & Login**  
+  Secure authentication using OTP + JWT.
+
+- **Live Location Tracking**  
+  Geolocation-based real-time coordinate tracking.
+
+- **One-Tap SOS Button**  
+  Instantly alerts trusted contacts through APIs.
+
+- (this system  supports only python 3.11 version and is not supported by the latest version)
+
+---
+
+## 🚧 Partially Implemented Features / Work in Progress
+
+- Still working on how can we make the app run in background 
+- App needs multilingual support  
+- Safety routes feature is still under development  
+
+---
+
+## 🔮 Future Scope
+
+- AI-based behavioral threat detection  
+- Auto-dial nearest women helpline / police  
+- Chatbot for safety instructions  
+- Multi-language support  
+- iOS app release (Flutter cross-platform)  
+- Offline emergency alert system  
+
+---
+
+## 💸 Applications
+
+- **Women Safety & Emergency Response:**  
+  Instant alerts during unsafe situations.
+
+- **Location-Based Assistance:**  
+  Helps friends, family, or authorities track user's location.
+
+- **College & Corporate Safety Programs:**  
+  Useful for institutions committed to women's safety.
+
+---
+
+## 🛠 Project Setup
+
+### 1️⃣ Clone the Repository
+
+```bash
+git clone https://github.com/MaitryS07/Raksha-Safeher
+```
+
+---
+
+### 2️⃣ Open the Project
+
+- Open in **VS Code** or **Android Studio**
+- Ensure **Flutter SDK** is installed
+- Run:
+
+```bash
+flutter pub get
+```
+
+---
+
+### 3️⃣ Run the App
+
+```bash
+flutter run
+```
+
+---
+
+### 4️⃣ Configure Backend (Flask)
+
+**Install dependencies:**
+
+```bash
+pip install -r requirements.txt
+```
+
+**Start the Flask server:**
+
+```bash
+python app.py
+```
+
+---
+
+### 5️⃣ Configure APIs
+
+- Set **Twilio API Keys**
+- Configure **JWT backend URL**
+- Ensure **location permissions** are enabled
+
+---
+
+## 👨‍💻 Team Members
+
+- Maitry Santoshwar – https://github.com/MaitryS07
+
+- Abhay Munnjewar - https://github.com/AbhayMunjewar
+
+- Vardhan Mali - https://github.com/vardhan01mali
+
+- Samiksha Chaudhari - https://github.com/Samii2116
+
+---
+
+## 👨‍🏫 Mentors
+
+- Ronit Chaube
+
+- Om Mukharjee