π‘οΈ AI-powered safety platform for women and girls in Kenya. Features real-time threat detection, emergency response, and comprehensive safety tools.
# π‘οΈ HerShield Safeguard Kenya
> A comprehensive AI-powered safety platform designed to protect women and girls in Kenya through advanced threat detection, emergency response systems, and community support networks.
## π Quick Start
**π¨ One-Command Setup:**
```bash
# Initialize database (first time only)
node init-database.js
# Start everything
./start-hershield.sh
```
**π± Access the Application:**
- **Frontend**:
localhost
- **Backend API**:
localhost
- **MongoDB**: mongodb://localhost:27017/hershield
## π― Key Features
### π§ AI-Powered Safety Features (NEW!)
- **Message Analyzer**: Real-time threat detection in messages and emails
- **Safety Advisor**: Personalized safety advice and risk assessments
- **Emergency Center**: AI-powered emergency response coordination
- **Quick Safety Tests**: Pre-built scenarios for testing AI capabilities
### π‘οΈ Core Safety Features
- **Dashboard**: Comprehensive safety metrics and insights
- **Emergency Button**: One-click emergency alerts with location sharing
- **Threat Reporting**: Community-driven incident reporting system
- **Safety Resources**: Kenya-specific emergency contacts and support services
- **User Authentication**: Secure user profiles and data protection
### π°πͺ Kenya-Specific Integration
- **Emergency Services**: Direct integration with Kenya Police (911, 999)
- **Local Support**: Gender Violence Recovery Centre, NGEC, Childline Kenya
- **Cultural Context**: Understanding of local safety challenges and solutions
- **County Coverage**: Support for all 47 Kenyan counties
## π± Mobile Compatibility
HerShield is fully **mobile-responsive** and works seamlessly on:
- β
Android devices (all versions)
- β
iOS devices (iPhone/iPad)
- β
Desktop browsers
- β
Progressive Web App (PWA) capabilities
## ποΈ Architecture
### Frontend
- **React 18** with TypeScript
- **Tailwind CSS** + **shadcn/ui** components
- **Vite** for fast development and builds
- **Progressive Web App** capabilities β¦