SimplySecure - macOS Cyber Defense Platform

By Eshwar Desetty

A professional macOS desktop application that performs comprehensive cyber defense scans and provides actionable recommendations for securing your MacBook. Features a premium dark cybersecurity-themed UI with advanced app permission management and threat detection capabilities.

Features

• Security Scanning: Checks OS updates, FileVault encryption, and Safari security settings
• App Permission Management: Real-time monitoring and management of app permissions with AI-powered privacy analysis
• Collapsible Permission Cards: Clean, expandable cards for each app with smooth animations
• Comprehensive Analysis: Multiple security checks with detailed reporting
• AI Assistant: Google Gemini integration for AI-powered security insights and privacy policy analysis
• Phishing Simulation: Retell AI integration for phishing call awareness training
• Premium Dark UI: Professional cybersecurity-themed interface with cyan/blue accents
• Apple-Style Animations: 3-second smooth animations throughout the app
• Real-time Results: Instant feedback on security status with actionable fixes
• Permission Overlay: Automatic detection of new app installations with permission analysis

Recent Updates

UI/UX Enhancements (October 2025 - Latest)

• Clean, Minimal Dashboard: Removed clutter, focusing on core functionality

  • Removed security score banner and progress bars
  • Clean header with only essential elements
  • Scan button prominently displayed at the top
  • 3-second Apple-style fade-in animations

• Collapsible App Permission Cards: Modern dropdown interface

  • Apps start collapsed showing only essential info
  • Click to expand for full details
  • Smooth 3-second animations
  • Chevron indicator rotates on expansion
  • Permission details and AI analysis hidden until expanded

• Contextual Statistics: Smart visibility of stats

  • System Status only shows when tracking is active
  • Permission Statistics appear with 3-second animation
  • Synchronized animations across sidebar and main content
  • Clean interface when tracking is disabled

• Refined Button Colors: Better visual hierarchy

  • "Rescan Apps" button in green (positive action)
  • "Stop Tracking" button in red (warning action)
  • Buttons hidden when tracking is inactive

Previous UI/UX Enhancements

• Premium Dark Theme: Complete redesign with cybersecurity-themed dark UI

  • Dark gradient backgrounds (Color(red: 0.05, green: 0.08, blue: 0.12))
  • Cyan/blue accent colors throughout the application
  • Enhanced shadows and glows for depth
  • Consistent design language across all views

• Login Page Redesign: Updated login interface to match post-login UI

  • Dark cybersecurity background with gradient overlays
  • Cyan/blue themed shield logo with glow effects
  • "CYBER DEFENSE" branding with tracking
  • Premium form styling with dark input fields
  • Cyan/blue gradient "SECURE LOGIN" button
  • Consistent color scheme with main application

• App Permission Management: Comprehensive permission tracking system

  • Real-time monitoring of new app installations
  • Automatic permission analysis for installed apps
  • AI-powered privacy risk assessment
  • Simple explanations for non-technical users
  • Visual permission chips with risk level indicators
  • Enable/disable monitoring toggle

Key Technologies

• SwiftUI: Modern declarative UI framework with premium 3-second animations
• Privacy policy analysis using Perplexity deep research: Advanced app privacy analysis and policy research
• Real-time App Monitoring: Automatic detection of new app installations with permission analysis
• Apple-Style UX: Smooth, elegant animations inspired by Apple.com
• Contextual UI: Smart visibility of components based on user actions

Requirements

• macOS Ventura (13.0) or later
• Xcode 14.0 or later
• Admin privileges for some security checks
• Google Gemini API key (optional, for AI features)
• Retell AI API key (optional, for phishing simulation)

Setup Instructions

1. Open in Xcode:

   open SimplySecure.xcodeproj

2. Configure Project:

   • Set deployment target to macOS 13.0+
   • Ensure "Hardened Runtime" is enabled in Build Settings
   • Add "Allow Execution of JIT-compiled Code" entitlement if needed

3. Configure APIs (Optional):

   # Gemini AI for AI Assistant
   ./setup_gemini.sh
   export GEMINI_API_KEY='your_api_key_here'
   
   # Retell AI for Phishing Simulation
   ./setup_retell.sh
   export RETELL_API_KEY='your_api_key_here'

4. Build and Run:

   • Press Cmd + R to build and run
   • The app will appear in a single window

Security Checks

OS Updates (40 points)

• Uses softwareupdate --list to check for pending updates
• Provides option to run softwareupdate -i -a for updates

FileVault Encryption (30 points)

• Uses fdesetup status to verify encryption is enabled
• Guides users to System Settings for manual configuration

Safari Security (20 points)

• Checks Safari's privacy settings and update status
• Provides instructions for enabling tracking protection

AI Assistant (Gemini Integration)

The app includes a Google Gemini-powered AI assistant that can:

• Explain cybersecurity concepts in simple terms
• Provide personalized security recommendations
• Answer questions about macOS security features
• Generate security awareness content

Getting Started with AI Features

1. Get a free API key from Google AI Studio
2. Set your API key: export GEMINI_API_KEY='your_key_here'
3. Navigate to the "AI Assistant" tab in the app
4. Start asking security-related questions!

Phishing Call Simulation (Retell AI Integration)

The app includes a phishing call simulation feature powered by Retell AI that can:

• Create realistic outbound calls for security awareness training
• Generate full call transcriptions with detailed analysis
• Log all call data using NSLog for security analysis
• Provide insights into call sentiment, topics, and key points

Getting Started with Phishing Simulation

