@tomorrowos/sdk 0.9.13 → 0.9.16

package/dist/lan-address.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Best-effort primary non-loopback IPv4 for local development.
+ * Returns null when no suitable interface is found.
+ */
+export declare function detectPrimaryLanIpv4(): string | null;
+//# sourceMappingURL=lan-address.d.ts.map

package/dist/lan-address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lan-address.d.ts","sourceRoot":"","sources":["../src/lan-address.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAcpD"}

package/dist/lan-address.js

@@ -0,0 +1,32 @@
+import os from "os";
+/** Prefer common private LAN ranges for local CMS / player media base URLs. */
+function scoreLanIpv4(ip) {
+    if (ip.startsWith("192.168."))
+        return 3;
+    if (ip.startsWith("10."))
+        return 2;
+    if (/^172\.(1[6-9]|2\d|3[0-1])\./.test(ip))
+        return 2;
+    return 1;
+}
+/**
+ * Best-effort primary non-loopback IPv4 for local development.
+ * Returns null when no suitable interface is found.
+ */
+export function detectPrimaryLanIpv4() {
+    const nets = os.networkInterfaces();
+    const addresses = [];
+    for (const entries of Object.values(nets)) {
+        if (!entries)
+            continue;
+        for (const ent of entries) {
+            const family = ent.family;
+            const isV4 = family === "IPv4" || family === 4;
+            if (!isV4 || ent.internal)
+                continue;
+            addresses.push(ent.address);
+        }
+    }
+    addresses.sort((a, b) => scoreLanIpv4(b) - scoreLanIpv4(a));
+    return addresses[0] ?? null;
+}

package/dist/server-status.js

@@ -36,14 +36,14 @@ function resolveDatabaseProvider(env) {
         };
     }
     if (driver === "memory") {
-        return { provider: "memory", label: "Memory Store", configured: true };
+        return { provider: "memory", label: "Database", configured: true };
     }
     if (driver === "sqlite" || !driver) {
-        return { provider: "sqlite", label: "SQLite", configured: true };
+        return { provider: "sqlite", label: "Database", configured: true };
     }
     return {
         provider: driver || "unknown",
-        label: driver ? `Store (${driver})` : "Database",
+        label: "Database",
         configured: hasUrl || driver === "sqlite" || driver === "memory"
     };
 }

package/dist/tomorrowos.d.ts

