feat(ios): harden SimDeck Studio streaming

Author: DjDeveloperr

README.md

@@ -68,6 +68,17 @@ simdeck "iPhone 17 Pro Max"
 
 The served loopback browser UI receives the generated API access token automatically.
 LAN clients should pair with the printed code before receiving the API cookie.
+For native iOS pairing, run:
+
+```sh
+simdeck pair
+```
+
+This starts or refreshes the global LaunchAgent-backed SimDeck service, prints
+local, LAN, and Tailscale URLs when available, and shows a QR code with a
+`simdeck://pair` link. The QR contains the pairing code plus all detected
+non-loopback addresses, so pairing once can save both the LAN and Tailscale
+routes with the same service token.
 
 CLI commands automatically use the same warm daemon:
 

cli/XCWChromeRenderer.m

@@ -289,8 +289,6 @@ + (nullable NSData *)screenMaskPNGDataForDeviceName:(NSString *)deviceName
     BOOL hasModernPhoneSensor = [self shouldRenderPhoneChromeFromSlices:plist sensorName:sensorName];
     BOOL hasComposite = !hasModernPhoneSensor && [self compositeAssetPathForChromeInfo:chromeInfo].length > 0;
     CGFloat screenScale = MAX([self numberValue:plist[@"mainScreenScale"]], 1.0);
-    CGFloat profileScreenWidth = [self numberValue:plist[@"mainScreenWidth"]];
-    CGFloat profileScreenHeight = [self numberValue:plist[@"mainScreenHeight"]];
     CGSize profileScreenSize = [self screenSizeForChromeInfo:chromeInfo
                                                    chromeSize:compositeSize
                                                   screenScale:screenScale];
@@ -301,17 +299,17 @@ + (nullable NSData *)screenMaskPNGDataForDeviceName:(NSString *)deviceName
     CGFloat screenHeight;
     CGFloat screenX;
     CGFloat screenY;
-    if (hasComposite && pointScreenWidth > 0.0 && pointScreenHeight > 0.0) {
+    if (watchProfile) {
+        screenX = sizingLeft;
+        screenY = sizingTop;
+        screenWidth = MAX(compositeSize.width - sizingLeft - sizingRight, 1.0);
+        screenHeight = MAX(compositeSize.height - standHeight - sizingTop - sizingBottom, 1.0);
+    } else if (hasComposite && pointScreenWidth > 0.0 && pointScreenHeight > 0.0) {
         screenWidth = pointScreenWidth;
         screenHeight = pointScreenHeight;
         screenX = MAX((compositeSize.width - screenWidth) / 2.0, 0.0);
         CGFloat usableHeight = compositeSize.height - standHeight;
         screenY = MAX((usableHeight - screenHeight) / 2.0, bezelTop);
-    } else if (watchProfile) {
-        screenWidth = profileScreenWidth;
-        screenHeight = profileScreenHeight;
-        screenX = MAX((compositeSize.width - screenWidth) / 2.0, 0.0);
-        screenY = MAX((compositeSize.height - screenHeight) / 2.0, 0.0);
     } else {
         screenX = bezelLeft;
         screenY = bezelTop;
@@ -320,7 +318,7 @@ + (nullable NSData *)screenMaskPNGDataForDeviceName:(NSString *)deviceName
     }
 
     CGFloat innerRadius = MAX(rawCornerRadius - MAX(screenX, screenY), 0.0);
-    CGFloat radiusScale = pointScreenWidth > 0.0 ? screenWidth / pointScreenWidth : 1.0;
+    CGFloat radiusScale = !watchProfile && pointScreenWidth > 0.0 ? screenWidth / pointScreenWidth : 1.0;
     CGFloat chromeCornerRadius = innerRadius * radiusScale;
     CGFloat cornerRadius = chromeCornerRadius;
 

client/package-lock.json

@@ -904,7 +904,7 @@ export function AppShell({
     ? buildChromeUrl(
         selectedSimulator.udid,
         chromeAssetStamp,
-        !chromeHasInteractiveButtons || chromeHasCrown,
+        !chromeHasInteractiveButtons,
       )
     : "";
   const chromeButtonUrl = useCallback(

client/src/app/AppShell.tsx

@@ -12,6 +12,7 @@ Replace `simdeck` with `./build/simdeck` when running from a source checkout.
 | `simdeck -k`                     | Stop the detached project daemon            |
 | `simdeck -r`                     | Restart the detached project daemon         |
 | `simdeck ui --open`              | Open the browser UI from a daemon           |
+| `simdeck pair`                   | Show native iOS pairing code and QR         |
 | `simdeck daemon status`          | Show daemon URL, PID, token, and log path   |
 | `simdeck daemon stop`            | Stop the current project daemon             |
 | `simdeck daemon killall`         | Stop all project daemons                    |
@@ -22,9 +23,15 @@ Examples:
 ```sh
 simdeck ui --port 4320 --open
 simdeck ui --open
+simdeck pair
 simdeck daemon restart --video-codec software --stream-quality low
 ```
 
+`simdeck pair` uses the global LaunchAgent-backed service instead of a
+project-local daemon. It binds the service for LAN access, preserves an existing
+service token and pairing code when present, detects LAN and Tailscale IPv4
+addresses, and prints a `simdeck://pair` QR for the native iOS app.
+
 ## Device Lifecycle
 
 ```sh

docs/cli/commands.md

@@ -189,12 +189,18 @@ Start SimDeck with a LAN bind and reachable advertised host:
 simdeck ui --bind 0.0.0.0 --advertise-host 192.168.1.50 --open
 ```
 
+For native iOS pairing, prefer:
+
+```sh
+simdeck pair
+```
+
 Then check:
 
 - The remote browser opens `http://192.168.1.50:4310`.
 - macOS Firewall allows the port.
-- The pairing code matches the current daemon.
-- API scripts send the daemon token.
+- The pairing code matches the current daemon or global service.
+- API scripts send the daemon or service token.
 
 See [LAN Access](/guide/lan-access).
 

docs/guide/troubleshooting.md

@@ -363,7 +363,7 @@
 					ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 					CODE_SIGN_ENTITLEMENTS = SimDeckStudio/SimDeckStudio.entitlements;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 1;
+				CURRENT_PROJECT_VERSION = 202605170407;
 				DEVELOPMENT_ASSET_PATHS = "";
 					DEVELOPMENT_TEAM = CS838V553Y;
 				ENABLE_PREVIEWS = YES;
@@ -392,7 +392,7 @@
 					ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 					CODE_SIGN_ENTITLEMENTS = SimDeckStudio/SimDeckStudio.entitlements;
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 1;
+				CURRENT_PROJECT_VERSION = 202605170407;
 				DEVELOPMENT_ASSET_PATHS = "";
 					DEVELOPMENT_TEAM = CS838V553Y;
 				ENABLE_PREVIEWS = YES;