PrivarionGUI

Imported from yunusgungor/privarion (Sources/PrivarionGUI/AGENTS.md). Install upstream with npx skills add yunusgungor/privarion --skill PrivarionGUI. Copyright stays with the author.

PrivarionGUI

SwiftUI application using Clean Architecture pattern.

OVERVIEW

macOS GUI for privacy management. 15+ SwiftUI views with MVVM + Clean Architecture.

STRUCTURE

Sources/PrivarionGUI/
├── BusinessLogic/
│   ├── AppState.swift           # Global state (868 lines)
│   ├── ViewModels/              # View models
│   ├── Interactors/             # Business logic
│   └── Search/                  # Search functionality
├── Presentation/
│   └── Views/
│       ├── ContentView.swift    # Main navigation
│       ├── DashboardView.swift  # Status overview
│       ├── MacAddressView.swift
│       ├── NetworkFilteringView.swift
│       ├── TemporaryPermissionsView.swift  # 1107 lines
│       ├── AdvancedPreferencesView.swift   # 700 lines
│       ├── SecondaryViews.swift            # 688 lines
│       └── Components/          # Reusable components
└── DataAccess/
    └── Repositories/            # Data layer

WHERE TO LOOK

CONVENTIONS

• @StateObject / @Observable for state
• Clean Architecture: BusinessLogic → Presentation → DataAccess
• MVVM for all views
• @ViewBuilder for conditional content

ANTI-PATTERNS

• CRITICAL: AppState.switchProfile force unwrap causes crashes
• 24 TODOs across GUI - unimplemented features
• Large views: TemporaryPermissionsView (1107 lines), AdvancedPreferencesView (700 lines)
• DON'T use ! - use if let / guard

LARGE FILES (Refactor Targets)