feat(mac): new configuration and installation UI 🍎

mac/Config/Config.xcodeproj/project.pbxproj

@@ -33,6 +33,23 @@
 		D88F03DD2F50ED5100C02A31 /* ConfigUITests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = ConfigUITests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
 /* End PBXFileReference section */
 
+/* Begin PBXFileSystemSynchronizedBuildFileExceptionSet section */
+		375D21122FF2F21800FCD24A /* Exceptions for "Config" folder in "Config" target */ = {
+			isa = PBXFileSystemSynchronizedBuildFileExceptionSet;
+			membershipExceptions = (
+				ConfigTests/ConfigTests.swift,
+			);
+			target = D88F03C52F50ED5000C02A31 /* Config */;
+		};
+		375D21132FF2F21800FCD24A /* Exceptions for "Config" folder in "ConfigTests" target */ = {
+			isa = PBXFileSystemSynchronizedBuildFileExceptionSet;
+			membershipExceptions = (
+				ConfigTests/ConfigTests.swift,
+			);
+			target = D88F03D22F50ED5100C02A31 /* ConfigTests */;
+		};
+/* End PBXFileSystemSynchronizedBuildFileExceptionSet section */
+
 /* Begin PBXFileSystemSynchronizedRootGroup section */
 		D87D6F492FAF95400083A95E /* Installation */ = {
 			isa = PBXFileSystemSynchronizedRootGroup;
@@ -41,14 +58,13 @@
 		};
 		D88F03C82F50ED5000C02A31 /* Config */ = {
 			isa = PBXFileSystemSynchronizedRootGroup;
+			exceptions = (
+				375D21122FF2F21800FCD24A /* Exceptions for "Config" folder in "Config" target */,
+				375D21132FF2F21800FCD24A /* Exceptions for "Config" folder in "ConfigTests" target */,
+			);
 			path = Config;
 			sourceTree = "<group>";
 		};
