hibakhalidm/Kinga

Kinga (Swahili for Protection) is a 'Safety by Design' PWA built for the 16 Days of Activism. Recognizing that Ethiopian girls facing digital violence often live in monitored homes, Kinga operates in 'Stealth Mode,' disguised as a calculator app. # Kinga (Living Safety Ecosystem) ### 🛡️ A Digital Safety Sanctuary for Ethiopian Women & Girls **Tracks:** Safety by Design | Survivor Support | Digital Literacy **Target:** Adolescent Girls (10-24) in Ethiopia ## 🚨 The Problem In Ethiopia, digital violence is rising on Telegram and Facebook, yet 80% of adolescent girls lack the tools to report it safely. Existing platforms are not anonymous, leading to victim-blaming and re-traumatization. ## 💡 The Solution: Kinga Kinga ("Protection" in Swahili) is a **PWA (Progressive Web App)** that acts as a disguised crisis responder. It has been upgraded into a "Living Safety Ecosystem" that adapts to real-time threats. ### 🔑 Key Features 1. **Stealth Mode (Calculator Disguise)** * Appears as a fully functional calculator. * Unlocks via a custom PIN (e.g., `1616=`). 2. **Universal Panic System** * **Shake-to-Exit** or Double-ESC key instantly redirects to Google. 3. **Living Dashboard ("Pulse" Engine)** * Analyzes user sentiment ("How are you feeling?") to detect crises. * Fetches **Real-Time Threat Data** (e.g., "New Telegram Phishing Scam") to provide context-aware alerts. 4. **Anonymous Community Chat** * Secure, real-time group chat for survivors. * Powered by Supabase Realtime with strict privacy (RLS). 5. **Offline-First LMS** * Safety guides available even without internet. * Dynamic updates when online. 6. **Admin Portal** (`/admin`) * Heatmap visualization of community threats. * CMS for managing safety guides. ## 🛠️ Tech Stack * **Frontend:** React.js, Vite, Tailwind CSS, Framer Motion * **Backend:** Supabase (Auth, Postgres, Realtime) * **Logic:** Custom Sentiment Analysis Engine (`LogicEngine.js`) * **Scripts:** Node.js Pulse Aggregator ## 🚀 Getting Started ### Prerequisites * Node.js & npm * Supabase Account ### Installation 1. Clone the repo: ```bash git clone github.com ``` 2. Install dependencies: ```bash npm install ``` 3. Set up …