@tomorrowos/sdk 0.9.70 → 0.9.72

package/VERCEL_SETUP.md

@@ -5,7 +5,7 @@
 >
 > **On Vercel, this file is the setup questionnaire** (not `REPLIT_SETUP.md`).
 >
-> Protocol id: `vercel-setup/1.14` - pairs with `@tomorrowos/sdk` **0.9.70+** (`templates/cms-starter-v0`, Fluid Functions WebSockets).
+> Protocol id: `vercel-setup/1.15` - pairs with `@tomorrowos/sdk` **0.9.70+** (`templates/cms-starter-v0`, Fluid Functions WebSockets).
 >
 > **Questions source of truth:** `VERCEL_QUESTIONS.md` - Agents must **open that file and paste each Q block verbatim**. Do not paraphrase.  
 > **Q1/Q2 = choice questions. Q3 = form only:** open **all seven optional inputs at once**, then **HARD STOP and WAIT** for submit or "skip". Never auto-skip because fields are optional. Never ask a branding choice first. Never show only Name + Primary colour. Logo = **Upload** above **Logo URL**.  
@@ -921,7 +921,32 @@ Tell the user:
 
 - **Control Panel (Publish):** `https://YOUR-PROJECT.vercel.app`
 - **TV CMS endpoint:** same HTTPS origin (players use `wss://`)
-- **Preview:** Next shell is for v0 only ??do not pair devices to Preview
+- **Preview:** Next shell is for v0 only — do not pair devices to Preview
+
+Then **you must tell the user how to install a player and pair**. Do **not** only link a file — spell out the steps:
+
+#### Samsung Tizen (6.5 and 7.0)
+
+1. On the display, open **App Management** → install via **Custom App** URL:
+
+   ```txt
+   https://tmr.sh/tizen
+   ```
+
+   Or use Control Panel → **Download Players → Samsung** and install via USB.
+2. Choose orientation, then enter the **Production** CMS URL: `https://YOUR-PROJECT.vercel.app/` (never Preview, never `localhost`).
+3. Enter the **six-character** pairing code in Control Panel → **Pair**.
+
+#### BrightSign (Series 3-6)
+
+1. On the **Production** Control Panel → **Download Players → BrightSign** (preferred — `cmsEndpoint` is filled for this CMS),  
+   or download `https://tmr.sh/app/brightsign/brightsign_package.zip` and set `cmsEndpoint` in `config.js` to `https://YOUR-PROJECT.vercel.app/`.
+2. Unzip and copy the **contents** to the SD card root (`autorun.brs`, `config.js`, player files).
+3. Power-cycle the player, wait ~10s through the black boot window, then pair with the six-character code.
+
+4. Create a playlist, upload media, **Publish** to the device.
+
+More detail: https://docs.tomorrowos.org/docs/os/tizen and https://docs.tomorrowos.org/docs/os/brightsign
 
 ### E. Minimal verification only
 
@@ -987,25 +1012,27 @@ Tell the user:
 
 ---
 
-## Final summary template (Agent ??human)
+## Final summary template (Agent — human)
 
 After setup, report:
 
 1. **Live URL** (Production Publish)
-2. **Publish health:** Framework = Other; Output ??`public`; `GET /status` ??JSON; `GET /` OK
+2. **Publish health:** Framework = Other; Output — `public`; `GET /status` — JSON; `GET /` OK
 3. **Preview note:** Next proxy shell used / not needed
-4. **Env Vars set** (names only ??never values); note which were auto-set (`TOMORROWOS_STORE`, `DATABASE_SSL`)
+4. **Env Vars set** (names only — never values); note which were auto-set (`TOMORROWOS_STORE`, `DATABASE_SSL`)
 5. **Store:** Supabase pooler or Neon pooled
 6. **Media:** Cloudinary or Vercel Blob
 7. **Brand:** name + `hostingTarget: vercel` (from optional Q3 fields; blanks = starter defaults)