1. Get an API key from Retell AI
2. Run the setup script: ./setup_retell.sh
3. Navigate to the "Phishing Sim" tab in the app
4. Enter phone numbers in E.164 format (e.g., +1234567890)
5. Click "Start Phishing Call Simulation" to begin

How It Works

1. Create Call: Initiates an outbound call using Retell AI API
2. Wait for Completion: Polls the API every 5 seconds for call completion
3. Fetch Transcription: Retrieves the full call transcript when available
4. Log Results: All transcription data is logged using NSLog for analysis

The simulation provides comprehensive logging including:

• Call ID and status
• Full conversation transcript
• Call summary and analysis
• Sentiment analysis
• Key topics and points discussed

Security Assessment System

Security Scoring

• Excellent (120-140 points): All security checks passed
• Good (100-119 points): Most security checks passed with minor issues
• Needs Attention (60-99 points): Several security issues detected
• Critical (0-59 points): Multiple serious security vulnerabilities

Comprehensive Reporting

• Detailed analysis of each security check
• Actionable recommendations for fixing issues
• Progress tracking with visual indicators

Project Structure

SimplySecure/
├── SimplySecure/
│   ├── SimplySecureApp.swift         # Main app entry point
│   ├── ContentView.swift             # Main UI with cybersecurity-themed dashboard
│   ├── LoginView.swift               # Premium dark-themed login interface
│   ├── SecurityScanner.swift         # Security scan logic
│   ├── AppPermissionService.swift    # App permission monitoring service
│   ├── AppPermissionsView.swift      # Permission management UI
│   ├── PermissionOverlayView.swift   # Permission overlay for new apps
│   ├── AppPermissionModels.swift     # Data models for permissions
│   ├── QuizView.swift                # Interactive security quiz
│   ├── QuizService.swift             # Quiz generation service
│   ├── QuizModels.swift              # Quiz data models
│   ├── QuizAnimations.swift          # Quiz UI animations
│   ├── GeminiAPIService.swift        # Google Gemini API integration
│   ├── RetellAIService.swift         # Retell AI API integration
│   ├── PerplexityService.swift       # Perplexity API for privacy analysis
│   ├── PrivacyPolicyAnalyzer.swift   # Privacy policy analysis
│   ├── VideoPlayerView.swift         # Video playback
│   ├── VideoScreen.swift             # Video screen management
│   ├── WelcomeAnimationView.swift    # Welcome screen animations
│   ├── Assets.xcassets              # App icons and assets
│   ├── Info.plist                   # App configuration
│   └── SimplySecure.entitlements     # App permissions
├── SimplySecure.xcodeproj           # Xcode project file
├── setup_gemini.sh                  # Gemini API setup script
├── setup_retell.sh                  # Retell AI API setup script
├── setup_perplexity.sh              # Perplexity API setup script
├── setup_keys.sh                    # All API keys setup script
└── README.md                        # This file

Usage

1. Login - Use the premium dark-themed login page (default: admin/admin)
2. Watch Welcome Video - Optional intro video on first login
3. Dashboard - View system security status with cybersecurity-themed interface
4. Run Security Scan - Click the "Run Security Scan" button
5. Review Results - See your security score and detailed analysis
6. App Permissions - Monitor and manage app permissions in real-time
   • Enable app tracking to monitor new installations
   • Review permission requests with AI-powered analysis
   • Get simple explanations of privacy risks
7. Security Quiz - Take AI-generated quizzes to test your knowledge
8. Fix Issues - Follow recommendations to resolve security issues
9. Ask AI Assistant - Use the Gemini-powered AI for security insights
10. Simulate Phishing - Test security awareness with realistic call simulations

Technical Details

• SwiftUI: Modern declarative UI framework
• Process: Native macOS shell command execution
• UserDefaults: Persistent configuration and security data storage
• Async/Await: Non-blocking security scans
• URLSession: HTTP networking for Gemini API calls
• Combine: Reactive programming for API responses

Permissions

The app may request admin privileges for:

• Running softwareupdate commands
• Checking FileVault status with fdesetup
• Accessing Safari preferences

Troubleshooting

Build Issues (Updated Oct 23, 2025)

If you encounter DerivedData permission errors:

# Use this custom build command instead
cd "/Users/apple/Project Unknown/SimplySecure"
xcodebuild -project SimplySecure.xcodeproj -scheme SimplySecure -configuration Release clean build CONFIGURATION_BUILD_DIR="$(pwd)/ReleaseOutput"
open "./ReleaseOutput/SimplySecure.app"

See BUILD_REFERENCE.md for detailed build troubleshooting.

Scan Failures

• Ensure you have admin privileges
• Check that Terminal commands work manually
• Some checks may fail in sandboxed environments

General Build Issues

• Verify macOS deployment target is 13.0+
• Check that all Swift files are included in target
• Ensure proper code signing if distributing
• For detailed build guide, see .cursor/build-and-run-guide.md

Demo Mode

For demonstrations:

1. Show the initial cyber defense scan results
2. Demonstrate fixing a security vulnerability
3. Show the threat detection capabilities
4. Highlight the cyber defense dashboard UI

Future Enhancements

• Network security and intrusion detection
• Additional browser support and protection
• Advanced threat intelligence integration
• Automated security fix execution
• Behavioral threat analysis

---

Screenshots

Premium cybersecurity interface with advanced threat detection and professional security scanning capabilities.

Built with Advanced Cyber Defense Technology by Eshwar Desetty 🔒