AI-powered mobile security app that protects users from digital threats in real-time.

ThreatSense provides comprehensive protection against digital threats through AI-powered analysis, real-time monitoring, and emergency notification systems.

• Live Text Analyzer - Paste any text for instant threat analysis using Perplexity AI
• Sentry Mode - Emergency notifications to trusted contacts
• Related Content - AI-generated articles about similar threats using Gemini AI
• URL Safety Scanner - Checks links against Google Safe Browsing
• Real-time AI Analysis - Powered by Perplexity AI for threat detection and Gemini AI for content generation
• Privacy-Focused - Local processing when possible

For detailed system diagrams and technical documentation:

• 📊 System Architecture - Complete system overview and data flow
• 🛡️ Sentry Mode Flow - Emergency notification system
• 🤖 AI Components - AI technology stack and analysis
• 📈 Performance Metrics - System performance and capabilities
• 📱 User Interface Flow - UI/UX flows and user journey

• Frontend: React Native
• Backend: Node.js
• AI: Perplexity AI (threat analysis), Gemini AI (content generation)
• Security: Google Safe Browsing, SSL validation
• Storage: AsyncStorage, local data persistence

• Primary Threat Analysis: Analyzes text for phishing, social engineering, and malware patterns
• Real-time Intelligence: Provides current threat data and cybersecurity expertise
• Structured Output: Returns threat level, detailed analysis, and actionable recommendations

• Query Generation: Creates search queries from threat analysis for finding related content
• Content Enhancement: Generates contextual search terms for better article discovery
• Natural Language Processing: Uses Google's Gemini 1.5 Flash model for advanced text understanding

Note: Make sure you have completed the React Native Environment Setup before proceeding.

• Node.js (v16 or later)
• React Native CLI
• Xcode (for iOS development)
• Android Studio (for Android development)

1. Clone the repository

   git clone <repository-url>
   cd tsv3

2. Install dependencies

   npm install
   # OR
   yarn install

3. iOS Setup (macOS only)

   cd ios
   bundle install
   bundle exec pod install
   cd ..

4. Start Metro

   npm start
   # OR
   yarn start

5. Run the app

   # iOS
   npm run ios
   # OR
   yarn ios
   
   # Android
   npm run android
   # OR
   yarn android

For comprehensive documentation, see the docs/ directory:

• 📚 Documentation Overview - Complete documentation index
• 🔧 Development Guide - Setup and development instructions
• 👥 User Guide - End-user documentation
• 🔌 API Documentation - Backend API specifications

Please read our contributing guidelines before submitting pull requests.

This project is licensed under the MIT License - see the LICENSE file for details.