-8. **Runtime split:** Preview = ??; Publish = Node TomorrowOS (confirm **not** Next)
+8. **Runtime split:** Preview = …; Publish = Node TomorrowOS (confirm **not** Next)
 9. **Open action:** if Database still ERROR, paste the pooler instruction again
+10. **Connect a screen:** include the Tizen Custom App URL / BrightSign SD install + six-character pairing steps from section **D. Deploy** above (required — do not skip)
 
 Protocol complete when:
 
 - **Preview** shows the Control Panel at `/` (via Next proxy if required), **and**
 - **Publish** returns Control Panel at `/` **and** `/status` JSON from pure Node `TomorrowOS.listen` with Fluid (not static `public/`, not `404: NOT_FOUND`, not `Unexpected token 'T'`), **and**
-- Q1?Q3 configuration is saved
+- Q1–Q3 configuration is saved, **and**
+- the user has been told how to install Tizen and/or BrightSign and pair
 
 ? even if a sandbox DB probe still flakes **after** the pooled URL is correctly set for Production.
 
@@ -1013,7 +1040,9 @@ Protocol complete when:
 
 ## Protocol version
 
-`vercel-setup/1.14` - pairs with `@tomorrowos/sdk` 0.9.70+ and `VERCEL_QUESTIONS.md` 1.5.
+`vercel-setup/1.15` - pairs with `@tomorrowos/sdk` 0.9.70+ and `VERCEL_QUESTIONS.md` 1.5.
+
+**Changelog 1.15:** After Publish is healthy, agents **must** tell the user how to install Tizen (Custom App `https://tmr.sh/tizen`) and BrightSign (CMS zip → SD root) and pair against the **Production** URL. Final summary requires this screen-connect step.
 
 **Changelog 1.14:** Vercel Blob is **SDK-native** (`BLOB_READ_WRITE_TOKEN` + `TOMORROWOS_MEDIA=vercel-blob`). No project Blob bridge. Status providers use display names (Neon, Supabase, Blob, Cloudinary, Replit Object Storage). Forbidden marketing status copy about blob URL patterns.
 

package/dist/cli.js