@@ -98,6 +98,8 @@ export declare class TomorrowOS extends EventEmitter {
     private staticIndexFile;
     /** Set when listen() starts — exposed to CMS panel for post-restart reconnect grace. */
     private serverStartedAt;
+    /** Port passed to listen(); used for suggested LAN CMS URL. */
+    private listenPort;
     constructor(options: TomorrowOSOptions);
     /** Push all device assignments using latest playlist definitions (e.g. after reboot). */
     pushLatestPolicyToDevice(deviceId: string): Promise<{
@@ -165,6 +167,8 @@ export declare class TomorrowOS extends EventEmitter {
         }>;
     };
     private sendCommandToSocket;
+    /** Best-effort LAN URL for local screens (e.g. http://192.168.1.10:3000). */
+    private getSuggestedCmsUrl;
     listen(options: ListenOptions): http.Server;
     private handleMediaUpload;
     private storeUploadedMediaAsset;

package/dist/tomorrowos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tomorrowos.d.ts","sourceRoot":"","sources":["../src/tomorrowos.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tomorrowos.d.ts","sourceRoot":"","sources":["../src/tomorrowos.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,IAAI,MAAM,MAAM,CAAC;AAYxB,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EACV,gBAAgB,EAKhB,eAAe,EAEhB,MAAM,kBAAkB,CAAC;AAe1B,YAAY,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,CAAC;IACvB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kBAAkB,EAAE,KAAK,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE;YACT,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,GAAG,CAAC,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gBAAgB,EAAE;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,6EAA6E;IAC7E,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACrC;AAqBD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAwKD,qBAAa,UAAW,SAAQ,YAAY;IAC1C,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsC;IACxE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;IAClE,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,eAAe,CAAgB;IACvC,wFAAwF;IACxF,OAAO,CAAC,eAAe,CAAuB;IAC9C,+DAA+D;IAC/D,OAAO,CAAC,UAAU,CAAuB;gBAE7B,OAAO,EAAE,iBAAiB;IAOtC,yFAAyF;IACnF,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QACxD,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;KACtC,CAAC;YAkBY,iBAAiB;IAY/B,6EAA6E;IACvE,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IA4EhE,6EAA6E;IACvE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAuCvF,OAAO;uBACU,MAAM;sBArHgC,MAAM;;2BAsHxC,MAAM;sBAzCgC,MAAM;sBAAY,OAAO;;MA0ClF;IAEF,kFAAkF;IAC5E,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAwE9C;;;OAGG;IACG,mBAAmB,CACvB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,gBAAgB,CAAC;QAC7B,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;YAqBY,sBAAsB;IAsB9B,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QACjE,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAyBF,0FAA0F;YAC5E,2BAA2B;YAW3B,0BAA0B;IAYxC,qFAAqF;YACvE,8BAA8B;IAY5C,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,gBAAgB;YAoBV,+BAA+B;YAsC/B,iBAAiB;YASjB,iBAAiB;YAqCjB,kBAAkB;IAUhC,uFAAuF;IACvF,OAAO,CAAC,kBAAkB;YAmBZ,gBAAgB;YAMhB,uBAAuB;IA0CrC,MAAM,CAAC,QAAQ,EAAE,MAAM;oBAGD,CAAC,oBACT,MAAM,WACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;;IAU5E,OAAO,CAAC,mBAAmB;IA6D3B,6EAA6E;IAC7E,OAAO,CAAC,kBAAkB;IAO1B,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC,MAAM;YAsD7B,iBAAiB;YAgDjB,uBAAuB;IA6ErC,OAAO,CAAC,oBAAoB;YASd,yBAAyB;YAQzB,4BAA4B;YAa5B,2CAA2C;YAO3C,iCAAiC;YA6BjC,wBAAwB;YAiBxB,cAAc;IAiD5B,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,mBAAmB;YAOb,yBAAyB;YAwBzB,oBAAoB;YAkDpB,yBAAyB;YAsBzB,uBAAuB;YAcvB,UAAU;YA0WV,gBAAgB;IAqG9B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,gBAAgB;CAkJzB"}

package/dist/tomorrowos.js

@@ -11,6 +11,7 @@ import { resolveBrandLogoPath, syncProjectAssetsToStaticRoot } from "./brand-ass
 import { deleteCloudinaryAsset, resolveCloudinaryConfig, uploadBufferToCloudinary } from "./cloudinary-storage.js";
 import { probeVideoDurationMs } from "./media-probe.js";
 import { contentHashHex, storeUploadIfNeeded } from "./upload-storage.js";
+import { detectPrimaryLanIpv4 } from "./lan-address.js";
 import { buildServerStatus } from "./server-status.js";
 function normalizeDevicePlatform(platform, system) {
     const explicit = typeof platform === "string" ? platform.trim().toLowerCase() : "";
@@ -213,6 +214,8 @@ export class TomorrowOS extends EventEmitter {
     staticIndexFile = "index.html";
     /** Set when listen() starts — exposed to CMS panel for post-restart reconnect grace. */
     serverStartedAt = null;
+    /** Port passed to listen(); used for suggested LAN CMS URL. */
+    listenPort = null;
     constructor(options) {
         super();
         this.brand = options.brand;
@@ -716,8 +719,17 @@ export class TomorrowOS extends EventEmitter {
             }));
         });
     }
+    /** Best-effort LAN URL for local screens (e.g. http://192.168.1.10:3000). */
+    getSuggestedCmsUrl() {
+        const ip = detectPrimaryLanIpv4();
+        const port = this.listenPort;
+        if (!ip || port == null || !Number.isFinite(port))
+            return null;
+        return `http://${ip}:${port}`;
+    }
     listen(options) {
         const { port, host = "0.0.0.0", staticRoot, staticIndex } = options;
+        this.listenPort = port;
         this.staticRoot = staticRoot ?? null;
         if (this.staticRoot) {
             const idx = (staticIndex ?? "index.html").trim().replace(/^[\\/]+/, "") || "index.html";
@@ -1088,7 +1100,11 @@ export class TomorrowOS extends EventEmitter {
                     store: this.store,
                     staticRoot: this.staticRoot
                 });
-                sendJson(res, 200, report);
+                const suggestedCmsUrl = this.getSuggestedCmsUrl();
+                sendJson(res, 200, {
+                    ...report,
+                    ...(suggestedCmsUrl ? { suggestedCmsUrl } : {})
+                });
                 return;
             }
             if (req.method === "POST" && pathname === "/media/upload") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomorrowos/sdk",
