CxWebApp/swift-app/README.md

CxWebAppMac

Native macOS SwiftUI shell that wraps the CxWebApp C++/Crow backend in a WKWebView with proper window chrome, menu commands, health monitoring, and configurable backend URL.

Build & run

cd swift-app
make build         # swift build -c release
make run           # launches a SwiftUI window
make test          # runs AppSettingsTests
make app           # produces build/CxWebAppMac.app

Override the backend at launch:

CXWEBAPP_URL=https://cxwebapp.76-13-126-127.nip.io swift run -c release CxWebAppMac

Layout

swift-app/
├── Package.swift
├── Makefile
├── README.md
├── scripts/
│   └── build-app.sh                  # SPM bin → .app bundle
├── Sources/CxWebAppMac/
│   ├── CxWebAppMacApp.swift          # @main, WindowGroup + Settings scene
│   ├── ContentView.swift             # toolbar + WebView + status bar
│   ├── WebView.swift                 # WKWebView NSViewRepresentable
│   ├── SettingsView.swift            # backend URL, presets, devtools toggle
│   ├── AppSettings.swift             # persisted preferences
│   └── HealthMonitor.swift           # polls /api/health
└── Tests/CxWebAppMacTests/
    └── AppSettingsTests.swift

Commands (⌘ shortcuts)

• ⌘R — reload
• ⌘[ / ⌘] — back / forward
• ⇧⌘H — home
• ⇧⌘C — copy URL
• ⇧⌘O — open in default browser
• ⌘, — Settings (backend URL, presets, developer extras)