@@ -85,6 +85,7 @@ function copyStarter(destDir, force, hosting) {
     console.log(`[tomorrowos] Template: ${templateName} (--hosting ${hosting})`);
     console.log(`[tomorrowos] @tomorrowos/sdk dependency: ^${sdkVer}`);
     console.log(`[tomorrowos] Initialized SQLite database: ${dbPath}`);
+    console.log(`[tomorrowos] Env template: ${path.join(resolved, ".env.example")}`);
     if (hosting === "replit") {
         console.log("Next: npm install, then npm start (see REPLIT_SETUP.md on Replit)");
     }
@@ -102,10 +103,12 @@ function parseHostingFlag(argv) {
 }
 function cmdBuild(argv) {
     const platformIdx = argv.indexOf("--platform");
-    const platform = platformIdx >= 0 && argv[platformIdx + 1] ? argv[platformIdx + 1] : "tizen";
-    console.log(`[tomorrowos] Player packaging for "${platform}" is not bundled in @tomorrowos/sdk yet.`);
-    console.log("Use your TomorrowOS player repository (assemble Web app + config), then run the platform SDK (e.g. Tizen CLI tizen package) from the build output directory.");
-    process.exitCode = 0;
+    const platform = platformIdx >= 0 && argv[platformIdx + 1] ? argv[platformIdx + 1] : "(unspecified)";
+    console.error(`[tomorrowos] "tomorrowos build" does not package players. No file was produced for platform "${platform}".`);
+    console.error("Download a verified prebuilt player from your running Control Panel (Download Players), or from the player repositories.");
+    console.error("Tizen: Control Panel → Download Players → Samsung (or https://tmr.sh/app/tizen/). BrightSign: Control Panel → Download Players → BrightSign (GET /players/brightsign.zip).");
+    console.error("See PLAYER_INSTALL.md for install and pairing steps.");
+    process.exit(1);
 }
 function optionValue(argv, name) {
     const withEquals = `${name}=`;
@@ -194,7 +197,6 @@ function printHelp() {
 Usage:
   tomorrowos init [directory]     Copy cms-starter template (default: Replit / Railway)
   tomorrowos migrate [options]    Migrate TomorrowOS data between supported databases
-  tomorrowos build --platform …   Placeholder; player packaging lives in the player repo
 
 Options:
   --hosting replit|v0|vercel      init template: replit (default) or Vercel/v0 (cms-starter-v0)
@@ -205,6 +207,8 @@ Examples:
   npx @tomorrowos/sdk@latest init ./my-cms --hosting replit
   npx @tomorrowos/sdk@latest init ./my-cms --hosting v0
   npx @tomorrowos/sdk@latest migrate --from sqlite --from-sqlite ./data/tomorrowos.db --to supabase --to-database-url "$DATABASE_URL"
+
+Player packages are not built by this CLI. Use Control Panel → Download Players, or see PLAYER_INSTALL.md.
 `);
 }
 function printMigrateHelp() {

package/dist/playlist-catalog.d.ts

@@ -8,9 +8,6 @@ export interface SavePlaylistInput {
 export interface BuiltDevicePolicy {
     policy: {
         playlists: PublishedPlaylistSnapshot[];
-        fallback: {
-            type: "brand";
-        };
         revision?: number;
         syncMode?: "latest" | "snapshot";
     };

package/dist/playlist-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playlist-catalog.d.ts","sourceRoot":"","sources":["../src/playlist-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QACN,SAAS,EAAE,yBAAyB,EAAE,CAAC;QACvC,QAAQ,EAAE;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;KAClC,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyDD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE7C,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAK1C,6BAA6B,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI5D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IA8B/D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAcnD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAIhC,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAiEvB,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAO7B,mFAAmF;IAC7E,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKjF;;;OAGG;IACG,+BAA+B,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;IA4BrD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;YAKf,0BAA0B;IAgCxC,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpE"}
+{"version":3,"file":"playlist-catalog.d.ts","sourceRoot":"","sources":["../src/playlist-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QACN,SAAS,EAAE,yBAAyB,EAAE,CAAC;QACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;KAClC,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyDD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE7C,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAK1C,6BAA6B,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI5D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IA8B/D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAcnD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAIhC,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAiEvB,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAO7B,mFAAmF;IAC7E,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKjF;;;OAGG;IACG,+BAA+B,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;KAAE,CAAC;IA4BrD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;YAKf,0BAA0B;IA+BxC,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpE"}

package/dist/playlist-catalog.js

@@ -219,7 +219,6 @@ export class PlaylistCatalog {
         return {
             policy: {
                 playlists,
-                fallback: { type: "brand" },
                 revision: Date.now(),
                 syncMode: useLatest ? "latest" : "snapshot"
             }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tomorrowos/sdk",
-  "version": "0.9.70",
-  "description": "TomorrowOS CMS server SDK - WebSocket transport, pairing, device commands, optional static CMS UI. Includes CLI (tomorrowos init / build) and starter templates.",
+  "version": "0.9.72",
+  "description": "Server SDK for building and self-hosting digital signage CMS products with TomorrowOS players.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,6 +18,8 @@
     "dist",
     "templates",
     "README.md",
+    "LICENSE",
+    "NOTICE",
     "REPLIT_SETUP.md",
     "VERCEL_SETUP.md",
     "VERCEL_QUESTIONS.md",
@@ -32,7 +34,7 @@
     "prepublishOnly": "npm run build"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "dependencies": {
     "@replit/object-storage": "^1.0.0",
@@ -50,5 +52,22 @@
     "@types/ws": "^8.5.10",
     "typescript": "^5.5.0"
   },
+  "repository": {
+     "type": "git",
+     "url": "git+https://github.com/TomorrowOS/TomorrowOS_SDK"
+  },
+   "homepage": "https://docs.tomorrowos.org",
+   "bugs": {
+    "url": "https://github.com/TomorrowOS/TomorrowOS_SDK/issues"
+    },
+    "keywords": [
+      "digital-signage",
+      "cms",
+      "tizen",
+      "brightsign",
+      "device-management",
+      "websocket",
+      "typescript"
+      ],
   "license": "Apache-2.0"
 }

package/templates/cms-starter/.env.example

@@ -0,0 +1,19 @@
+# Default: SQLite.
+# TOMORROWOS_STORE=sqlite
+# TOMORROWOS_DB_PATH=./data/tomorrowos.db
+
+# Supabase/Postgres.
+# On Replit use SUPABASE_URL — DATABASE_URL is often a reserved Secret.
+# TOMORROWOS_STORE=supabase
+# SUPABASE_URL=postgresql://postgres:[PASSWORD]@[HOST]:5432/postgres
+# DATABASE_SSL=true
+# DATABASE_URL=postgresql://...   # optional fallback outside Replit
+
+# Optional: upload media to Cloudinary instead of local / Object Storage.
+# CLOUDINARY_CLOUD_NAME=
+# CLOUDINARY_API_KEY=
+# CLOUDINARY_API_SECRET=
+# CLOUDINARY_FOLDER=tomorrowos
+
+# Optional: override the default deterministic pairing-code secret.
+# PAIRING_CODE_SECRET=

package/templates/cms-starter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-cms",
-  "version": "0.9.70",
+  "version": "0.9.72",
   "description": "CMS server on @tomorrowos/sdk. Add your UI (React, static files, etc.) alongside this server.",
   "private": true,
   "type": "module",
@@ -9,11 +9,10 @@
   },
   "scripts": {
     "dev": "tsx watch server.ts",
-    "start": "tsx server.ts",
-    "build-player": "tomorrowos build --platform tizen"
+    "start": "tsx server.ts"
   },
   "dependencies": {
-    "@tomorrowos/sdk": "^0.9.70",
+    "@tomorrowos/sdk": "^0.9.72",
     "dotenv": "^17.2.3",
     "tsx": "^4.19.0"
   },

package/templates/cms-starter/policy.example.json

@@ -23,7 +23,6 @@
           }
         ]
       }
-    ],
-    "fallback": { "type": "brand" }
+    ]
   }
 }

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

@@ -231,11 +231,15 @@
         <p class="hint">Current installed SDK version:</p>
         <p class="update-sdk-version" id="updateSdkVersionLabel">Loading…</p>
         <p class="hint">
-          To upgrade on AI agent platforms (Replit, Vercel, etc.), paste this prompt into the Agent chat:
+          To upgrade on AI agent platforms, paste the matching 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>
+        <p class="update-sdk-prompt-label">Replit</p>
+        <pre class="update-sdk-prompt" id="updateSdkPromptReplit">Follow NPM package @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
+        <p class="update-sdk-prompt-label">Vercel</p>
+        <pre class="update-sdk-prompt" id="updateSdkPromptVercel">Follow NPM package @tomorrowos/sdk VERCEL_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
         <div class="modal-actions update-sdk-modal-actions">
-          <button type="button" id="copyUpdateSdkPromptBtn" class="primary">Copy prompt</button>
+          <button type="button" id="copyUpdateSdkPromptReplitBtn" class="primary">Copy Replit prompt</button>
+          <button type="button" id="copyUpdateSdkPromptVercelBtn" class="primary">Copy Vercel prompt</button>
           <button type="button" data-close-update-sdk-modal="1">Close</button>
         </div>
       </div>

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

@@ -33,8 +33,10 @@ let cachedSdkVersion = "";
 /** @type {number|null} CMS server boot time (ms) from GET /devices. */
 let serverStartedAtMs = null;
 
-const UPDATE_SDK_PROMPT =
-  "Follow @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.";
+const UPDATE_SDK_PROMPT_REPLIT =
+  "Follow NPM package @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.";
+const UPDATE_SDK_PROMPT_VERCEL =
+  "Follow NPM package @tomorrowos/sdk VERCEL_UPGRADE.md to upgrade my CMS with the latest SDK.";
 /** @type {ReturnType<typeof setTimeout>|null} */
 let reconnectGraceTimer = null;
 let uploadQueue = [];
@@ -2364,8 +2366,10 @@ function setUpdateSdkVersionLabel(version) {
 
 async function openUpdateSdkModal() {
   const modal = document.getElementById("updateSdkModal");
-  const promptEl = document.getElementById("updateSdkPromptText");
-  if (promptEl) promptEl.textContent = UPDATE_SDK_PROMPT;
+  const replitEl = document.getElementById("updateSdkPromptReplit");
+  const vercelEl = document.getElementById("updateSdkPromptVercel");
+  if (replitEl) replitEl.textContent = UPDATE_SDK_PROMPT_REPLIT;
+  if (vercelEl) vercelEl.textContent = UPDATE_SDK_PROMPT_VERCEL;
   setUpdateSdkVersionLabel(cachedSdkVersion || "Loading…");
   modal?.classList.remove("hidden");
 
@@ -2379,18 +2383,21 @@ function closeUpdateSdkModal() {
   document.getElementById("updateSdkModal")?.classList.add("hidden");
 }
 
-async function copyUpdateSdkPrompt() {
+async function copyUpdateSdkPrompt(which) {
+  const isVercel = which === "vercel";
   const text =
-    document.getElementById("updateSdkPromptText")?.textContent?.trim() ||
-    UPDATE_SDK_PROMPT;
+    document.getElementById(isVercel ? "updateSdkPromptVercel" : "updateSdkPromptReplit")
+      ?.textContent?.trim() ||
+    (isVercel ? UPDATE_SDK_PROMPT_VERCEL : UPDATE_SDK_PROMPT_REPLIT);
+  const btnId = isVercel ? "copyUpdateSdkPromptVercelBtn" : "copyUpdateSdkPromptReplitBtn";
   try {
     await navigator.clipboard.writeText(text);
-    const btn = document.getElementById("copyUpdateSdkPromptBtn");
+    const btn = document.getElementById(btnId);
     if (btn) {
       const prev = btn.textContent;
       btn.textContent = "Copied";
       setTimeout(() => {
-        btn.textContent = prev || "Copy prompt";
+        btn.textContent = prev || (isVercel ? "Copy Vercel prompt" : "Copy Replit prompt");
       }, 1200);
     }
   } catch {
@@ -2679,8 +2686,11 @@ document.addEventListener("DOMContentLoaded", () => {
     el.addEventListener("click", closeUpdateSdkModal);
   });
   document
-    .getElementById("copyUpdateSdkPromptBtn")
-    ?.addEventListener("click", () => void copyUpdateSdkPrompt());
+    .getElementById("copyUpdateSdkPromptReplitBtn")
+    ?.addEventListener("click", () => void copyUpdateSdkPrompt("replit"));
+  document
+    .getElementById("copyUpdateSdkPromptVercelBtn")
+    ?.addEventListener("click", () => void copyUpdateSdkPrompt("vercel"));
 
   document.getElementById("addAssetBtn")?.addEventListener("click", () => {
     if (uploadInProgress) return;

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

@@ -1034,6 +1034,14 @@ button.danger {
   color: #0a0908;
 }
 
+.update-sdk-prompt-label {
+  margin: 0.85rem 0 0.35rem;
+  font-size: 0.8rem;
+  font-weight: 600;
+  letter-spacing: 0.02em;
+  color: #5d554d;
+}
+
 .update-sdk-prompt {
   margin: 0;
   padding: 0.75rem 0.85rem;
@@ -1049,6 +1057,8 @@ button.danger {
 
 .update-sdk-modal-actions {
   justify-content: flex-end;
+  flex-wrap: wrap;
+  gap: 0.5rem;
 }
 
 .download-players-modal-card {

package/templates/cms-starter-v0/.env.example

@@ -0,0 +1,19 @@
+# Default: SQLite.
+# TOMORROWOS_STORE=sqlite
+# TOMORROWOS_DB_PATH=./data/tomorrowos.db
+
+# Supabase/Postgres.
+# On Replit use SUPABASE_URL — DATABASE_URL is often a reserved Secret.
+# TOMORROWOS_STORE=supabase
+# SUPABASE_URL=postgresql://postgres:[PASSWORD]@[HOST]:5432/postgres
+# DATABASE_SSL=true
+# DATABASE_URL=postgresql://...   # optional fallback outside Replit
+
+# Optional: upload media to Cloudinary instead of local / Object Storage.
+# CLOUDINARY_CLOUD_NAME=
+# CLOUDINARY_API_KEY=
+# CLOUDINARY_API_SECRET=
+# CLOUDINARY_FOLDER=tomorrowos
+
+# Optional: override the default deterministic pairing-code secret.
+# PAIRING_CODE_SECRET=

package/templates/cms-starter-v0/cms-panel/index.html

@@ -231,11 +231,15 @@
         <p class="hint">Current installed SDK version:</p>
         <p class="update-sdk-version" id="updateSdkVersionLabel">Loading…</p>
         <p class="hint">
-          To upgrade on AI agent platforms (Replit, Vercel, etc.), paste this prompt into the Agent chat:
+          To upgrade on AI agent platforms, paste the matching 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>
+        <p class="update-sdk-prompt-label">Replit</p>
+        <pre class="update-sdk-prompt" id="updateSdkPromptReplit">Follow NPM package @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
+        <p class="update-sdk-prompt-label">Vercel</p>
+        <pre class="update-sdk-prompt" id="updateSdkPromptVercel">Follow NPM package @tomorrowos/sdk VERCEL_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
         <div class="modal-actions update-sdk-modal-actions">
-          <button type="button" id="copyUpdateSdkPromptBtn" class="primary">Copy prompt</button>
+          <button type="button" id="copyUpdateSdkPromptReplitBtn" class="primary">Copy Replit prompt</button>
+          <button type="button" id="copyUpdateSdkPromptVercelBtn" class="primary">Copy Vercel prompt</button>
           <button type="button" data-close-update-sdk-modal="1">Close</button>
         </div>
       </div>

package/templates/cms-starter-v0/cms-panel/methods.js

@@ -33,8 +33,10 @@ let cachedSdkVersion = "";
 /** @type {number|null} CMS server boot time (ms) from GET /devices. */
 let serverStartedAtMs = null;
 
-const UPDATE_SDK_PROMPT =
-  "Follow @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.";
+const UPDATE_SDK_PROMPT_REPLIT =
+  "Follow NPM package @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.";
+const UPDATE_SDK_PROMPT_VERCEL =
+  "Follow NPM package @tomorrowos/sdk VERCEL_UPGRADE.md to upgrade my CMS with the latest SDK.";
 /** @type {ReturnType<typeof setTimeout>|null} */
 let reconnectGraceTimer = null;
 let uploadQueue = [];
@@ -2364,8 +2366,10 @@ function setUpdateSdkVersionLabel(version) {
 
 async function openUpdateSdkModal() {
   const modal = document.getElementById("updateSdkModal");
-  const promptEl = document.getElementById("updateSdkPromptText");
-  if (promptEl) promptEl.textContent = UPDATE_SDK_PROMPT;
+  const replitEl = document.getElementById("updateSdkPromptReplit");
+  const vercelEl = document.getElementById("updateSdkPromptVercel");
+  if (replitEl) replitEl.textContent = UPDATE_SDK_PROMPT_REPLIT;
+  if (vercelEl) vercelEl.textContent = UPDATE_SDK_PROMPT_VERCEL;
   setUpdateSdkVersionLabel(cachedSdkVersion || "Loading…");
   modal?.classList.remove("hidden");
 
@@ -2379,18 +2383,21 @@ function closeUpdateSdkModal() {
   document.getElementById("updateSdkModal")?.classList.add("hidden");
 }
 
-async function copyUpdateSdkPrompt() {
+async function copyUpdateSdkPrompt(which) {
+  const isVercel = which === "vercel";
   const text =
-    document.getElementById("updateSdkPromptText")?.textContent?.trim() ||
-    UPDATE_SDK_PROMPT;
+    document.getElementById(isVercel ? "updateSdkPromptVercel" : "updateSdkPromptReplit")
+      ?.textContent?.trim() ||
+    (isVercel ? UPDATE_SDK_PROMPT_VERCEL : UPDATE_SDK_PROMPT_REPLIT);
+  const btnId = isVercel ? "copyUpdateSdkPromptVercelBtn" : "copyUpdateSdkPromptReplitBtn";
   try {
     await navigator.clipboard.writeText(text);
-    const btn = document.getElementById("copyUpdateSdkPromptBtn");
+    const btn = document.getElementById(btnId);
     if (btn) {
       const prev = btn.textContent;
       btn.textContent = "Copied";
       setTimeout(() => {
-        btn.textContent = prev || "Copy prompt";
+        btn.textContent = prev || (isVercel ? "Copy Vercel prompt" : "Copy Replit prompt");
       }, 1200);
     }
   } catch {
@@ -2679,8 +2686,11 @@ document.addEventListener("DOMContentLoaded", () => {
     el.addEventListener("click", closeUpdateSdkModal);
   });
   document
-    .getElementById("copyUpdateSdkPromptBtn")
-    ?.addEventListener("click", () => void copyUpdateSdkPrompt());
+    .getElementById("copyUpdateSdkPromptReplitBtn")
+    ?.addEventListener("click", () => void copyUpdateSdkPrompt("replit"));
+  document
+    .getElementById("copyUpdateSdkPromptVercelBtn")
+    ?.addEventListener("click", () => void copyUpdateSdkPrompt("vercel"));
 
   document.getElementById("addAssetBtn")?.addEventListener("click", () => {
     if (uploadInProgress) return;

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

@@ -1034,6 +1034,14 @@ button.danger {
   color: #0a0908;
 }
 
+.update-sdk-prompt-label {
+  margin: 0.85rem 0 0.35rem;
+  font-size: 0.8rem;
+  font-weight: 600;
+  letter-spacing: 0.02em;
+  color: #5d554d;
+}
+
 .update-sdk-prompt {
   margin: 0;
   padding: 0.75rem 0.85rem;
@@ -1049,6 +1057,8 @@ button.danger {
 
 .update-sdk-modal-actions {
   justify-content: flex-end;
+  flex-wrap: wrap;
+  gap: 0.5rem;
 }
 
 .download-players-modal-card {

package/templates/cms-starter-v0/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-cms",
-  "version": "0.9.70",
+  "version": "0.9.72",
   "description": "TomorrowOS CMS for Vercel / v0 Publish (Fluid Function + WebSockets + optional Next Preview).",
   "private": true,
   "type": "module",
@@ -13,11 +13,10 @@
     "dev:next": "cd preview && next dev -p 3000",
     "dev:preview": "concurrently -k \"npm:dev:tomorrowos\" \"npm:dev:next\"",
     "start": "tsx server.ts",
-    "build": "node -e \"process.exit(0)\"",
-    "build-player": "tomorrowos build --platform tizen"
+    "build": "node -e \"process.exit(0)\""
   },
   "dependencies": {
-    "@tomorrowos/sdk": "^0.9.70",
+    "@tomorrowos/sdk": "^0.9.72",
     "dotenv": "^17.2.3",
     "tsx": "^4.19.0"
   },

package/templates/cms-starter-v0/policy.example.json

@@ -23,7 +23,6 @@
           }
         ]
       }
-    ],
-    "fallback": { "type": "brand" }
+    ]
   }
 }