feat: add mobile layout preview

packages/api/src/router/serverSettings.ts

@@ -55,7 +55,7 @@ export const serverSettingsRouter = createTRPCRouter({
       mcp: {
         enabled: true,
         description:
-          "Update global board defaults. Requires admin permission. Optional fields: homeBoardId, mobileHomeBoardId, enableAutomaticMobileLayout, enableStatusByDefault, forceDisableStatus. Home board IDs must reference public boards or be null",
+          "Update global board defaults. Requires admin permission. Optional fields: homeBoardId, mobileHomeBoardId, enableAutomaticMobileLayout, enableStatusByDefault, forceDisableStatus. Home board IDs must reference public boards returned by the public-board listing tool or API, using each board's id field, or be null",
       },
     })
     .input(boardServerSettingsUpdateSchema)

packages/db/migrations/seed.spec.ts

@@ -72,6 +72,61 @@ describe("automatic mobile layout upgrade default", () => {
     });
   });
 
+  test("persists the enabled default when a fresh instance is seeded repeatedly", async () => {
+    const db = createDb();
+
+    await seedServerSettingsAsync(db);
+    await seedServerSettingsAsync(db);
+
+    await expect(getServerSettingByKeyAsync(db, "board")).resolves.toStrictEqual(defaultServerSettings.board);
+  });
+
+  test("backfills the enabled default for canonical layouts", async () => {
+    const db = createDb();
+    const boardId = createId();
+    await db.insert(boards).values({ id: boardId, name: "dashboard", isPublic: false });
+    await db.insert(layouts).values({
+      id: createId(),
+      boardId,
+      name: "Base",
+      columnCount: 12,
+      breakpoint: 0,
+    });
+    await db.insert(serverSettings).values({
+      settingKey: "board",
+      value: stringify({
+        homeBoardId: null,
+        mobileHomeBoardId: null,
+        enableStatusByDefault: true,
+        forceDisableStatus: false,
+      }),
+    });
+
+    await seedServerSettingsAsync(db);
+    await seedServerSettingsAsync(db);
+
+    await expect(getServerSettingByKeyAsync(db, "board")).resolves.toStrictEqual(defaultServerSettings.board);
+  });
+
+  test("does not override an explicit disabled choice", async () => {
+    const db = createDb();
+    await db.insert(serverSettings).values({
+      settingKey: "board",
+      value: stringify({
+        ...defaultServerSettings.board,
+        enableAutomaticMobileLayout: false,
+      }),
+    });
+
+    await seedServerSettingsAsync(db);
+    await seedServerSettingsAsync(db);
+
+    await expect(getServerSettingByKeyAsync(db, "board")).resolves.toStrictEqual({
+      ...defaultServerSettings.board,
+      enableAutomaticMobileLayout: false,
+    });
+  });
+
   test("backfills legacy responsive instances once without overriding an explicit choice", async () => {
     const db = createDb();
     const boardId = createId();

packages/translation/src/lang/en.json

@@ -5011,6 +5011,12 @@
     }
   },
   "board": {
+    "mobilePreview": {
+      "title": "Mobile preview",
+      "action": "Mobile preview",
+      "collapse": "Collapse mobile preview",
+      "empty": "Add items to the board to preview the automatic mobile layout."
+    },
     "action": {
       "addContent": "Add board content",
       "settings": "Board settings",