How zqxwce/vphone-ws works
vPhone Workstation is a native macOS front end for vphone-cli. Users browse and inspect virtual iPhones, check host readiness, create VMs with selected variants and firmware, and manage or launch existing VMs. The graph separates the SwiftUI screens, application wiring, VM lifecycle and host checks, and the command/task infrastructure. Some subsystem links are based on the SOURCE INDEX or README rather than full excerpts; unsampled implementation details are not inferred.
Main entry points: AppEnvironment.swift Service Wiring · VPhoneCLIClient.swift CLI Client · LibraryView.swift VM Library · CreateWizardView.swift Create Wizard
Components 31
macOS Interface
- App Entry
Sources/vphone-ws/App.swift - VM Library
Sources/vphone-ws/Views/LibraryView.swift - Create Wizard
Sources/vphone-ws/Views/CreateWizardView.swift - VM Details
Sources/vphone-ws/Views/VMDetailView.swift - VM Settings
Sources/vphone-ws/Views/SettingsSheet.swift - Task Progress
Sources/vphone-ws/Views/TaskProgressViews.swift - Readiness Sheet
Sources/vphone-ws/Views/HostReadinessSheet.swift - UI Theme
Sources/vphone-ws/Theme.swift
Application Services
- Service Wiring
Sources/VPhoneWSCore/Store/AppEnvironment.swift
VM Lifecycle
- VM Store
Sources/VPhoneWSCore/Store/VMStore.swift - VM Row Model
Sources/VPhoneWSCore/Store/VMRow.swift - VM Report
Sources/VPhoneWSCore/Models/VMReport.swift - Launch Coordinator
Sources/VPhoneWSCore/Lifecycle/LaunchCoordinator.swift - Running State Probe
Sources/VPhoneWSCore/State/RunningStateProbe.swift - Variant Store
Sources/VPhoneWSCore/Variant/VariantStore.swift - Firmware Catalog
Sources/VPhoneWSCore/Models/FirmwareCatalog.swift - Process Launcher
Sources/VPhoneWSCore/Process/ProcessLauncher.swift
CLI and Tasks
- CLI Client
Sources/VPhoneWSCore/CLI/VPhoneCLIClient.swift - VM Management
Sources/VPhoneWSCore/CLI/VPhoneCLIClient+Manage.swift - CLI Locator
Sources/VPhoneWSCore/CLI/VPhoneCLILocator.swift - CLI Runner
Sources/VPhoneWSCore/Process/CLIRunner.swift - System CLI Runner
Sources/VPhoneWSCore/Process/SystemCLIRunner.swift - Streaming Runner
Sources/VPhoneWSCore/Process/StreamingRunner.swift - Task Center
Sources/VPhoneWSCore/Tasks/TaskCenter.swift - Task Model
Sources/VPhoneWSCore/Tasks/TaskModel.swift - Stage Parser
Sources/VPhoneWSCore/Tasks/StageParser.swift - Command Builder
Sources/VPhoneWSCore/Tasks/VPhoneCommandBuilder.swift
Host Readiness
- Host Checks
Sources/VPhoneWSCore/Host/HostReadiness.swift - Check Result
Sources/VPhoneWSCore/Host/HostCheck.swift
Other components
- User
- vphone-cli
Connections 48
- User → App Entry: opens
Sources/vphone-ws/App.swift - App Entry → VM Library: shows
Sources/vphone-ws/App.swift - App Entry → Service Wiring: builds services
Sources/vphone-ws/App.swift - VM Library → VM Store: refreshes
Sources/vphone-ws/Views/LibraryView.swift - VM Library → Host Checks: checks readiness
Sources/vphone-ws/Views/LibraryView.swift - VM Library → Launch Coordinator: launches VMs
Sources/vphone-ws/Views/LibraryView.swift - VM Library → VM Details: shows selection
Sources/vphone-ws/Views/LibraryView.swift - VM Library → Create Wizard: opens wizard
Sources/vphone-ws/Views/LibraryView.swift - VM Library → Readiness Sheet: presents checks
Sources/vphone-ws/Views/LibraryView.swift - VM Library → Task Center: starts import
Sources/vphone-ws/Views/LibraryView.swift - VM Details → CLI Client: manages VMs
Sources/vphone-ws/Views/VMDetailView.swift - VM Details → Launch Coordinator: stops VM
Sources/vphone-ws/Views/VMDetailView.swift - VM Details → Task Center: starts export
Sources/vphone-ws/Views/VMDetailView.swift - VM Details → Command Builder: builds export args
Sources/vphone-ws/Views/VMDetailView.swift - VM Details → VM Settings: presents settings
Sources/vphone-ws/Views/VMDetailView.swift - Create Wizard → CLI Client: fetches catalog
Sources/vphone-ws/Views/CreateWizardView.swift - Create Wizard → Command Builder: builds create args
Sources/vphone-ws/Views/CreateWizardView.swift - Create Wizard → Task Center: starts creation
Sources/vphone-ws/Views/CreateWizardView.swift - Create Wizard → Variant Store: saves variant
Sources/vphone-ws/Views/CreateWizardView.swift - Create Wizard → Firmware Catalog: selects pairing
Sources/vphone-ws/Views/CreateWizardView.swift - Task Progress → Task Model: renders progress
Sources/vphone-ws/Views/TaskProgressViews.swift - Readiness Sheet → Host Checks: displays checks
Sources/vphone-ws/Views/HostReadinessSheet.swift - VM Library → UI Theme: uses styles
Sources/vphone-ws/Views/LibraryView.swift - Service Wiring → VM Store: constructs
Sources/VPhoneWSCore/Store/AppEnvironment.swift - Service Wiring → Launch Coordinator: constructs
Sources/VPhoneWSCore/Store/AppEnvironment.swift - Service Wiring → CLI Client: constructs
Sources/VPhoneWSCore/Store/AppEnvironment.swift - Service Wiring → Host Checks: constructs
Sources/VPhoneWSCore/Store/AppEnvironment.swift - Service Wiring → Task Center: constructs
Sources/VPhoneWSCore/Store/AppEnvironment.swift - Service Wiring → Command Builder: constructs
Sources/VPhoneWSCore/Store/AppEnvironment.swift - Service Wiring → Variant Store: constructs
Sources/VPhoneWSCore/Store/AppEnvironment.swift - Service Wiring → CLI Locator: locates CLI
Sources/VPhoneWSCore/Store/AppEnvironment.swift - Service Wiring → System CLI Runner: configures runner
Sources/VPhoneWSCore/Store/AppEnvironment.swift - VM Store → CLI Client: loads VM reports
Sources/VPhoneWSCore/Store/VMStore.swift - VM Store → Running State Probe: checks running state
Sources/VPhoneWSCore/Store/VMStore.swift - VM Store → VM Row Model: creates rows
Sources/VPhoneWSCore/Store/VMStore.swift - VM Row Model → VM Report: wraps report
Sources/VPhoneWSCore/Store/VMRow.swift - CLI Client → CLI Runner: executes commands
Sources/VPhoneWSCore/CLI/VPhoneCLIClient.swift - CLI Client → VM Report: decodes reports
Sources/VPhoneWSCore/CLI/VPhoneCLIClient.swift - CLI Client → Firmware Catalog: decodes catalog
Sources/VPhoneWSCore/CLI/VPhoneCLIClient.swift - CLI Client → vphone-cli: invokes
Sources/VPhoneWSCore/CLI/VPhoneCLIClient.swift - VM Management → CLI Client: extends commands
Sources/VPhoneWSCore/CLI/VPhoneCLIClient+Manage.swift - Host Checks → CLI Locator: locates CLI
Sources/VPhoneWSCore/Host/HostReadiness.swift - Host Checks → CLI Runner: runs host checks
Sources/VPhoneWSCore/Host/HostReadiness.swift - Host Checks → Check Result: returns results
Sources/VPhoneWSCore/Host/HostReadiness.swift - System CLI Runner → CLI Runner: implements
Sources/VPhoneWSCore/Process/SystemCLIRunner.swift - Launch Coordinator → Process Launcher: launches process
Sources/VPhoneWSCore/Lifecycle/LaunchCoordinator.swift - Launch Coordinator → CLI Client: stops VM
Sources/VPhoneWSCore/Lifecycle/LaunchCoordinator.swift - Launch Coordinator → Running State Probe: checks process
Sources/VPhoneWSCore/Lifecycle/LaunchCoordinator.swift