-  "version": "0.9.13",
+  "version": "0.9.16",
   "description": "TomorrowOS CMS server SDK - WebSocket transport, pairing, device commands, optional static CMS UI. Includes CLI (tomorrowos init / build) and starter templates.",
   "type": "module",
   "main": "./dist/index.js",

package/templates/cms-starter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-cms",
-  "version": "0.9.13",
+  "version": "0.9.16",
   "description": "CMS server on @tomorrowos/sdk. Add your UI (React, static files, etc.) alongside this server.",
   "private": true,
   "type": "module",
@@ -13,7 +13,7 @@
     "build-player": "tomorrowos build --platform tizen"
   },
   "dependencies": {
-    "@tomorrowos/sdk": "^0.9.13",
+    "@tomorrowos/sdk": "^0.9.16",
     "dotenv": "^17.2.3",
     "tsx": "^4.19.0"
   },

package/templates/cms-starter/public/index.html

@@ -66,15 +66,16 @@
         <section class="card" id="cmsUrlSection">
           <h2>CMS URL for screens</h2>
           <p class="hint">
-            <strong>Local development only.</strong> Optional LAN override so TVs reach your PC (not localhost).
-            Hosted CMS (e.g. Replit) uses its public URL automatically — leave this empty there.
+            <strong>Local development only.</strong> Defaults to this PC’s LAN IP and listen port so TVs
+            can reach media (not localhost). Change and Save if the auto-detected address is wrong.
+            Hosted CMS (e.g. Replit) uses its public URL automatically — this section is hidden there.
           </p>
           <div class="row">
             <input
               id="cmsDeviceBaseUrl"
               type="text"
               style="flex: 1; min-width: 16rem"
-              placeholder="http://192.168.1.105:3000"
+              placeholder="Detecting LAN address…"
             />
             <button type="button" onclick="saveCmsDeviceBaseUrl()">Save</button>
           </div>
@@ -185,12 +186,8 @@
       <div class="modal-card">
         <h2>On / off timer</h2>
         <p class="hint" id="onOffTimerModalHint">
-          Daily schedule on the device clock. Off uses Samsung panel mute (screen black); the player stays connected to the CMS.
+          Daily on/off times follow the device clock. Off blacks the screen; the player stays powered and connected to the CMS.
         </p>
-        <label class="field-label on-off-timer-enable">
-          <input type="checkbox" id="onOffTimerEnabled" />
-          Enable daily timer
-        </label>
         <div class="on-off-timer-grid">
           <label class="field-label">
             Turn on (unmute)
@@ -201,7 +198,6 @@
             <input type="time" id="onOffTimerTurnOffAt" value="18:00" />
           </label>
         </div>
-        <p class="hint" id="onOffTimerModalStatus"></p>
         <div class="modal-actions">
           <button type="button" id="onOffTimerSaveBtn" class="primary">Save</button>
           <button type="button" data-close-on-off-timer-modal="1">Cancel</button>
@@ -233,7 +229,7 @@
         <p class="hint">Current installed SDK version:</p>
         <p class="update-sdk-version" id="updateSdkVersionLabel">Loading…</p>
         <p class="hint">
-          To upgrade on Replit (or another Agent platform), paste this prompt into the Agent chat:
+          To upgrade on AI agent platforms (Replit, Vercel, etc.), paste this prompt into the Agent chat:
         </p>
         <pre class="update-sdk-prompt" id="updateSdkPromptText">Follow @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
         <div class="modal-actions update-sdk-modal-actions">

package/templates/cms-starter/public/methods.js

@@ -190,6 +190,28 @@ function getExplicitLanMediaBase() {
   return normalizeMediaBaseUrl(localStorage.getItem(PANEL_MEDIA_BASE_KEY) || "");
 }
 