-		D88F03D62F50ED5100C02A31 /* ConfigTests */ = {
-			isa = PBXFileSystemSynchronizedRootGroup;
-			path = ConfigTests;
-			sourceTree = "<group>";
-		};
 		D88F03E02F50ED5100C02A31 /* ConfigUITests */ = {
 			isa = PBXFileSystemSynchronizedRootGroup;
 			path = ConfigUITests;
@@ -87,7 +103,6 @@
 			children = (
 				D87D6F492FAF95400083A95E /* Installation */,
 				D88F03C82F50ED5000C02A31 /* Config */,
-				D88F03D62F50ED5100C02A31 /* ConfigTests */,
 				D88F03E02F50ED5100C02A31 /* ConfigUITests */,
 				D88F04022F512FE800C02A31 /* Frameworks */,
 				D88F03C72F50ED5000C02A31 /* Products */,
@@ -151,9 +166,6 @@
 			dependencies = (
 				D88F03D52F50ED5100C02A31 /* PBXTargetDependency */,
 			);
-			fileSystemSynchronizedGroups = (
-				D88F03D62F50ED5100C02A31 /* ConfigTests */,
-			);
 			name = ConfigTests;
 			packageProductDependencies = (
 			);
@@ -416,7 +428,7 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
-				ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
+				ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = "";
 				CODE_SIGN_ENTITLEMENTS = Config/ConfigDebug.entitlements;
 				"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Mac Developer";
 				CODE_SIGN_STYLE = Manual;
@@ -455,7 +467,7 @@
 			isa = XCBuildConfiguration;
 			buildSettings = {
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
-				ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
+				ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = "";
 				CODE_SIGN_ENTITLEMENTS = Config/ConfigRelease.entitlements;
 				"CODE_SIGN_IDENTITY[sdk=macosx*]" = "Developer ID Application";
 				CODE_SIGN_STYLE = Manual;

mac/Config/Config/Assets.xcassets/AppIcon.appiconset/Contents.json

@@ -26,7 +26,6 @@
       "size" : "128x128"
     },
     {
-      "filename" : "Keyman-256.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "128x128"
@@ -47,6 +46,7 @@
       "size" : "512x512"
     },
     {
+      "filename" : "keyman-1024.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "512x512"

mac/Config/Config/Assets.xcassets/accessibility-permission.imageset/Contents.json

@@ -0,0 +1,22 @@
+{
+  "images" : [
+    {
+      "filename" : "accessibility-permission-light.pdf",
+      "idiom" : "universal"
+    },
+    {
+      "appearances" : [
+        {
+          "appearance" : "luminosity",
+          "value" : "dark"
+        }
+      ],
+      "filename" : "accessibility-permission-dark.pdf",
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

mac/Config/Config/Assets.xcassets/enable-Keyman.imageset/Contents.json

@@ -0,0 +1,22 @@
+{
+  "images" : [
+    {
+      "filename" : "enable-keyman-light.pdf",
+      "idiom" : "universal"
+    },
+    {
+      "appearances" : [
+        {
+          "appearance" : "luminosity",
+          "value" : "dark"
+        }
+      ],
+      "filename" : "enable-keyman-dark.pdf",
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

mac/Config/Config/Assets.xcassets/keyman-logo.imageset/Contents.json

@@ -0,0 +1,25 @@
+{
+  "images" : [
+    {
+      "filename" : "keyman-logo-light.png",
+      "idiom" : "universal"
+    },
+    {
+      "appearances" : [
+        {
+          "appearance" : "luminosity",
+          "value" : "dark"
+        }
+      ],
+      "filename" : "keyman-logo-dark.png",
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  },
+  "properties" : {
+    "preserves-vector-representation" : true
+  }
+}

mac/Config/Config/ConfigApp.swift

@@ -16,6 +16,23 @@ struct ConfigApp: App {
   @Environment(\.openWindow) private var openWindow
 
   var body: some Scene {
+    Window("Configuration", id: "main-config") {
+      MainConfigView()
+        .environmentObject(settings)
+        .task {
+          if !installation.getHasDisplayedInstallationComplete() {
+            openWindow(id: "install")
+          }
+        }
+        .onReceive(NotificationCenter.default.publisher(for: .installationRepairStarted)) { notification in openWindow(id: "install")
+        }
+    }
+    Window("Installation", id: "install") {
+      MainInstallView()
+        .environmentObject(installation)
+    }
+    .windowResizability(.contentSize)
+    .defaultSize(width: 600, height: 500)
     Window("Config Test", id: "config-debug") {
       ConfigDebugView()
         .environmentObject(settings)

mac/Config/Config/ConfigDebugView.swift

@@ -21,9 +21,6 @@ struct ConfigDebugView: View {
           .foregroundColor(.accentColor)
         Text("multiple keyboard package count = \(settings.multiKeyboardPackages.count)")
         Text("single keyboard package count = \(settings.singleKeyboardPackages.count)")
-        Button("debug") {
-          settings.debug()
-        }
         Button("log defaults") {
           settings.logUserDefaults()
         }
@@ -50,22 +47,6 @@ struct ConfigDebugView: View {
           ForEach(Array(settings.singleKeyboardPackages.enumerated()), id: \.offset) { index, package in
             VStack {
               HStack(alignment: .center, spacing: 10) {
-                VStack(spacing: 16) {
-                    Text("Scan to visit website:")
-                        .font(.headline)
-
-                  if let qrImage = package.generateSharePackageQRCode(size: 200) {
-                        Image(nsImage: qrImage)
-                            .interpolation(.none) // important: keeps the QR edges sharp
-                            .resizable()
-                            .frame(width: 200, height: 200)
-                            .background(Color.white) // ensures good scanning contrast
-                    } else {
-                        Text("Failed to generate QR Code")
-                            .foregroundColor(.red)
-                    }
-                }
-                .padding()
                 Text(package.packageName)
                   .font(.headline)
                 Text(package.packageVersion)

mac/Config/Config/HelpView.swift

@@ -0,0 +1,34 @@
+/*
+ * Keyman is copyright (C) SIL Global. MIT License.
+ *
+ * Created by Gabriel Schantz on 2026-08-03
+ *
+ * Webview used to show help for Keyman keyboards
+ */
+import Foundation
+
+import SwiftUI
+import WebKit
+import KeymanSettings
+
+public struct HelpView: NSViewRepresentable {
+  let helpFileURL: URL
+
+  // create the AppKit view instance
+  public func makeNSView(context: Context) -> WKWebView {
+    let webView = WKWebView()
+    return webView
+  }
+
+  // update the view when SwiftUI state changes
+  public func updateNSView(_ nsView: WKWebView, context: Context) {
+    let request = URLRequest(url: helpFileURL)
+
+    // only load the request if it's not already loading/loaded to prevent infinite loops
+    if nsView.url != helpFileURL {
+      if let helpUrl = request.url {
+        nsView.loadFileURL(helpUrl, allowingReadAccessTo: helpUrl.deletingLastPathComponent())
+      }
+    }
+  }
+}

mac/Config/Config/IconButtonView.swift

@@ -0,0 +1,46 @@
+/*
+ * Keyman is copyright (C) SIL Global. MIT License.
+ *
+ * Created by Gabriel Schantz on 2026-07-03
+ *
+ * The view used for image-only buttons
+ */
+
+import SwiftUI
+
+public struct IconButtonView: View {
+  let action: () -> Void
+  let systemImage: String
+  let font: Font
+  let helpText: String
+
+  public var body: some View {
+
+    Button {
+      action()
+    } label: {
+      Image(systemName: systemImage)
+        .font(font)
+    }
+    .buttonStyle(.plain)
+    .accessibilityLabel(helpText)
+    .help(helpText)
+
+  }
+}
+
+// the view for buttons with a label
+public struct LabelButtonView: View {
+  let action: () -> Void
+  let label: String
+  let systemImage: String
+  let font: Font
+
+  public var body: some View {
+    Button(action: action) {
+      Label(label, systemImage: systemImage)
+        .font(font)
+    }
+    .buttonStyle(.bordered)
+  }
+}

mac/Config/Config/InstallationViews/CompletedInstallView.swift

@@ -0,0 +1,44 @@
+/*
+ * Keyman is copyright (C) SIL Global. MIT License.
+ *
+ * Created by Eli Schantz on 2026-07-01
+ *
+ * View used for notifying the user that installation is complete.
+ */
+
+import SwiftUI
+
+struct CompletedInstallView: View {
+  @EnvironmentObject var installation: InstallationContainer
+  let namespace: Namespace.ID
+
+  var versionText: String {
+    if let version = installation.installationState?.keymanVersion {
+      return "Version: \(version)"
+    } else {
+      return "No version to display"
+    }
+  }
+
+  var body: some View {
+    VStack {
+
+      Spacer()
+
+      KeymanLogo(namespace: namespace)
+      Text(versionText)
+        .foregroundStyle(.secondary)
+
+      Spacer()
+
+      GradientDivider(namespace: namespace)
+        .padding(.bottom, 8)
+      HStack {
+        Text("Installation complete")
+          .font(.title2)
+          .frame(maxWidth: .infinity, alignment: .leading)
+        NavigationButton(action: .dismiss)
+      }
+    }
+  }
+}