+/**
+ * Prefill CMS URL for screens from server-detected LAN IP:port when running on localhost
+ * and the operator has not saved a value yet. Auto-persists so thumbs/publish work without Save.
+ */
+function applyDefaultCmsUrlForScreens(suggested) {
+  if (!isLocalPanelHost(window.location.hostname)) return;
+  const normalized = normalizeMediaBaseUrl(suggested);
+  if (!normalized) return;
+
+  const cmsBaseInput = document.getElementById("cmsDeviceBaseUrl");
+  const saved = getExplicitLanMediaBase();
+  if (saved) {
+    if (cmsBaseInput && !String(cmsBaseInput.value || "").trim()) {
+      cmsBaseInput.value = saved;
+    }
+    return;
+  }
+
+  if (cmsBaseInput) cmsBaseInput.value = normalized;
+  localStorage.setItem(PANEL_MEDIA_BASE_KEY, normalized);
+}
+
 function playlistHasRelativeMediaUrls(playlist) {
   return (playlist?.items || []).some((item) => {
     const url = String(item?.url || "").trim();
@@ -1280,8 +1302,8 @@ function renderDeviceCards() {
 
     const timerBtn = document.createElement("button");
     timerBtn.type = "button";
-    timerBtn.textContent = device.onOffTimer?.enabled ? "Timer · On" : "Timer";
-    timerBtn.title = "Daily screen on/off (Tizen panel mute)";
+    timerBtn.textContent = "Timer";
+    timerBtn.title = "Daily screen on/off timer";
     timerBtn.addEventListener("click", () => openOnOffTimerModal(device.deviceId));
 
     const unpairBtn = document.createElement("button");
@@ -1815,32 +1837,19 @@ function openOnOffTimerModal(deviceId) {
   const device = devicesCache.find((d) => d.deviceId === deviceId);
   if (!device) return;
   if (!isTizenDevice(device)) {
-    alert("On/off timer is available for Samsung Tizen players only.");
+    alert("On/off timer is available for Tizen players only.");
     return;
   }
 
   onOffTimerModalDeviceId = deviceId;
   const modal = document.getElementById("onOffTimerModal");
-  const hint = document.getElementById("onOffTimerModalHint");
-  const status = document.getElementById("onOffTimerModalStatus");
-  const enabledEl = document.getElementById("onOffTimerEnabled");
   const onEl = document.getElementById("onOffTimerTurnOnAt");
   const offEl = document.getElementById("onOffTimerTurnOffAt");
-  if (!modal || !enabledEl || !onEl || !offEl) return;
+  if (!modal || !onEl || !offEl) return;
 
   const timer = device.onOffTimer || {};
-  enabledEl.checked = Boolean(timer.enabled);
   onEl.value = normalizeTimeInputValue(timer.turnOnAt, "06:00");
   offEl.value = normalizeTimeInputValue(timer.turnOffAt, "18:00");
-  if (hint) {
-    hint.textContent =
-      "Daily schedule on the device clock. Off uses Samsung panel mute (screen black); the player stays connected to the CMS.";
-  }
-  if (status) {
-    status.textContent = device.connected
-      ? "Device is online — save will apply immediately."
-      : "Device is offline — schedule will save and apply when it reconnects.";
-  }
   modal.classList.remove("hidden");
 }
 
@@ -1854,14 +1863,13 @@ async function saveOnOffTimerModal() {
   const deviceId = onOffTimerModalDeviceId;
   if (!deviceId) return;
 
-  const enabledEl = document.getElementById("onOffTimerEnabled");
   const onEl = document.getElementById("onOffTimerTurnOnAt");
   const offEl = document.getElementById("onOffTimerTurnOffAt");
   const saveBtn = document.getElementById("onOffTimerSaveBtn");
-  if (!enabledEl || !onEl || !offEl) return;
+  if (!onEl || !offEl) return;
 
   const onOffTimer = {
-    enabled: Boolean(enabledEl.checked),
+    enabled: true,
     turnOnAt: normalizeTimeInputValue(onEl.value, "06:00"),
     turnOffAt: normalizeTimeInputValue(offEl.value, "18:00")
   };
@@ -2143,6 +2151,9 @@ async function fetchServerStatus() {
     if (typeof data.sdkVersion === "string" && data.sdkVersion.trim()) {
       cachedSdkVersion = data.sdkVersion.trim();
     }
+    if (typeof data.suggestedCmsUrl === "string") {
+      applyDefaultCmsUrlForScreens(data.suggestedCmsUrl);
+    }
     renderServerStatus(data);
   } catch (err) {
     renderServerStatus({

package/templates/cms-starter/public/panel.css

@@ -829,22 +829,11 @@ button.danger {
   width: min(94vw, 860px);
 }
 
-.on-off-timer-enable {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-  margin: 0.85rem 0 0.65rem;
-}
-
-.on-off-timer-enable input {
-  width: auto;
-  margin: 0;
-}
-
 .on-off-timer-grid {
   display: grid;
   grid-template-columns: 1fr 1fr;
   gap: 0.75rem;
+  margin-top: 0.85rem;
 }
 
 @media (max-width: 520px) {