style: auto-fix lint and format

The in-memory request handler cache introduced in #6075 keyed entries by
JSON.stringify(input) in a Map shared across all handlers. Any two handlers
querying the same integration with equal options (e.g. {}) collided and read
each other's data — with the mock integration serving every widget kind, all
demo widgets received whichever handler's data was cached first (beszel
getting health-monitoring payloads, etc.). Cache keys are now namespaced per
handler definition.

Also disable the query-cache persister after the first FORBIDDEN response so
demo mode doesn't retry a mutation that is always rejected.

.env.example

@@ -59,11 +59,4 @@ TURBO_TELEMETRY_DISABLED=1
 # ENABLE_KUBERNETES=true
 
 # Enable mock integration
-UNSAFE_ENABLE_MOCK_INTEGRATION=true
-
-# Enable demo mode (seeds a demo user "demo"/"demo", a sample board and a mock integration)
-# DEMO_MODE=true
-
-# Whether demo mode is read-only. Defaults to true (the public demo blocks all mutations).
-# Set to false for writable preview deployments so the demo user can modify the dashboard.
-# DEMO_READ_ONLY=false
+UNSAFE_ENABLE_MOCK_INTEGRATION=true

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -33,7 +33,6 @@ body:
       options:
         # The below comment is used to insert a new version with on-release.yml
         #NEXT_VERSION#
-        - 1.69.2
         - 1.69.0
         - 1.68.0
         - 1.67.0

.github/actions/prebuilt-debian/action.yaml

@@ -11,7 +11,7 @@ outputs:
 runs:
   using: "composite"
   steps:
-    - uses: actions/checkout@v7
+    - uses: actions/checkout@v6
       with:
         persist-credentials: false
     - name: Set up Docker Buildx

.github/workflows/automatic-approval.yml

@@ -17,7 +17,7 @@ jobs:
     if: github.actor_id == 158783068 || github.actor_id == 190541745 || github.actor_id == 210161987 || github.actor_id == 175486441
     steps:
       - name: Checkout code
-        uses: actions/checkout@v7
+        uses: actions/checkout@v6
       - name: Obtain token
         id: obtainToken
         uses: actions/create-github-app-token@v3

.github/workflows/code-quality.yml

@@ -25,13 +25,13 @@ env:
 
 jobs:
   lint-format-autofix:
-    if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.id == github.repository_id
+    if: github.event_name == 'pull_request'
     runs-on: ubuntu-latest
     timeout-minutes: 5
     permissions:
       contents: write
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
           ref: ${{ github.head_ref }}
@@ -60,7 +60,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
@@ -78,7 +78,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
@@ -92,7 +92,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
@@ -106,7 +106,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
 
       - name: Setup
         uses: ./tooling/github/setup
@@ -124,7 +124,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 15
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
       - name: Setup
         uses: ./tooling/github/setup
       - name: Set up Docker Buildx
@@ -153,7 +153,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - name: Setup
@@ -163,3 +163,65 @@ jobs:
         run: cp .env.example .env
       - name: Build
         run: pnpm turbo build --affected
+
+  memory-regression:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v6
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+      - name: Build Docker image
+        uses: docker/build-push-action@v7
+        with:
+          platforms: linux/amd64
+          context: .
+          push: false
+          load: true
+          tags: homarr-memory-test
+          network: host
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+        env:
+          SKIP_ENV_VALIDATION: true
+      - name: Start container and measure memory
+        run: |
+          docker run -d --name homarr-mem-test -p 17575:7575 homarr-memory-test
+          # Wait for container to be healthy (up to 60s)
+          healthy=false
+          for i in $(seq 1 30); do
+            if curl -sf http://localhost:17575/api/health 2>/dev/null; then
+              echo "Container healthy after $((i * 2))s"
+              healthy=true
+              break
+            fi
+            sleep 2
+          done
+          if [ "$healthy" != "true" ]; then
+            echo "ERROR: Container never became healthy"
+            docker logs homarr-mem-test --tail 50
+            exit 1
+          fi
+          # Warm up: hit the dashboard page a few times
+          for i in $(seq 1 5); do
+            curl -sf http://localhost:17575/ > /dev/null 2>&1 || true
+            sleep 2
+          done
+          # Measure RSS after warmup
+          MEM_KB=$(docker stats --no-stream --format '{{.MemUsage}}' homarr-mem-test | sed 's| /.*||')
+          echo "Raw memory: $MEM_KB"
+          # Convert to numeric MB (handles GiB and MiB suffixes)
+          MEM_NUM=$(echo "$MEM_KB" | awk '{
+            if ($0 ~ /GiB/) { gsub(/GiB/,""); print $1 * 1024 }
+            else if ($0 ~ /MiB/) { gsub(/MiB/,""); print $1 }
+            else if ($0 ~ /KiB/) { gsub(/KiB/,""); print $1 / 1024 }
+            else { print $1 / 1048576 }
+          }')
+          echo "Memory usage: ${MEM_NUM} MB"
+          MAX_MB=700
+          if awk "BEGIN {exit !($MEM_NUM > $MAX_MB)}"; then
+            echo "ERROR: Memory usage ${MEM_NUM} MB exceeds ${MAX_MB} MB threshold"
+            docker logs homarr-mem-test --tail 50
+            exit 1
+          fi
+          echo "Memory check passed: ${MEM_NUM} MB <= ${MAX_MB} MB"

.github/workflows/crowdin-schedule-download.yml

@@ -15,7 +15,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v7
+        uses: actions/checkout@v6
 
       - name: Obtain token
         id: obtainToken

.github/workflows/crowdin-upload.yml

@@ -18,7 +18,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v7
+        uses: actions/checkout@v6
 
       - name: Upload Crowdin translations
         uses: crowdin/github-action@v2

.github/workflows/deployment-beta-release.yml

@@ -26,7 +26,7 @@ jobs:
         with:
           args: "Beta release has been triggered: [run ${{ github.run_number }}](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }})"
       - name: Checkout repository
-        uses: actions/checkout@v7
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - name: Get Next Version

.github/workflows/deployment-docker-image.yml

@@ -57,7 +57,7 @@ jobs:
           client-id: ${{ secrets.RENOVATE_MERGE_APP_ID }}
           permission-contents: write # required to commit package.json & changelog changes, merge them to dev / next and publish the release
 
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
         if: env.SKIP_RELEASE == 'false'
         with:
           persist-credentials: false
@@ -119,7 +119,7 @@ jobs:
     outputs:
       digest: ${{ steps.build.outputs.digest }}
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
         with:
           ref: ${{ needs.release.outputs.git_ref }}
 
@@ -158,7 +158,7 @@ jobs:
     outputs:
       digest: ${{ steps.build.outputs.digest }}
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
         with:
           ref: ${{ needs.release.outputs.git_ref }}
 

.github/workflows/deployment-docs.yml

@@ -30,7 +30,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
       - name: Setup
         uses: ./tooling/github/setup
       - name: Build docs

.github/workflows/deployment-weekly-release.yml

@@ -29,7 +29,7 @@ jobs:
         with:
           args: "Automatic release has been triggered: [run ${{ github.run_number }}](${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }})"
       - name: Checkout repository
-        uses: actions/checkout@v7
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - name: Get Next Version

.github/workflows/docs-algolia-recrawl.yml

@@ -20,7 +20,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
 
       - name: Setup
         uses: ./tooling/github/setup

.github/workflows/docs-update-contributors.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
         with:
           ref: dev
 

.github/workflows/docs-update-openapi.yml

@@ -16,7 +16,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
         with:
           ref: dev
 

.github/workflows/on-pr-prebuilt-debian-validate.yml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 5
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
       - name: Validate prebuilt dependencies for amd64
         id: validate-amd64
         uses: ./.github/actions/prebuilt-debian
@@ -30,7 +30,7 @@ jobs:
     runs-on: ubuntu-24.04-arm
     timeout-minutes: 5
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
       - name: Validate prebuilt dependencies for arm64
         id: validate-arm64
         uses: ./.github/actions/prebuilt-debian

.github/workflows/on-pr-renovate-validate.yml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 2
     steps:
-      - uses: actions/checkout@v7
+      - uses: actions/checkout@v6
       - run: |
           npx --yes --package renovate -- \
               renovate-config-validator --strict .github/renovate.json5

.github/workflows/on-release.yml

@@ -52,7 +52,7 @@ jobs:
           permission-contents: write # required to commit to branch
           permission-pull-requests: write # required to create pr & enable automerge
       - name: Checkout code
-        uses: actions/checkout@v7
+        uses: actions/checkout@v6
         with:
           token: ${{ steps.obtainToken.outputs.token }}
           ref: dev

.github/workflows/update-contributors.yml

@@ -29,7 +29,7 @@ jobs:
           permission-pull-requests: write # required to create pr & enable automerge
 
       - name: Checkout repository
-        uses: actions/checkout@v7
+        uses: actions/checkout@v6
         env:
           GITHUB_TOKEN: ${{ steps.obtainToken.outputs.token }}
 

.github/workflows/update-integration-list.yml

@@ -28,7 +28,7 @@ jobs:
           permission-contents: write # required to commit to branch
           permission-pull-requests: write # required to create pr & enable automerge
       - name: Checkout code
-        uses: actions/checkout@v7
+        uses: actions/checkout@v6
         env:
           GITHUB_TOKEN: ${{ steps.obtainToken.outputs.token }}
       - name: Setup

CHANGELOG.md

@@ -1,15 +1,3 @@
-## [1.69.2](https://github.com/homarr-labs/homarr/compare/v1.69.1...v1.69.2) (2026-07-06)
-
-### Bug Fixes
-
-* **layout:** raise AppShellHeader z-index above Indicator dots ([687edb9](https://github.com/homarr-labs/homarr/commit/687edb9226307cb83986097abb24fe7f672e1778)), closes [#6194](https://github.com/homarr-labs/homarr/issues/6194)
-
-## [1.69.1](https://github.com/homarr-labs/homarr/compare/v1.69.0...v1.69.1) (2026-07-04)
-
-### Bug Fixes
-
-* unblock query cache mutations in demo mode and add cache buster ([#6176](https://github.com/homarr-labs/homarr/issues/6176)) ([a382c75](https://github.com/homarr-labs/homarr/commit/a382c75968e73bafff55b5890b1e95f0779b50d3))
-
 ## [1.69.0](https://github.com/homarr-labs/homarr/compare/v1.68.1...v1.69.0) (2026-07-03)
 
 ### Features

apps/docs/docs/integrations/immich/index.mdx

@@ -39,26 +39,13 @@ import { immichServerStatsWidget } from '../../widgets/immich-server-stats';
     'Scroll down to "API Keys"', 
     'Click "New API Key"', 
     'Enter a name, e.g. "Homarr"', 
-(
-
-  <span>
-
-    Select the following permissions:{" "}
-    <code>album.statistics</code>,{" "}
-    <code>album.read</code>,{" "}
-    <code>album.create</code>,{" "}
-    <code>user.read</code>,{" "}
-    <code>user.update</code>,{" "}
-    <code>asset.read</code>,{" "}
-    <code>asset.download</code>,{" "}
-    <code>asset.statistics</code>,{" "}
-    <code>server.statistics</code>,{" "}
-    <code>server.about</code>.
-    <br />
-    Additional permissions may be required depending on your Immich version. If you encounter authorization errors, grant any missing permissions requested by the server.
-  </span>
-
-),
+    (<span>
+      Select the following permissions:{" "}
+      <code>album.read</code>,{" "}
+      <code>user.read</code>,{" "}
+      <code>server.statistics</code>,{" "}
+      <code>asset.download</code>
+    </span>), 
     'Create the integration in Homarr and copy the API key to there'
     ]
-}]} />
+}]} />

apps/docs/docsearch.config.js

@@ -1,25 +1,18 @@
 // Algolia DocSearch crawler for homarr.dev
 // Crawler ID: cd77a285-2756-4557-bf21-ee703748df15
-// Paste this in the Algolia crawler editor.
+// DocSearch-managed crawlers: paste this in the Algolia crawler editor or send to DocSearch support.
+// Template: https://docsearch.algolia.com/docs/templates/#docusaurus-v3-template
+// Markdown indexing: https://www.algolia.com/doc/guides/algolia-ai/askai/guides/markdown-indexing
 
 new Crawler({
   appId: "N69WSPZTID",
   apiKey: "YOUR_CRAWLER_ADMIN_API_KEY",
-  indexPrefix: "",
-  rateLimit: 32,
-  maxDepth: 4,
+  rateLimit: 8,
+  maxDepth: 10,
   startUrls: ["https://homarr.dev/"],
   sitemaps: ["https://homarr.dev/sitemap.xml"],
   ignoreCanonicalTo: true,
   discoveryPatterns: ["https://homarr.dev/**"],
-  exclusionPatterns: [
-    "https://homarr.dev/docs/tags/**",
-    "https://homarr.dev/blog/tags/**",
-    "https://homarr.dev/blog/authors/**",
-    "https://homarr.dev/blog/archive/**",
-    "https://homarr.dev/search/**",
-    "https://homarr.dev/docs/category/**",
-  ],
   actions: [
     {
       indexName: "Docusaurus",
@@ -112,6 +105,7 @@ new Crawler({
       advancedSyntax: true,
       attributeCriteriaComputedByMinProximity: true,
       removeWordsIfNoResults: "allOptional",
+      separatorsToIndex: "_",
     },
     markdown: {
       attributesForFaceting: ["lang", "language", "version", "docusaurus_tag"],
@@ -125,10 +119,4 @@ new Crawler({
       advancedSyntax: false,
     },
   },
-  apiKey: "YOUR_CRAWLER_ADMIN_API_KEY",
-  schedule: "on saturday",
-  renderJavaScript: false,
-  maxUrls: null,
-  cache: { enabled: false },
-  safetyChecks: { beforeIndexPublishing: { maxLostRecordsPercentage: 99 } },
 });

apps/docs/docusaurus.config.ts

@@ -8,7 +8,7 @@ const config: Config = {
   tagline: "A simple yet powerful dashboard for your server.",
   url: "https://homarr.dev",
   baseUrl: "/",
-  trailingSlash: undefined,
+  trailingSlash: true,
   favicon: "img/logo.png",
   organizationName: "homarr-labs",
   projectName: "homarr",
@@ -79,27 +79,8 @@ const config: Config = {
         sitemap: {
           changefreq: "weekly",
           priority: 0.5,
-          ignorePatterns: ["/tags/**", "/docs/category/**"],
+          ignorePatterns: ["/tags/**"],
           filename: "sitemap.xml",
-          createSitemapItems: async ({ routes, siteConfig, defaultCreateSitemapItems }) => {
-            const items = await defaultCreateSitemapItems({ routes, siteConfig });
-            return items.map((item) => {
-              const path = new URL(item.url).pathname;
-              if (path === "/" || path === "") {
-                return { ...item, priority: 1.0, changefreq: "weekly" };
-              }
-              if (path.startsWith("/docs/")) {
-                return { ...item, priority: 0.7, changefreq: "monthly" };
-              }
-              if (path.startsWith("/blog/")) {
-                return { ...item, priority: 0.3, changefreq: "never" };
-              }
-              if (path.startsWith("/about-us")) {
-                return { ...item, priority: 0.4, changefreq: "yearly" };
-              }
-              return item;
-            });
-          },
         },
       } satisfies Preset.Options,
     ],

apps/docs/package.json

@@ -32,7 +32,7 @@
     "@scalar/api-reference-react": "catalog:",
     "@signalwire/docusaurus-plugin-llms-txt": "^1.2.2",
     "@tabler/icons-react": "catalog:",
-    "@tailwindcss/postcss": "^4.3.2",
+    "@tailwindcss/postcss": "^4.3.1",
     "clsx": "catalog:",
     "dayjs": "catalog:",
     "docusaurus-plugin-image-zoom": "^3.0.1",
@@ -43,8 +43,8 @@
     "random-word-slugs": "^0.1.7",
     "react": "catalog:",
     "react-dom": "catalog:",
-    "swiper": "^14.0.1",
-    "tailwindcss": "^4.3.2"
+    "swiper": "^12.2.0",
+    "tailwindcss": "^4.3.1"
   },
   "devDependencies": {
     "@docusaurus/module-type-aliases": "^3.10.1",

apps/docs/src/css/custom.css

@@ -1,7 +1,8 @@
-@import url("https://api.fontshare.com/v2/css?f[]=work-sans@2,1&display=swap");
 @import "tailwindcss/theme" layer(theme);
 @import "tailwindcss/utilities" layer(utilities);
 
+@import url(https://api.fontshare.com/v2/css?f[]=work-sans@2,1&display=swap);
+
 @custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));
 
 @theme {

apps/docs/tsconfig.json

@@ -1,6 +1,9 @@
 {
+  "extends": "@docusaurus/tsconfig",
   "compilerOptions": {
-    "target": "ES2022",
+    "ignoreDeprecations": "6.0",
+    "baseUrl": ".",
+    "target": "es5",
     "lib": ["dom", "dom.iterable", "esnext"],
     "allowJs": true,
     "skipLibCheck": true,
@@ -9,14 +12,10 @@
     "noEmit": true,
     "esModuleInterop": true,
     "module": "esnext",
-    "moduleResolution": "bundler",
     "resolveJsonModule": true,
     "isolatedModules": true,
     "jsx": "preserve",
     "incremental": true,
-    "paths": {
-      "@site/*": ["./*"]
-    },
   },
   "include": [
     "**/*.ts",

apps/nextjs/next.config.ts

@@ -5,9 +5,21 @@ import "@homarr/common/env";
 import "@homarr/core/infrastructure/logs/env";
 import "@homarr/docker/env";
 
+import { readFileSync } from "fs";
+
 import type { NextConfig } from "next";
 import createNextIntlPlugin from "next-intl/plugin";
 
+const homarrVersion = (() => {
+  for (const candidate of ["../../package.json", "./package.json"]) {
+    try {
+      const pkg = JSON.parse(readFileSync(candidate, "utf-8"));
+      if (pkg.name === "homarr") return pkg.version as string;
+    } catch {}
+  }
+  return "unknown";
+})();
+
 // Package path does not work... so we need to use relative path
 const withNextIntl = createNextIntlPlugin({
   requestConfig: "../../packages/translation/src/request.ts",
@@ -15,7 +27,7 @@ const withNextIntl = createNextIntlPlugin({
 
 const nextConfig: NextConfig = {
   env: {
-    HOMARR_VERSION: process.env.HOMARR_VERSION ?? "unknown",
+    HOMARR_VERSION: homarrVersion,
   },
   output: "standalone",
   reactStrictMode: true,
@@ -31,19 +43,9 @@ const nextConfig: NextConfig = {
   experimental: {
     optimizePackageImports: ["@mantine/core", "@mantine/hooks", "@tabler/icons-react"],
     turbopackFileSystemCacheForDev: true,
+    preloadEntriesOnStart: false,
     webpackMemoryOptimizations: true,
   },
-  turbopack: {
-    // ponytail: known Turbopack NFT warning from path.join(process.cwd(), …) in
-    // src/app/api/backup/{route,shared}.ts. No working placement in 16.2.x
-    // (see vercel/next.js#95125). Suppress until upstream fix lands.
-    ignoreIssue: [
-      {
-        path: "**/*",
-        title: "Encountered unexpected file in NFT list",
-      },
-    ],
-  },
   transpilePackages: ["@homarr/ui", "@homarr/notifications", "@homarr/modals", "@homarr/spotlight", "@homarr/widgets"],
   images: {
     localPatterns: [

apps/nextjs/package.json

@@ -4,7 +4,7 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "build": "HOMARR_VERSION=$(node -p \"require('../../package.json').version\") pnpm with-env next build",
+    "build": "pnpm with-env next build",
     "clean": "git clean -xdf .next .turbo node_modules",
     "dev": "pnpm with-env next dev",
     "format": "oxfmt .",

apps/nextjs/src/app/[locale]/_client-providers/query-cache-persister.ts

@@ -1,22 +1,39 @@
 import { createAsyncStoragePersister } from "@tanstack/query-async-storage-persister";
+import { TRPCClientError } from "@trpc/client";
 import superjson from "superjson";
 
 import { fetchApi } from "@homarr/api/client";
 import { getActiveQueryCacheBoardId, queryCacheStoragePrefix } from "@homarr/api/query-cache";
 
+// Set once the server rejects a persist mutation as read-only (demo mode),
+// so we stop retrying a mutation that can never succeed.
+let persistDisabled = false;
+
+const isReadOnlyError = (error: unknown) => error instanceof TRPCClientError && error.data?.code === "FORBIDDEN";
+
 const queryCacheStorage = {
   getItem: (_key: string) => null as string | null,
   async setItem(_key: string, value: string) {
+    if (persistDisabled) return;
     const boardId = getActiveQueryCacheBoardId();
     if (!boardId) return;
     await fetchApi.queryCache.setItem.mutate({ boardId, value }).catch((error) => {
+      if (isReadOnlyError(error)) {
+        persistDisabled = true;
+        return;
+      }
       console.warn("[query-cache] persist failed", error);
     });
   },
   async removeItem(_key: string) {
+    if (persistDisabled) return;
     const boardId = getActiveQueryCacheBoardId();
     if (!boardId) return;
     await fetchApi.queryCache.removeItem.mutate({ boardId }).catch((error) => {
+      if (isReadOnlyError(error)) {
+        persistDisabled = true;
+        return;
+      }
       console.warn("[query-cache] remove failed", error);
     });
   },

apps/nextjs/src/app/[locale]/_client-providers/trpc.tsx

@@ -24,7 +24,6 @@ import type { AppRouter } from "@homarr/api";
 import { clientApi } from "@homarr/api/client";
 import {
   isPersistableWidgetQueryKey,
-  queryCacheBuster,
   queryCacheDefaultGcTimeMs,
   queryCacheDefaultRefetchIntervalMs,
   queryCacheDefaultStaleTimeMs,
@@ -137,7 +136,6 @@ export function TRPCReactProvider(props: PropsWithChildren) {
         client={queryClient}
         persistOptions={{
           persister,
-          buster: queryCacheBuster,
           maxAge: queryCacheDefaultGcTimeMs,
           dehydrateOptions: {
             shouldDehydrateQuery: (query) =>

apps/nextjs/src/app/[locale]/boards/(content)/_creator.tsx

@@ -7,8 +7,7 @@ import "~/styles/gridstack.scss";
 
 import { dehydrate, HydrationBoundary } from "@tanstack/react-query";
 import type { PersistedClient } from "@tanstack/react-query-persist-client";
-import superjson from "superjson";
-import { queryCacheBuster } from "@homarr/api/query-cache";
+import SuperJSON from "superjson";
 import { getQueryClient } from "@homarr/api/server";
 import { IntegrationProvider } from "@homarr/auth/client";
 import { auth } from "@homarr/auth/next";
@@ -123,9 +122,8 @@ async function QueryCacheHydration({ userId, boardId }: { userId: string; boardI
     const serialized = await getQueryCacheAsync(userId, boardId);
     if (!serialized) return null;
 
-    const persisted = superjson.parse<PersistedClient | undefined>(serialized);
-    if (!persisted || persisted.buster !== queryCacheBuster) return null;
-    if (!persisted.clientState?.queries?.length) return null;
+    const persisted = SuperJSON.parse<PersistedClient>(serialized);
+    if (!persisted?.clientState?.queries?.length) return null;
 
     return <HydrationBoundary state={persisted.clientState} />;
   } catch (error) {

apps/nextjs/src/app/[locale]/boards/(content)/_header-actions.tsx

@@ -45,9 +45,7 @@ export const BoardContentHeaderActions = () => {
   const [isEditMode] = useEditMode();
   const board = useRequiredBoard();
   const { hasChangeAccess } = useBoardPermissions(board);
-  // Fall back to read-only if the query has no data (e.g. errored) so we never expose
-  // edit/save/settings UI that would then fail server-side.
-  const { data: demoReadOnly = true, isLoading } = clientApi.info.isDemoReadOnly.useQuery();
+  const { data: demoMode, isLoading } = clientApi.info.isDemoMode.useQuery();
 
   if (!hasChangeAccess || isLoading) {
     return <SelectBoardsMenu />;
@@ -57,9 +55,9 @@ export const BoardContentHeaderActions = () => {
     <>
       {isEditMode && <AddMenu />}
 
-      <EditModeMenu demoReadOnly={demoReadOnly} />
+      <EditModeMenu demoMode={demoMode ?? false} />
 
-      {!demoReadOnly && (
+      {!demoMode && (
         <OnboardingTour.Target id="board-settings">
           <HeaderButton href={`/boards/${board.name}/settings`}>
             <IconSettings stroke={1.5} />
@@ -160,7 +158,7 @@ const AddMenu = () => {
   );
 };
 
-const EditModeMenu = ({ demoReadOnly }: { demoReadOnly: boolean }) => {
+const EditModeMenu = ({ demoMode }: { demoMode: boolean }) => {
   const [isEditMode, { open, close }] = useEditMode();
   const board = useRequiredBoard();
   const utils = clientApi.useUtils();
@@ -190,11 +188,11 @@ const EditModeMenu = ({ demoReadOnly }: { demoReadOnly: boolean }) => {
 
   const toggle = useCallback(() => {
     if (isEditMode) {
-      if (demoReadOnly) return discardDemoChanges();
+      if (demoMode) return discardDemoChanges();
       return saveBoard(board);
     }
     open();
-  }, [board, isEditMode, demoReadOnly, saveBoard, open, discardDemoChanges]);
+  }, [board, isEditMode, demoMode, saveBoard, open, discardDemoChanges]);
 
   useHotkeys([[hotkeys.toggleBoardEdit, toggle]]);
   usePreventLeaveWithDirty(isEditMode);

apps/nextjs/src/app/api/backup/shared.ts

@@ -1,13 +1,11 @@
 import fs from "fs";
 import path from "path";
 
-export const findMigrationsFolder = () => {
-  const cwd = process.cwd();
-  const migrationsFolderCandidates = [
-    path.join(cwd, "db/migrations/sqlite"),
-    path.join(cwd, "packages/db/migrations/sqlite"),
-    path.resolve(cwd, "../../db/migrations/sqlite"),
-    "/app/db/migrations/sqlite",
-  ];
-  return migrationsFolderCandidates.find((candidate) => fs.existsSync(candidate));
-};
+const migrationsFolderCandidates = [
+  path.join(process.cwd(), "db/migrations/sqlite"),
+  path.join(process.cwd(), "packages/db/migrations/sqlite"),
+  path.resolve(process.cwd(), "../../db/migrations/sqlite"),
+  "/app/db/migrations/sqlite",
+];
+
+export const findMigrationsFolder = () => migrationsFolderCandidates.find((candidate) => fs.existsSync(candidate));

apps/nextjs/src/components/board/items/widget-context-menu.tsx

@@ -2,10 +2,10 @@
 
 import type { MutableRefObject, ReactNode } from "react";
 import { useCallback, useEffect, useMemo, useState } from "react";
-import { Group, Loader, Menu, Switch, Text } from "@mantine/core";
+import { Group, Menu, Switch, Text } from "@mantine/core";
 import { IconCopy, IconLayoutKanban, IconRefresh, IconSettings, IconTrash } from "@tabler/icons-react";
 import type { QueryClient } from "@tanstack/react-query";
-import { useIsFetching, useQueryClient } from "@tanstack/react-query";
+import { useQueryClient } from "@tanstack/react-query";
 
 import { clientApi } from "@homarr/api/client";
 import { useSession } from "@homarr/auth/client";
@@ -50,9 +50,8 @@ export const WidgetContextMenu = ({ item, widgetStateRef, children }: WidgetCont
   const queryClient = useQueryClient();
 
   const widgetQueryKey = useMemo(() => [["widget", item.kind]], [item.kind]);
-  const isWidgetFetching = useIsFetching({ queryKey: widgetQueryKey }) > 0;
   const handleRefetch = useCallback(() => {
-    void queryClient.refetchQueries({ queryKey: widgetQueryKey, type: "all" });
+    void queryClient.invalidateQueries({ queryKey: widgetQueryKey });
   }, [queryClient, widgetQueryKey]);
 
   const options = useMemo(
@@ -224,15 +223,11 @@ export const WidgetContextMenu = ({ item, widgetStateRef, children }: WidgetCont
 
         <>
           {(toggleOptions.length > 0 || visibleWidgetActions.length > 0 || isEditMode) && <Menu.Divider />}
-          <Menu.Item
-            leftSection={isWidgetFetching ? <Loader size={16} /> : <IconRefresh size={16} />}
-            onClick={handleRefetch}
-            disabled={isWidgetFetching}
-          >
+          <Menu.Item closeMenuOnClick leftSection={<IconRefresh size={16} />} onClick={handleRefetch}>
             <Group justify="space-between" wrap="nowrap">
               {tMenu("refresh")}
               <Text size="xs" c="dimmed">
-                <WidgetCacheAge queryClient={queryClient} queryKey={widgetQueryKey} isFetching={isWidgetFetching} />
+                <WidgetCacheAge queryClient={queryClient} queryKey={widgetQueryKey} />
               </Text>
             </Group>
           </Menu.Item>
@@ -270,24 +265,13 @@ export const WidgetContextMenu = ({ item, widgetStateRef, children }: WidgetCont
   );
 };
 
-const WidgetCacheAge = ({
-  queryClient,
-  queryKey,
-  isFetching,
-}: {
-  queryClient: QueryClient;
-  queryKey: unknown[];
-  isFetching: boolean;
-}) => {
-  // 1s tick for "just now" → "1s ago" label transition; isFetching prop handles refetch reactivity
+const WidgetCacheAge = ({ queryClient, queryKey }: { queryClient: QueryClient; queryKey: unknown[] }) => {
   const [, setTick] = useState(0);
   useEffect(() => {
     const id = setInterval(() => setTick((n) => n + 1), 1000);
     return () => clearInterval(id);
   }, []);
 
-  if (isFetching) return <Loader size={12} />;
-
   const timestamps = queryClient
     .getQueryCache()
     .findAll({ queryKey })

apps/nextjs/src/components/layout/header.tsx

@@ -18,7 +18,7 @@ interface Props {
 
 export const MainHeader = ({ logo, actions, hasNavigation = true }: Props) => {
   return (
-    <AppShellHeader maw="100vw" zIndex={201} style={{ overflowX: "hidden" }}>
+    <AppShellHeader maw="100vw" style={{ overflowX: "hidden" }}>
       <Group h="100%" gap="xl" px="md" justify="apart" wrap="nowrap">
         <Group h="100%" align="center" style={{ flex: 1 }} wrap="nowrap">
           {hasNavigation && <ClientBurger />}

deployments/prebuilt-debian/package.json

@@ -2,7 +2,7 @@
   "name": "homarr-prebuilt-debian",
   "private": true,
   "dependencies": {
-    "better-sqlite3": "^12.11.1"
+    "better-sqlite3": "^12.10.0"
   },
   "engines": {
     "node": ">=24.18.0",

deployments/prebuilt-debian/pnpm-lock.yaml

@@ -9,16 +9,16 @@ importers:
   .:
     dependencies:
       better-sqlite3:
-        specifier: ^12.11.1
-        version: 12.11.1
+        specifier: ^12.10.0
+        version: 12.10.0
 
 packages:
 
   base64-js@1.5.1:
     resolution: {integrity: sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==}
 
-  better-sqlite3@12.11.1:
-    resolution: {integrity: sha512-dq9AtApgg5PGFtBzPFSBl3HZQjHok5gaQCM6zh2Yk0aSmDCs1CbnVI8/HgASQkNKsWFpseIO9beg5xxpYhbIfA==}
+  better-sqlite3@12.10.0:
+    resolution: {integrity: sha512-CyzaZRQKyHkB2ZInfTTl2nvT33EbDpjkLEbE8/Zck3Ll6O0qqvuGdrJ45HgtH+HykRg88ITY3AdreBGN70aBSQ==}
     engines: {node: 20.x || 22.x || 23.x || 24.x || 25.x || 26.x}
 
   bindings@1.5.0:
@@ -148,7 +148,7 @@ snapshots:
 
   base64-js@1.5.1: {}
 
-  better-sqlite3@12.11.1:
+  better-sqlite3@12.10.0:
     dependencies:
       bindings: 1.5.0
       prebuild-install: 7.1.3

package.json

@@ -1,6 +1,6 @@
 {
   "name": "homarr",
-  "version": "1.69.2",
+  "version": "1.69.0",
   "private": true,
   "scripts": {
     "build": "cross-env CI=true turbo build",
@@ -43,7 +43,6 @@
     "@semantic-release/release-notes-generator": "catalog:",
     "@testcontainers/redis": "catalog:",
     "@turbo/gen": "catalog:",
-
     "@vitejs/plugin-react": "catalog:",
     "@vitest/coverage-v8": "catalog:",
     "@vitest/ui": "catalog:",

packages/api/src/env.ts

@@ -6,11 +6,9 @@ export const env = createEnv({
   server: {
     KUBERNETES_SERVICE_ACCOUNT_NAME: z.string().optional(),
     DEMO_MODE: createBooleanSchema(false),
-    DEMO_READ_ONLY: createBooleanSchema(true),
   },
   runtimeEnv: {
     KUBERNETES_SERVICE_ACCOUNT_NAME: process.env.KUBERNETES_SERVICE_ACCOUNT_NAME,
     DEMO_MODE: process.env.DEMO_MODE,
-    DEMO_READ_ONLY: process.env.DEMO_READ_ONLY,
   },
 });

packages/api/src/query-cache.ts

@@ -5,7 +5,6 @@ export const queryCacheDefaultRefetchIntervalMs = 30_000;
 export const queryCacheDefaultGcTimeMs = 1000 * 60 * 60 * 24;
 export const queryCacheMaxValueBytes = 1024 * 1024;
 export const queryCacheStoragePrefix = "homarr-widget-query";
-export const queryCacheBuster = "v2-superjson";
 
 let activeQueryCacheBoardId: string | null = null;
 

packages/api/src/router/info.ts

@@ -1,7 +1,7 @@
 import z from "zod/v4";
 
 import packageJson from "../../../../package.json";
-import { createTRPCRouter, isDemoMode, isDemoReadOnly, publicProcedure, protectedProcedure } from "../trpc";
+import { createTRPCRouter, isDemoMode, publicProcedure, protectedProcedure } from "../trpc";
 
 export const infoRouter = createTRPCRouter({
   getInfo: protectedProcedure
@@ -20,5 +20,4 @@ export const infoRouter = createTRPCRouter({
       };
     }),
   isDemoMode: publicProcedure.query(() => isDemoMode),
-  isDemoReadOnly: publicProcedure.query(() => isDemoReadOnly),
 });

packages/api/src/router/query-cache.ts

@@ -5,7 +5,7 @@ import { boards } from "@homarr/db/schema";
 import { removeQueryCacheAsync, setQueryCacheAsync } from "@homarr/redis";
 
 import { queryCacheDefaultGcTimeMs, queryCacheMaxValueBytes } from "../query-cache";
-import { createTRPCRouter, internalProcedure } from "../trpc";
+import { createTRPCRouter, publicProcedure } from "../trpc";
 import { throwIfActionForbiddenAsync } from "./board/board-access";
 
 const queryCacheBoardInput = z.object({
@@ -21,7 +21,7 @@ const validateBoardAccessAsync = async (ctx: Parameters<typeof throwIfActionForb
 };
 
 export const queryCacheRouter = createTRPCRouter({
-  setItem: internalProcedure.input(queryCacheSetInput).mutation(async ({ ctx, input }) => {
+  setItem: publicProcedure.input(queryCacheSetInput).mutation(async ({ ctx, input }) => {
     await validateBoardAccessAsync(ctx, input.boardId);
     const userId = ctx.session?.user.id ?? "anonymous";
     return {
@@ -34,7 +34,7 @@ export const queryCacheRouter = createTRPCRouter({
       ),
     };
   }),
-  removeItem: internalProcedure.input(queryCacheBoardInput).mutation(async ({ ctx, input }) => {
+  removeItem: publicProcedure.input(queryCacheBoardInput).mutation(async ({ ctx, input }) => {
     await validateBoardAccessAsync(ctx, input.boardId);
     const userId = ctx.session?.user.id ?? "anonymous";
     await removeQueryCacheAsync(userId, input.boardId);

packages/api/src/trpc.ts

@@ -95,12 +95,8 @@ export const createTRPCRouter = t.router;
 
 export const isDemoMode = env.DEMO_MODE;
 
-// The public "real demo" (demo + mock integrations) stays read-only, while preview
-// deployments run with DEMO_MODE + DEMO_READ_ONLY=false to allow mutations.
-export const isDemoReadOnly = env.DEMO_MODE && env.DEMO_READ_ONLY;
-
 const enforceDemoModeReadOnly = t.middleware(({ ctx, next, type }) => {
-  if (isDemoReadOnly && type === "mutation") {
+  if (env.DEMO_MODE && type === "mutation") {
     throw new TRPCError({
       code: "FORBIDDEN",
       message: "Mutations are disabled in demo mode",
@@ -109,7 +105,7 @@ const enforceDemoModeReadOnly = t.middleware(({ ctx, next, type }) => {
   return next({ ctx });
 });
 
-const baseProcedure = isDemoReadOnly ? t.procedure.use(enforceDemoModeReadOnly) : t.procedure;
+const baseProcedure = env.DEMO_MODE ? t.procedure.use(enforceDemoModeReadOnly) : t.procedure;
 
 /**
  * Public (unauthed) procedure
@@ -120,8 +116,6 @@ const baseProcedure = isDemoReadOnly ? t.procedure.use(enforceDemoModeReadOnly)
  */
 export const publicProcedure = baseProcedure;
 
-export const internalProcedure = t.procedure;
-
 const enforceUserIsAuthed = t.middleware(({ ctx, next }) => {
   if (!ctx.session?.user) {
     throw new TRPCError({ code: "UNAUTHORIZED" });

packages/common/src/cookie.ts

@@ -6,5 +6,5 @@ export function parseCookies(cookieString: string) {
 }
 
 export function setClientCookie(name: string, value: string, options: SerializeOptions = {}) {
-  document.cookie = stringifySetCookie({ name, value, ...options });
+  document.cookie = stringifySetCookie(name, value, options);
 }

packages/common/src/errors/http/handlers/axios-http-error-handler.ts

@@ -25,7 +25,7 @@ export class AxiosHttpErrorHandler extends HttpErrorHandler {
 
     return new RequestError(requestErrorInput, {
       cause: error,
-    }) as AnyRequestError;
+    });
   }
   handleResponseError(error: unknown): ResponseError | undefined {
     if (!(error instanceof AxiosError)) return undefined;

packages/common/src/errors/http/handlers/fetch-http-error-handler.ts

@@ -20,7 +20,7 @@ export class FetchHttpErrorHandler extends HttpErrorHandler {
     const result = matchErrorCode(error.cause.code);
     if (!result) return undefined;
 
-    return new RequestError(result, { cause: error }) as AnyRequestError;
+    return new RequestError(result, { cause: error });
   }
 
   /**
@@ -59,7 +59,7 @@ export const matchErrorCode = (code: string): AnyRequestErrorInput | undefined =
       type: key,
       reason: found[0] as RequestErrorReason<typeof key>,
       code: code as RequestErrorCode,
-    } as AnyRequestErrorInput;
+    };
   }
 
   return undefined;

packages/common/src/errors/http/handlers/node-fetch-http-error-handler.ts

@@ -30,7 +30,7 @@ export class NodeFetchHttpErrorHandler extends HttpErrorHandler {
 
     return new RequestError(requestErrorInput, {
       cause: error,
-    }) as AnyRequestError;
+    });
   }
 
   /**

packages/db/migrations/mysql/0042_add_widget_secret.sql

@@ -1,9 +0,0 @@
-CREATE TABLE `widget_secret` (
-	`item_id` varchar(64) NOT NULL,
-	`kind` varchar(64) NOT NULL,
-	`value` text NOT NULL,
-	`updated_at` timestamp NOT NULL,
-	CONSTRAINT `widget_secret_item_id_kind_pk` PRIMARY KEY(`item_id`,`kind`)
-);
---> statement-breakpoint
-ALTER TABLE `widget_secret` ADD CONSTRAINT `widget_secret_item_id_item_id_fk` FOREIGN KEY (`item_id`) REFERENCES `item`(`id`) ON DELETE cascade ON UPDATE no action;

packages/db/migrations/mysql/meta/_journal.json

@@ -295,13 +295,6 @@
       "when": 1780764500000,
       "tag": "0041_merge_custom_widget_url",
       "breakpoints": true
-    },
-    {
-      "idx": 42,
-      "version": "5",
-      "when": 1783176100870,
-      "tag": "0042_add_widget_secret",
-      "breakpoints": true
     }
   ]
 }

packages/db/migrations/postgresql/0008_add_widget_secret.sql

@@ -1,9 +0,0 @@
-CREATE TABLE "widget_secret" (
-	"item_id" varchar(64) NOT NULL,
-	"kind" varchar(64) NOT NULL,
-	"value" text NOT NULL,
-	"updated_at" timestamp NOT NULL,
-	CONSTRAINT "widget_secret_item_id_kind_pk" PRIMARY KEY("item_id","kind")
-);
---> statement-breakpoint
-ALTER TABLE "widget_secret" ADD CONSTRAINT "widget_secret_item_id_item_id_fk" FOREIGN KEY ("item_id") REFERENCES "public"."item"("id") ON DELETE cascade ON UPDATE no action;

packages/db/migrations/postgresql/meta/_journal.json

@@ -57,13 +57,6 @@
       "when": 1780764500000,
       "tag": "0007_merge_custom_widget_url",
       "breakpoints": true
-    },
-    {
-      "idx": 8,
-      "version": "7",
-      "when": 1783176100870,
-      "tag": "0008_add_widget_secret",
-      "breakpoints": true
     }
   ]
 }

packages/db/migrations/sqlite/0040_add_widget_secret.sql

@@ -1,8 +0,0 @@
-CREATE TABLE `widget_secret` (
-	`item_id` text NOT NULL,
-	`kind` text NOT NULL,
-	`value` text NOT NULL,
-	`updated_at` integer NOT NULL,
-	PRIMARY KEY(`item_id`, `kind`),
-	FOREIGN KEY (`item_id`) REFERENCES `item`(`id`) ON UPDATE no action ON DELETE cascade
-);

packages/db/migrations/sqlite/meta/_journal.json

@@ -281,13 +281,6 @@
       "when": 1780764500000,
       "tag": "0039_merge_custom_widget_url",
       "breakpoints": true
-    },
-    {
-      "idx": 40,
-      "version": "6",
-      "when": 1783176100870,
-      "tag": "0040_add_widget_secret",
-      "breakpoints": true
     }
   ]
 }

packages/definitions/src/docs/homarr-docs-sitemap.ts

@@ -60,8 +60,8 @@ export type HomarrDocumentationPath =
   | "/docs/tags/connections"
   | "/docs/tags/custom-widgets"
   | "/docs/tags/customization"
-  | "/docs/tags/data"
   | "/docs/tags/data-sources"
+  | "/docs/tags/data"
   | "/docs/tags/database"
   | "/docs/tags/developer"
   | "/docs/tags/development"
@@ -99,8 +99,8 @@ export type HomarrDocumentationPath =
   | "/docs/tags/redis"
   | "/docs/tags/responsive"
   | "/docs/tags/roles"
-  | "/docs/tags/search"
   | "/docs/tags/search-engines"
+  | "/docs/tags/search"
   | "/docs/tags/secrets"
   | "/docs/tags/security"
   | "/docs/tags/self-signed"
@@ -132,6 +132,15 @@ export type HomarrDocumentationPath =
   | "/docs/advanced/running-as-different-user"
   | "/docs/advanced/single-sign-on"
   | "/docs/advanced/styling"
+  | "/docs/category/advanced"
+  | "/docs/category/community"
+  | "/docs/category/developer-guides"
+  | "/docs/category/getting-started"
+  | "/docs/category/installation-1"
+  | "/docs/category/installation"
+  | "/docs/category/integrations"
+  | "/docs/category/management"
+  | "/docs/category/widgets"
   | "/docs/community/donate"
   | "/docs/community/faq"
   | "/docs/community/get-in-touch"

packages/forms-collection/src/new-app/_form.tsx

@@ -72,14 +72,7 @@ export const AppForm = ({
     }
 
     form.initialize(toFormValues(initialValues));
-    // `form` is a new object every render (Mantine useForm returns a fresh literal),
-    // so it must not be a dep here — it would re-run every render and, since
-    // form.initialize() always calls clearErrors() (new {} object) internally,
-    // trigger an infinite update loop. initialValuesKey (a primitive string)
-    // already captures the only case this effect exists for: re-initializing
-    // when initialValues actually changes (e.g. navigating between edit pages).
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [initialValuesKey]);
+  }, [initialValuesKey, form, initialValues]);
 
   // Debounce the name value with 200ms delay
   const [debouncedName] = useDebouncedValue(form.values.name, 200);

packages/integrations/src/gluetun/gluetun-types.ts

@@ -46,7 +46,7 @@ const gluetunServerSelectionSchema = z.object({
   isps: z.array(z.string()).nullable(),
   names: z.array(z.string()).nullable(),
   numbers: z.array(z.number()).nullable(),
-  hostnames: z.array(z.string()).nullable(),
+  hostnames: z.array(z.string()),
   owned_only: z.boolean(),
   free_only: z.boolean(),
   premium_only: z.boolean(),
@@ -65,7 +65,7 @@ const gluetunPortForwardingSchema = z.object({
   status_file_path: z.string(),
   up_command: z.string(),
   down_command: z.string(),
-  listening_port: z.union([z.number(), z.array(z.number())]),
+  listening_port: z.number(),
   username: z.string(),
   password: z.string(),
 });
@@ -98,7 +98,7 @@ const gluetunOpenvpnSettingsSchema = z.object({
 const gluetunWireguardSettingsSchema = z.object({
   private_key: z.string(),
   pre_shared_key: z.string(),
-  addresses: z.array(z.string()).nullable(),
+  addresses: z.array(z.string()),
   allowed_ips: z.array(z.string()),
   interface: z.string(),
   persistent_keep_alive_interval: z.number(),

packages/integrations/src/gluetun/test/gluetun-integration.spec.ts

@@ -124,126 +124,6 @@ const VPN_SETTINGS_PAYLOAD = {
   },
 };
 
-const ALT_VPN_SETTINGS_PAYLOAD = {
-  type: "openvpn",
-  provider: {
-    name: "custom",
-    server_selection: {
-      vpn: "openvpn",
-      countries: null,
-      categories: null,
-      regions: null,
-      cities: null,
-      isps: null,
-      names: null,
-      numbers: null,
-      hostnames: null,
-      owned_only: false,
-      free_only: false,
-      premium_only: false,
-      stream_only: false,
-      multi_hop_only: false,
-      port_forward_only: false,
-      secure_core_only: false,
-      tor_only: false,
-      openvpn: {
-        config_file_path: "/gluetun/custom.conf",
-        protocol: "tcp",
-        endpoint_ip: "0.0.0.0",
-        custom_port: 0,
-        pia_encryption_preset: "",
-      },
-      wireguard: {
-        endpoint_ip: "0.0.0.0",
-        endpoint_port: 0,
-        public_key: "",
-      },
-    },
-    port_forwarding: {
-      enabled: false,
-      provider: "",
-      status_file_path: "/tmp/gluetun/forwarded_port",
-      up_command: "",
-      down_command: "",
-      listening_port: [0],
-      ports_count: 0,
-      username: "",
-      password: "",
-    },
-  },
-  amneziawg: {
-    wireguard: {
-      private_key: "",
-      pre_shared_key: "",
-      addresses: null,
-      allowed_ips: ["0.0.0.0/0", "::/0"],
-      interface: "tun0",
-      persistent_keep_alive_interval: 0,
-      mtu: 0,
-      implementation: "userspace",
-    },
-    junk_packet_count: 0,
-    junk_packet_min: 0,
-    junk_packet_max: 0,
-    padding_s1: 0,
-    padding_s2: 0,
-    padding_s3: 0,
-    padding_s4: 0,
-    header_h1: "",
-    header_h2: "",
-    header_h3: "",
-    header_h4: "",
-    init_packet_i1: "",
-    init_packet_i2: "",
-    init_packet_i3: "",
-    init_packet_i4: "",
-    init_packet_i5: "",
-  },
-  openvpn: {
-    version: "2.6",
-    user: "",
-    password: "",
-    config_file_path: "/gluetun/custom.conf",
-    ciphers: null,
-    auth: "",
-    cert: "",
-    key: "",
-    encrypted_key: "",
-    key_passphrase: "",
-    pia_encryption_preset: "",
-    mssfix: 0,
-    interface: "tun0",
-    process_user: "nonrootuser",
-    verbosity: 1,
-    flags: null,
-  },
-  wireguard: {
-    private_key: "",
-    pre_shared_key: "",
-    addresses: null,
-    allowed_ips: ["0.0.0.0/0", "::/0"],
-    interface: "tun0",
-    persistent_keep_alive_interval: 0,
-    mtu: 0,
-    implementation: "auto",
-  },
-  pmtud: {
-    icmp_addresses: ["1.1.1.1", "8.8.8.8"],
-    tcp_addresses: [
-      "1.1.1.1:443",
-      "8.8.8.8:443",
-      "1.1.1.1:53",
-      "8.8.8.8:53",
-      "[2606:4700:4700::1111]:53",
-      "[2001:4860:4860::8888]:53",
-      "[2606:4700:4700::1111]:443",
-      "[2001:4860:4860::8888]:443",
-    ],
-  },
-  up_command: "",
-  down_command: "",
-};
-
 const jsonResponse = (body: unknown, init: ResponseInit = { status: 200 }): FetchResponse =>
   new Response(JSON.stringify(body), {
     ...init,
@@ -488,54 +368,4 @@ describe("gluetun schemas", () => {
   test("vpn settings schema rejects a non-string type", () => {
     expect(() => gluetunVpnSettingsSchema.parse({ ...VPN_SETTINGS_PAYLOAD, type: 1 })).toThrow();
   });
-
-  test("vpn settings schema parses the live gluetun-latest custom/OpenVPN payload", () => {
-    const parsed = gluetunVpnSettingsSchema.parse(ALT_VPN_SETTINGS_PAYLOAD);
-    expect(parsed.type).toBe("openvpn");
-    expect(parsed.provider.name).toBe("custom");
-  });
-
-  test("vpn settings schema accepts null server-selection hostnames", () => {
-    const payload = {
-      ...VPN_SETTINGS_PAYLOAD,
-      provider: {
-        ...VPN_SETTINGS_PAYLOAD.provider,
-        server_selection: {
-          ...VPN_SETTINGS_PAYLOAD.provider.server_selection,
-          hostnames: null,
-        },
-      },
-    };
-
-    expect(() => gluetunVpnSettingsSchema.parse(payload)).not.toThrow();
-  });
-
-  test("vpn settings schema accepts listening_port as a number or a list", () => {
-    const asList = {
-      ...VPN_SETTINGS_PAYLOAD,
-      provider: {
-        ...VPN_SETTINGS_PAYLOAD.provider,
-        port_forwarding: {
-          ...VPN_SETTINGS_PAYLOAD.provider.port_forwarding,
-          listening_port: [0],
-        },
-      },
-    };
-
-    // The happy-path fixture already exercises the scalar form (listening_port: 0).
-    expect(() => gluetunVpnSettingsSchema.parse(VPN_SETTINGS_PAYLOAD)).not.toThrow();
-    expect(() => gluetunVpnSettingsSchema.parse(asList)).not.toThrow();
-  });
-
-  test("vpn settings schema accepts null wireguard addresses", () => {
-    const payload = {
-      ...VPN_SETTINGS_PAYLOAD,
-      wireguard: {
-        ...VPN_SETTINGS_PAYLOAD.wireguard,
-        addresses: null,
-      },
-    };
-
-    expect(() => gluetunVpnSettingsSchema.parse(payload)).not.toThrow();
-  });
 });

packages/request-handler/src/lib/integration-request-handler.ts

@@ -14,17 +14,28 @@ interface Options<TData, TKind extends IntegrationKind, TInput extends Record<st
   requestAsync: (integration: IntegrationOfKind<TKind>, input: TInput) => Promise<TData>;
 }
 
+let integrationHandlerCounter = 0;
+
 export const createIntegrationRequestHandler = <
   TData,
   TKind extends IntegrationKind,
   TInput extends Record<string, unknown>,
 >(
   options: Options<TData, TKind, TInput>,
-) => ({
-  handler: (integration: IntegrationOfKind<TKind>, itemOptions: TInput) => {
-    const inner = createRequestHandler<TData, { integrationId: string; options: TInput }>({
-      requestAsync: async (input) => options.requestAsync(integration, input.options),
-    });
-    return inner.handler({ integrationId: integration.id, options: itemOptions });
-  },
-});
+) => {
+  // Stable per handler definition: the inner request handler is re-created on every
+  // call, so without an explicit cacheKey each call would get a fresh namespace
+  // (no cache hits) — and without any namespace different handlers hitting the same
+  // integration with equal options would share cache entries and cross their data.
+  const cacheKey = `integration-handler-${integrationHandlerCounter++}`;
+
+  return {
+    handler: (integration: IntegrationOfKind<TKind>, itemOptions: TInput) => {
+      const inner = createRequestHandler<TData, { integrationId: string; options: TInput }>({
+        cacheKey,
+        requestAsync: async (input) => options.requestAsync(integration, input.options),
+      });
+      return inner.handler({ integrationId: integration.id, options: itemOptions });
+    },
+  };
+};

packages/request-handler/src/lib/request-handler.ts

@@ -1,51 +1,65 @@
 interface Options<TData, TInput extends Record<string, unknown>> {
   requestAsync: (input: TInput) => Promise<TData>;
   cacheTtlMs?: number;
+  /**
+   * Namespace for cache entries of this handler. Defaults to a unique id per
+   * createRequestHandler call. Callers that re-create handlers per request
+   * (e.g. createIntegrationRequestHandler) must pass a stable key themselves,
+   * otherwise the cache never hits.
+   */
+  cacheKey?: string;
 }
 
 type CacheEntry<TData> = { data: TData; timestamp: Date; expiresAt: number };
 
 const MAX_CACHE_SIZE = 1000;
+const cache = new Map<string, CacheEntry<unknown>>();
+const inflight = new Map<string, Promise<CacheEntry<unknown>>>();
+
 const DEFAULT_TTL_MS = 10_000;
 
-const evictExpired = <TData>(cache: Map<string, CacheEntry<TData>>) => {
+const evictExpired = () => {
   const now = Date.now();
   for (const [key, entry] of cache) {
     if (now >= entry.expiresAt) cache.delete(key);
   }
 };
 
+let autoCacheKeyCounter = 0;
+
 export const createRequestHandler = <TData, TInput extends Record<string, unknown>>(
   options: Options<TData, TInput>,
 ) => {
-  const cache = new Map<string, CacheEntry<TData>>();
-  const inflight = new Map<string, Promise<CacheEntry<TData>>>();
+  // The cache map is shared between all handlers, so entries have to be namespaced
+  // per handler — otherwise handlers receiving the same input (e.g. the same
+  // integrationId with empty options) would read each other's data.
+  const cacheKey = options.cacheKey ?? `handler-${autoCacheKeyCounter++}`;
 
   return {
     handler: (input: TInput) => ({
       async getDataAsync(): Promise<{ data: TData; timestamp: Date }> {
         const ttl = options.cacheTtlMs ?? DEFAULT_TTL_MS;
-        const key = JSON.stringify(input);
+        const key = `${cacheKey}:${JSON.stringify(input)}`;
 
-        const cached = cache.get(key);
+        const cached = cache.get(key) as CacheEntry<TData> | undefined;
         if (cached && Date.now() < cached.expiresAt) {
           return { data: cached.data, timestamp: cached.timestamp };
         }
         if (cached) cache.delete(key);
 
         const existing = inflight.get(key);
-        if (existing) return existing;
+        if (existing) return existing as Promise<CacheEntry<TData>>;
 
         const promise = options
           .requestAsync(input)
           .then((data) => {
-            if (cache.size >= MAX_CACHE_SIZE) evictExpired(cache);
+            if (cache.size >= MAX_CACHE_SIZE) evictExpired();
             if (cache.size >= MAX_CACHE_SIZE) {
               const oldest = cache.keys().next().value;
               if (oldest) cache.delete(oldest);
             }
             const entry: CacheEntry<TData> = { data, timestamp: new Date(), expiresAt: Date.now() + ttl };
-            cache.set(key, entry);
+            cache.set(key, entry as CacheEntry<unknown>);
             inflight.delete(key);
             return entry;
           })
@@ -54,7 +68,7 @@ export const createRequestHandler = <TData, TInput extends Record<string, unknow
             throw err;
           });
 
-        inflight.set(key, promise);
+        inflight.set(key, promise as Promise<CacheEntry<unknown>>);
         return promise;
       },
     }),

packages/translation/src/lang/fr.json

@@ -732,8 +732,8 @@
       "displayType": "",
       "jsonPath": "",
       "jsonPathHint": "",
-      "label": "Étiquette",
-      "unit": "Unité",
+      "label": "",
+      "unit": "",
       "mappings": "",
       "tablePath": "",
       "tablePathHint": "",
@@ -755,14 +755,14 @@
       "striped": "",
       "compact": "",
       "maxHeight": "",
-      "color": "Couleur",
+      "color": "",
       "buttonLabel": "",
       "buttonColor": "",
-      "confirmText": "Texte de confirmation",
+      "confirmText": "",
       "confirmTextHint": "",
-      "successMessage": "Message de réussite",
+      "successMessage": "",
       "successMessageHint": "",
-      "enabled": "Activé",
+      "enabled": "",
       "template": {
         "label": "",
         "description": ""
@@ -1017,13 +1017,13 @@
       "timetable": "",
       "photoService": "",
       "documents": "",
-      "notes": "Notes",
-      "mediaMonitoring": "Supervision",
-      "speedtest": "Test de débit",
+      "notes": "",
+      "mediaMonitoring": "",
+      "speedtest": "",
       "analytics": "",
       "vpn": "",
-      "mediaLibrary": "Bibliothèque de médias",
-      "uptimeMonitoring": "Surveillance des disponibilités"
+      "mediaLibrary": "",
+      "uptimeMonitoring": ""
     },
     "testConnection": {
       "action": {
@@ -1298,7 +1298,7 @@
           "newLabel": "Nouvelle clé privée"
         },
         "slug": {
-          "label": "Slug de la page de statut",
+          "label": "",
           "newLabel": ""
         }
       }

packages/translation/src/lang/it.json

@@ -1599,7 +1599,7 @@
     "menu": {
       "label": {
         "settings": "Impostazioni",
-        "refresh": "Aggiorna",
+        "refresh": "",
         "options": "Opzioni",
         "actions": "Azioni"
       }
@@ -1904,7 +1904,7 @@
       "noStation": "Nessuna stazione selezionata",
       "option": {
         "baseUrl": {
-          "label": "Url Search.ch"
+          "label": ""
         },
         "station": {
           "label": "Stazione"
@@ -2791,8 +2791,8 @@
           "description": "Visualizza la data dell'immagine e l'indice corrente nella parte inferiore della presentazione"
         },
         "randomizePhotos": {
-          "label": "Immagini casuali",
-          "description": "Mostra le foto in ordine casuale invece di iniziare sempre con lo stesso ordine degli album."
+          "label": "",
+          "description": ""
         }
       },
       "description": "Presentazione delle immagini nel tuo album Immich",
@@ -3158,7 +3158,7 @@
             "label": "Provider"
           },
           "providerUrl": {
-            "label": "URL Provider"
+            "label": ""
           },
           "identifier": {
             "label": "Identificatore",
@@ -3209,10 +3209,10 @@
             "tooltip": "Impossibile analizzare il provider, impostarlo manualmente dopo aver importato le immagini"
           },
           "tokens": {
-            "label": "Token Provider",
-            "token": "Token",
-            "configured": "Token configurato",
-            "notConfigured": "Nessun token impostato",
+            "label": "",
+            "token": "",
+            "configured": "",
+            "notConfigured": "",
             "save": "Salva"
           }
         }
@@ -3236,9 +3236,9 @@
           "invalidIdentifier": "Identificatore non valido",
           "noMatchingVersion": "Nessuna versione corrispondente trovata",
           "noReleasesFound": "Nessun rilascio trovato",
-          "noProviderSelected": "Nessun provider selezionato",
+          "noProviderSelected": "",
           "noProviderResponse": "Nessuna risposta dal provider",
-          "unexpected": "Errore provider inaspettato"
+          "unexpected": ""
         }
       }
     },

packages/translation/src/lang/lv.json

@@ -6,9 +6,9 @@
         "subtitle": "",
         "description": "",
         "action": {
-          "scratch": "Sākt no jauna",
+          "scratch": "",
           "importOldmarr": "",
-          "restoreSqlite": "SQLite rezerves kopija",
+          "restoreSqlite": "",
           "restoreSqliteDescription": "",
           "backToOptions": ""
         }
@@ -26,19 +26,19 @@
           }
         },
         "importSettings": {
-          "title": "Importēt iestatījumus",
+          "title": "",
           "description": ""
         },
         "boardSelection": {
           "title": "",
           "description": "",
           "action": {
-            "selectAll": "Atzīmēt visu",
+            "selectAll": "",
             "unselectAll": ""
           }
         },
         "summary": {
-          "title": "Importēšanas kopsavilkums",
+          "title": "",
           "description": "",
           "action": {
             "import": ""
@@ -46,7 +46,7 @@
           "entities": {
             "apps": "Lietotnes",
             "boards": "Dēļi",
-            "integrations": "Integrācijas",
+            "integrations": "",
             "credentialUsers": ""
           }
         },
@@ -67,15 +67,15 @@
         }
       },
       "user": {
-        "title": "Administratora lietotājs",
+        "title": "",
         "subtitle": "",
         "notification": {
           "success": {
-            "title": "Lietotājs izveidots",
+            "title": "",
             "message": ""
           },
           "error": {
-            "title": "Lietotāja izveide neizdevās"
+            "title": ""
           }
         }
       },
@@ -94,19 +94,19 @@
         "subtitle": ""
       },
       "integrations": {
-        "title": "Integrācijas",
+        "title": "",
         "subtitle": "",
         "description": "",
         "action": {
-          "continue": "Turpināt",
-          "skip": "Pagaidām izlaist šo soli"
+          "continue": "",
+          "skip": ""
         },
         "configure": {
-          "progress": "{current} no {total}",
-          "skip": "Izlaist šo integrāciju",
+          "progress": "",
+          "skip": "",
           "finishing": "",
           "error": {
-            "title": "Neizdevās iestatīt!",
+            "title": "",
             "message": ""
           },
           "helpers": {
@@ -115,7 +115,7 @@
           }
         },
         "urlTemplate": {
-          "label": "Bāzes URL",
+          "label": "",
           "placeholder": "",
           "hint": "",
           "warning": "",
@@ -136,14 +136,14 @@
         }
       },
       "finish": {
-        "title": "Pabeigt Iestatīšanu",
+        "title": "",
         "subtitle": "",
         "description": "",
         "action": {
           "goToBoard": "",
           "createBoard": "",
-          "inviteUser": "Ielūgt citus lietotājus",
-          "docs": "Lasīt dokumentāciju"
+          "inviteUser": "",
+          "docs": ""
         }
       }
     },
@@ -158,7 +158,7 @@
         "subtitle": ""
       },
       "invite": {
-        "title": "Pievienoties Homarr",
+        "title": "",
         "subtitle": "",
         "description": ""
       },
@@ -177,20 +177,20 @@
       },
       "password": {
         "label": "Parole",
-        "suggestionsTitle": "Paroles ieteikumi",
+        "suggestionsTitle": "",
         "suggestion": {
-          "length": "Vismaz 8 rakstzīmes",
+          "length": "",
           "lowercase": "Ietver mazo burtu",
           "uppercase": "Ietver lielo burtu",
           "number": "Ietver numuru",
-          "special": "Iekļauj speciālo simbolu"
+          "special": ""
         }
       },
       "passwordConfirm": {
         "label": "Apstipriniet paroli"
       },
       "previousPassword": {
-        "label": "Iepriekšējā parole"
+        "label": ""
       },
       "homeBoard": {
         "label": ""
@@ -218,10 +218,10 @@
         "notification": {
           "success": {
             "title": "",
-            "message": "Jūs esat veiksmīgi pieteicies"
+            "message": ""
           },
           "error": {
-            "title": "Pieteikšanās neizdevās",
+            "title": "",
             "message": ""
           }
         },
@@ -245,13 +245,13 @@
       },
       "create": "Izveidot lietotāju",
       "changePassword": {
-        "label": "Mainīt paroli",
+        "label": "",
         "notification": {
           "success": {
-            "message": "Parole veiksmīgi nomainīta."
+            "message": ""
           },
           "error": {
-            "message": "Nav iespējams nomainīt paroli"
+            "message": ""
           }
         }
       },
@@ -595,12 +595,12 @@
       }
     },
     "defaultGroup": {
-      "name": "Noklusētā grupa",
+      "name": "",
       "description": ""
     }
   },
   "app": {
-    "search": "Atrast aplikāciju",
+    "search": "",
     "page": {
       "list": {
         "title": "Lietotnes",
@@ -689,7 +689,7 @@
       "list": {
         "title": "",
         "noResults": "",
-        "loading": "Notiek ielāde..."
+        "loading": ""
       },
       "create": {
         "title": "",
@@ -700,7 +700,7 @@
       }
     },
     "action": {
-      "create": "Izveidot",
+      "create": "",
       "import": "",
       "save": "",
       "delete": "",

packages/translation/src/lang/pl.json

@@ -1599,7 +1599,7 @@
     "menu": {
       "label": {
         "settings": "Ustawienia",
-        "refresh": "Odśwież",
+        "refresh": "",
         "options": "Opcje",
         "actions": "Akcje"
       }
@@ -1904,7 +1904,7 @@
       "noStation": "Nie wybrano stacji",
       "option": {
         "baseUrl": {
-          "label": "Szukaj adresu URL"
+          "label": ""
         },
         "station": {
           "label": "Stacja"
@@ -2791,8 +2791,8 @@
           "description": "Wyświetl datę zdjęcia oraz bieżący indeks na dole pokazu slajdów"
         },
         "randomizePhotos": {
-          "label": "Losowe zdjęcia",
-          "description": "Pokaż zdjęcia w losowej kolejności, zamiast zawsze rozpoczynać się od tej samej kolejności albumu."
+          "label": "",
+          "description": ""
         }
       },
       "description": "Pokaz slajdów zdjęć z Twojego albumu w Immich",
@@ -3158,7 +3158,7 @@
             "label": "Dostawca"
           },
           "providerUrl": {
-            "label": "URL dostawcy"
+            "label": ""
           },
           "identifier": {
             "label": "Identyfikator",
@@ -3209,11 +3209,11 @@
             "tooltip": "Nie udało się rozpoznać dostawcy. Ustaw go ręcznie po zaimportowaniu obrazów."
           },
           "tokens": {
-            "label": "Tokeny dostawcy",
-            "token": "Token",
-            "configured": "Token skonfigurowany",
-            "notConfigured": "Brak ustawionych tokenów",
-            "save": "Zapisz"
+            "label": "",
+            "token": "",
+            "configured": "",
+            "notConfigured": "",
+            "save": ""
           }
         }
       },
@@ -3236,9 +3236,9 @@
           "invalidIdentifier": "Nieprawidłowy identyfikator",
           "noMatchingVersion": "Nie znaleziono pasującej wersji",
           "noReleasesFound": "Nie znaleziono wydań!",
-          "noProviderSelected": "Nie wybrano dostawcy",
+          "noProviderSelected": "",
           "noProviderResponse": "Brak odpowiedzi od dostawcy",
-          "unexpected": "Nieoczekiwany błąd dostawcy"
+          "unexpected": ""
         }
       }
     },

packages/translation/src/lang/uk.json

@@ -3132,7 +3132,7 @@
           "label": ""
         },
         "showOnlyIcon": {
-          "label": "Показати тільки іконку"
+          "label": ""
         },
         "topReleases": {
           "label": "",
@@ -3229,7 +3229,7 @@
       "openReleasePage": "",
       "releaseDescription": "",
       "projectDescription": "",
-      "created": "Створено",
+      "created": "",
       "error": {
         "label": "",
         "messages": {
@@ -3350,7 +3350,7 @@
           "label": ""
         }
       },
-      "latestResult": "Останній результат",
+      "latestResult": "",
       "averages": "",
       "tests": "",
       "recentResults": "",
@@ -3437,7 +3437,7 @@
           "description": ""
         },
         "maxNowPlayingItems": {
-          "label": "Максимум елементів для відтворення",
+          "label": "",
           "description": ""
         },
         "showLibraryCount": {

packages/widgets/src/_inputs/widget-multiReleasesRepositories-input.tsx

@@ -50,7 +50,6 @@ import {
 } from "@homarr/definitions";
 import { findBestIconMatch, IconPicker } from "@homarr/forms-collection";
 import { createModal, useModalAction } from "@homarr/modals";
-import { showErrorNotification } from "@homarr/notifications";
 import { useScopedI18n } from "@homarr/translation/client";
 import { MaskedImage } from "@homarr/ui";
 
@@ -270,24 +269,8 @@ const providersWithAuth: ReleaseProviderKind[] = [
 const ProviderTokensSection = ({ itemId, repositories }: { itemId: string; repositories: ReleasesRepository[] }) => {
   const tRepository = useScopedI18n("widget.releases.option.repositories");
   const { data: configuredKinds = [], refetch } = clientApi.widget.secrets.getConfiguredKinds.useQuery({ itemId });
-  const setSecret = clientApi.widget.secrets.setSecret.useMutation({
-    onSuccess: () => refetch(),
-    onError: (error) => {
-      showErrorNotification({
-        title: "Failed to save token",
-        message: error.message,
-      });
-    },
-  });
-  const deleteSecret = clientApi.widget.secrets.deleteSecret.useMutation({
-    onSuccess: () => refetch(),
-    onError: (error) => {
-      showErrorNotification({
-        title: "Failed to delete token",
-        message: error.message,
-      });
-    },
-  });
+  const setSecret = clientApi.widget.secrets.setSecret.useMutation({ onSuccess: () => refetch() });
+  const deleteSecret = clientApi.widget.secrets.deleteSecret.useMutation({ onSuccess: () => refetch() });
 
   const authProviders = useMemo(() => {
     const usedProviders = repositories.map((r) => r.provider).filter((p): p is ReleaseProviderKind => p !== undefined);

packages/widgets/src/archive-team-warrior/component.tsx

@@ -6,6 +6,7 @@ import { clientApi } from "@homarr/api/client";
 import { humanFileSize } from "@homarr/common";
 import { getIconUrl } from "@homarr/definitions";
 
+import { WidgetEmptyState } from "../common/empty-state";
 import type { WidgetComponentProps } from "../definition";
 
 export default function ArchiveTeamWarriorWidget({
@@ -28,7 +29,9 @@ const ArchiveTeamWarriorWidgetContent = ({
   integrationId: string;
   options: WidgetComponentProps<"archiveTeamWarrior">["options"];
 }) => {
-  const [data] = clientApi.widget.archiveTeamWarrior.getStatus.useSuspenseQuery({ integrationId });
+  const { data } = clientApi.widget.archiveTeamWarrior.getStatus.useQuery({ integrationId });
+
+  if (!data) return <WidgetEmptyState />;
 
   const status = data.status;
   const projectName = status.project?.title ?? status.selectedProject ?? "No project selected";

packages/widgets/src/audio-stats/audio-stats-content.tsx

@@ -46,7 +46,7 @@ export function AudioStatsContent({ backend, stats, options, width }: AudioStats
   };
   const navidromeStats = navidromeStatsByBackend[backend];
   const showNowPlayingSection =
-    navidromeStats !== null && Boolean(options.showNowPlaying) && navidromeStats.nowPlaying.length > 0;
+    navidromeStats !== null && Boolean(options.showNowPlaying) && (navidromeStats.nowPlaying ?? []).length > 0;
 
   const nowPlayingLimitByListVisibility = {
     true: options.maxNowPlayingItems ?? 3,
@@ -54,7 +54,7 @@ export function AudioStatsContent({ backend, stats, options, width }: AudioStats
   } as const;
 
   const nowPlayingTracks =
-    navidromeStats?.nowPlaying.slice(
+    (navidromeStats?.nowPlaying ?? []).slice(
       0,
       nowPlayingLimitByListVisibility[
         String(options.showNowPlayingList) as keyof typeof nowPlayingLimitByListVisibility

packages/widgets/src/beszel-alerts/component.tsx

@@ -54,12 +54,12 @@ export default function BeszelAlertsWidget({
   }, [results]);
 
   const alerts = useMemo(
-    () => results.flatMap((r) => r.alerts.map((a) => ({ ...a, _key: `${r.integrationId}:${a.id}` }))),
+    () => results.flatMap((r) => (r.alerts ?? []).map((a) => ({ ...a, _key: `${r.integrationId}:${a.id}` }))),
     [results],
   );
 
   const history = useMemo(() => {
-    const all = results.flatMap((r) => r.history.map((h) => ({ ...h, _key: `${r.integrationId}:${h.id}` })));
+    const all = results.flatMap((r) => (r.history ?? []).map((h) => ({ ...h, _key: `${r.integrationId}:${h.id}` })));
     return all
       .toSorted((a, b) => new Date(b.created).getTime() - new Date(a.created).getTime())
       .slice(0, options.maxHistoryItems);

packages/widgets/src/beszel-system-stats/component.tsx

@@ -70,7 +70,7 @@ export default function BeszelSystemStatsWidget({
   } = clientApi.widget.beszel.getSystems.useQuery({ integrationIds });
 
   const systems = useMemo(
-    () => systemsResult.flatMap((r) => r.systems.map((s) => ({ value: s.id, label: s.name }))),
+    () => systemsResult.flatMap((r) => (r.systems ?? []).map((s) => ({ value: s.id, label: s.name }))),
     [systemsResult],
   );
 

packages/widgets/src/beszel-system-stats/index.ts

@@ -29,7 +29,7 @@ export const { definition, componentLoader } = createWidgetDefinition("beszelSys
             isPending,
             isError,
           } = clientApi.widget.beszel.getSystems.useQuery({ integrationIds }, { enabled: integrationIds.length > 0 });
-          const selectData = data.flatMap((r) => r.systems.map((s) => ({ value: s.id, label: s.name })));
+          const selectData = data.flatMap((r) => (r.systems ?? []).map((s) => ({ value: s.id, label: s.name })));
           return { data: selectData, isPending, isError };
         },
       }),

packages/widgets/src/beszel/_shared/chart.tsx

@@ -187,7 +187,7 @@ export const useDockerChartData = (
     const { fmt, ordered } = prepareRecords(containerStats, timePeriod);
     const mapped = ordered.map((record) => {
       const point: Record<string, unknown> = { time: fmt(record.created), rawTime: record.created };
-      const byName = new Map(record.stats.map((c) => [c.n, c]));
+      const byName = new Map((record.stats ?? []).map((c) => [c.n, c]));
       for (const name of containerNames) {
         point[name] = extract(byName.get(name));
       }

packages/widgets/src/beszel/_shared/hooks.ts

@@ -13,8 +13,8 @@ export const useBeszelFilteredSystems = (
   const allSystems = useMemo(
     () =>
       results
-        .flatMap((r) => r.systems.map((s) => ({ ...s, _key: `${r.integrationId}:${s.id}` })))
-        .toSorted((a, b) => a.name.localeCompare(b.name)),
+        .flatMap((r) => (r.systems ?? []).map((s) => ({ ...s, _key: `${r.integrationId}:${s.id}` })))
+        .toSorted((a, b) => (a.name ?? "").localeCompare(b.name ?? "")),
     [results],
   );
 

packages/widgets/src/calendar/component.tsx

@@ -137,7 +137,7 @@ const CalendarBase = ({ isEditMode, events, month, setMonth, options }: Calendar
           .filter(
             (event) => event.metadata?.type !== "radarr" || options.releaseType.includes(event.metadata.releaseType),
           )
-          .toSorted((eventA, eventB) => eventA.startDate.getTime() - eventB.startDate.getTime());
+          .toSorted((eventA, eventB) => new Date(eventA.startDate).getTime() - new Date(eventB.startDate).getTime());
 
         return (
           <CalendarDay

packages/widgets/src/coolify/instance-card.tsx

@@ -32,22 +32,18 @@ export function InstanceCard({ instance, options, isTiny, widgetKey }: InstanceC
     defaultValue: ["applications"],
   });
 
-  const serverResourceCounts = buildServerResourceCounts(
-    instance.instanceInfo.servers,
-    instance.instanceInfo.applications,
-    instance.instanceInfo.services,
-  );
+  const servers = instance.instanceInfo.servers ?? [];
+  const applications = instance.instanceInfo.applications ?? [];
+  const services = instance.instanceInfo.services ?? [];
+
+  const serverResourceCounts = buildServerResourceCounts(servers, applications, services);
 
   const baseUrl = instance.integrationUrl.replace(/\/+$/, "");
   const relativeTime = useTimeAgo(instance.updatedAt);
 
-  const onlineServers = instance.instanceInfo.servers.filter((s) => s.is_reachable !== false).length;
-  const runningApps = instance.instanceInfo.applications.filter(
-    (a) => parseStatus(a.status ?? "") === "running",
-  ).length;
-  const runningServices = instance.instanceInfo.services.filter(
-    (s) => parseStatus(s.status ?? "") === "running",
-  ).length;
+  const onlineServers = servers.filter((s) => s.is_reachable !== false).length;
+  const runningApps = applications.filter((a) => parseStatus(a.status ?? "") === "running").length;
+  const runningServices = services.filter((s) => parseStatus(s.status ?? "") === "running").length;
 
   return (
     <Card p={0} radius="sm">
@@ -65,26 +61,18 @@ export function InstanceCard({ instance, options, isTiny, widgetKey }: InstanceC
         </Group>
         <Group gap={4} wrap="nowrap">
           {options.showServers && (
-            <Badge variant="dot" color={getBadgeColor(onlineServers, instance.instanceInfo.servers.length)} size="xs">
-              {onlineServers}/{instance.instanceInfo.servers.length}
+            <Badge variant="dot" color={getBadgeColor(onlineServers, servers.length)} size="xs">
+              {onlineServers}/{servers.length}
             </Badge>
           )}
           {options.showApplications && (
-            <Badge
-              variant="dot"
-              color={getBadgeColor(runningApps, instance.instanceInfo.applications.length)}
-              size="xs"
-            >
-              {runningApps}/{instance.instanceInfo.applications.length}
+            <Badge variant="dot" color={getBadgeColor(runningApps, applications.length)} size="xs">
+              {runningApps}/{applications.length}
             </Badge>
           )}
           {options.showServices && (
-            <Badge
-              variant="dot"
-              color={getBadgeColor(runningServices, instance.instanceInfo.services.length)}
-              size="xs"
-            >
-              {runningServices}/{instance.instanceInfo.services.length}
+            <Badge variant="dot" color={getBadgeColor(runningServices, services.length)} size="xs">
+              {runningServices}/{services.length}
             </Badge>
           )}
         </Group>
@@ -93,7 +81,7 @@ export function InstanceCard({ instance, options, isTiny, widgetKey }: InstanceC
       <Accordion variant="filled" chevronPosition="right" multiple value={openSections} onChange={setOpenSections}>
         {options.showServers && (
           <ServersSection
-            servers={instance.instanceInfo.servers}
+            servers={servers}
             serverResourceCounts={serverResourceCounts}
             baseUrl={baseUrl}
             isTiny={isTiny}
@@ -102,11 +90,9 @@ export function InstanceCard({ instance, options, isTiny, widgetKey }: InstanceC
           />
         )}
         {options.showApplications && (
-          <ApplicationsSection applications={instance.instanceInfo.applications} baseUrl={baseUrl} isTiny={isTiny} />
-        )}
-        {options.showServices && (
-          <ServicesSection services={instance.instanceInfo.services} baseUrl={baseUrl} isTiny={isTiny} />
+          <ApplicationsSection applications={applications} baseUrl={baseUrl} isTiny={isTiny} />
         )}
+        {options.showServices && <ServicesSection services={services} baseUrl={baseUrl} isTiny={isTiny} />}
       </Accordion>
 
       <Group justify="space-between" p={4} style={{ borderTop: "1px solid var(--mantine-color-dark-4)" }}>

packages/widgets/src/coolify/single-instance-layout.tsx

@@ -31,11 +31,11 @@ export function SingleInstanceLayout({ instance, options, isTiny, widgetKey }: S
     defaultValue: ["applications"],
   });
 
-  const serverResourceCounts = buildServerResourceCounts(
-    instance.instanceInfo.servers,
-    instance.instanceInfo.applications,
-    instance.instanceInfo.services,
-  );
+  const servers = instance.instanceInfo.servers ?? [];
+  const applications = instance.instanceInfo.applications ?? [];
+  const services = instance.instanceInfo.services ?? [];
+
+  const serverResourceCounts = buildServerResourceCounts(servers, applications, services);
 
   const baseUrl = instance.integrationUrl.replace(/\/+$/, "");
   const displayUrl = baseUrl.replace(/^https?:\/\//, "");
@@ -59,7 +59,7 @@ export function SingleInstanceLayout({ instance, options, isTiny, widgetKey }: S
         <Accordion variant="contained" chevronPosition="right" multiple value={openSections} onChange={setOpenSections}>
           {options.showServers && (
             <ServersSection
-              servers={instance.instanceInfo.servers}
+              servers={servers}
               serverResourceCounts={serverResourceCounts}
               baseUrl={baseUrl}
               isTiny={isTiny}
@@ -68,11 +68,9 @@ export function SingleInstanceLayout({ instance, options, isTiny, widgetKey }: S
             />
           )}
           {options.showApplications && (
-            <ApplicationsSection applications={instance.instanceInfo.applications} baseUrl={baseUrl} isTiny={isTiny} />
-          )}
-          {options.showServices && (
-            <ServicesSection services={instance.instanceInfo.services} baseUrl={baseUrl} isTiny={isTiny} />
+            <ApplicationsSection applications={applications} baseUrl={baseUrl} isTiny={isTiny} />
           )}
+          {options.showServices && <ServicesSection services={services} baseUrl={baseUrl} isTiny={isTiny} />}
         </Accordion>
 
         <Group

packages/widgets/src/downloads/component.tsx

@@ -104,7 +104,9 @@ export default function DownloadClientsWidget({
   const [quickFilters, setQuickFilters] = useState<QuickFilter>({ integrationKinds: [], statuses: [] });
   const availableStatuses = useMemo<QuickFilter["statuses"]>(() => {
     //Redefine list of available statuses from current items
-    const statuses = Array.from(new Set(currentItems.flatMap(({ data }) => data.items.map(({ state }) => state))));
+    const statuses = Array.from(
+      new Set(currentItems.flatMap(({ data }) => (data.items ?? []).map(({ state }) => state))),
+    );
     //Reset user filters accordingly to remove unavailable statuses
     setQuickFilters(({ integrationKinds: names, statuses: prevStatuses }) => {
       return { integrationKinds: names, statuses: prevStatuses.filter((status) => statuses.includes(status)) };
@@ -127,7 +129,7 @@ export default function DownloadClientsWidget({
         //Construct normalized items list
         .flatMap((pair) =>
           //Apply user white/black list
-          pair.data.items
+          (pair.data.items ?? [])
             .filter(
               ({ category }) =>
                 options.filterIsWhitelist ===
@@ -202,7 +204,7 @@ export default function DownloadClientsWidget({
           const interact = integrationsWithInteractions.includes(integration.id);
           const isTorrent = getIntegrationKindsByCategory("torrent").some((kind) => kind === integration.kind);
           /** Derived from current items */
-          const { totalUp, totalDown } = data.items
+          const { totalUp, totalDown } = (data.items ?? [])
             .filter(
               ({ category }) =>
                 !options.applyFilterToRatio ||

packages/widgets/src/health-monitoring/cluster/cluster-health.tsx

@@ -41,19 +41,21 @@ export const ClusterHealthMonitoring = ({
 
   if (!healthData) return <WidgetEmptyState />;
 
-  const activeNodes = healthData.nodes.reduce(running, 0);
-  const activeVMs = healthData.vms.reduce(running, 0);
-  const activeLXCs = healthData.lxcs.reduce(running, 0);
-  const activeStorage = healthData.storages.reduce(running, 0);
+  const nodes = healthData.nodes ?? [];
+  const vms = healthData.vms ?? [];
+  const lxcs = healthData.lxcs ?? [];
+  const storages = healthData.storages ?? [];
 
-  const usedMem = healthData.nodes.reduce((sum, item) => (item.isRunning ? item.memory.used + sum : sum), 0);
-  const maxMem = healthData.nodes.reduce((sum, item) => (item.isRunning ? item.memory.total + sum : sum), 0);
-  const maxCpu = healthData.nodes.reduce((sum, item) => (item.isRunning ? item.cpu.cores + sum : sum), 0);
-  const usedCpu = healthData.nodes.reduce(
-    (sum, item) => (item.isRunning ? item.cpu.utilization * item.cpu.cores + sum : sum),
-    0,
-  );
-  const uptime = healthData.nodes.reduce((sum, { uptime }) => (sum > uptime ? sum : uptime), 0);
+  const activeNodes = nodes.reduce(running, 0);
+  const activeVMs = vms.reduce(running, 0);
+  const activeLXCs = lxcs.reduce(running, 0);
+  const activeStorage = storages.reduce(running, 0);
+
+  const usedMem = nodes.reduce((sum, item) => (item.isRunning ? item.memory.used + sum : sum), 0);
+  const maxMem = nodes.reduce((sum, item) => (item.isRunning ? item.memory.total + sum : sum), 0);
+  const maxCpu = nodes.reduce((sum, item) => (item.isRunning ? item.cpu.cores + sum : sum), 0);
+  const usedCpu = nodes.reduce((sum, item) => (item.isRunning ? item.cpu.utilization * item.cpu.cores + sum : sum), 0);
+  const uptime = nodes.reduce((sum, { uptime }) => (sum > uptime ? sum : uptime), 0);
 
   const cpuPercent = maxCpu ? (usedCpu / maxCpu) * 100 : 0;
   const memPercent = maxMem ? (usedMem / maxMem) * 100 : 0;
@@ -89,12 +91,12 @@ export const ClusterHealthMonitoring = ({
               icon={IconServer}
               badge={addBadgeColor({
                 activeCount: activeNodes,
-                totalCount: healthData.nodes.length,
+                totalCount: nodes.length,
                 sectionIndicatorRequirement: options.sectionIndicatorRequirement,
               })}
               isTiny={isTiny}
             >
-              <ResourceTable type="node" data={healthData.nodes} isTiny={isTiny} />
+              <ResourceTable type="node" data={nodes} isTiny={isTiny} />
             </ResourceAccordionItem>
           )}
 
@@ -105,12 +107,12 @@ export const ClusterHealthMonitoring = ({
               icon={IconDeviceLaptop}
               badge={addBadgeColor({
                 activeCount: activeVMs,
-                totalCount: healthData.vms.length,
+                totalCount: vms.length,
                 sectionIndicatorRequirement: options.sectionIndicatorRequirement,
               })}
               isTiny={isTiny}
             >
-              <ResourceTable type="qemu" data={healthData.vms} isTiny={isTiny} />
+              <ResourceTable type="qemu" data={vms} isTiny={isTiny} />
             </ResourceAccordionItem>
           )}
 
@@ -121,12 +123,12 @@ export const ClusterHealthMonitoring = ({
               icon={IconCube}
               badge={addBadgeColor({
                 activeCount: activeLXCs,
-                totalCount: healthData.lxcs.length,
+                totalCount: lxcs.length,
                 sectionIndicatorRequirement: options.sectionIndicatorRequirement,
               })}
               isTiny={isTiny}
             >
-              <ResourceTable type="lxc" data={healthData.lxcs} isTiny={isTiny} />
+              <ResourceTable type="lxc" data={lxcs} isTiny={isTiny} />
             </ResourceAccordionItem>
           )}
 
@@ -137,12 +139,12 @@ export const ClusterHealthMonitoring = ({
               icon={IconDatabase}
               badge={addBadgeColor({
                 activeCount: activeStorage,
-                totalCount: healthData.storages.length,
+                totalCount: storages.length,
                 sectionIndicatorRequirement: options.sectionIndicatorRequirement,
               })}
               isTiny={isTiny}
             >
-              <ResourceTable type="storage" data={healthData.storages} isTiny={isTiny} />
+              <ResourceTable type="storage" data={storages} isTiny={isTiny} />
             </ResourceAccordionItem>
           )}
         </Accordion>

packages/widgets/src/health-monitoring/system-health.tsx

@@ -65,7 +65,7 @@ export const SystemHealthMonitoring = ({
   return (
     <Stack h="100%" gap="sm" className="health-monitoring">
       {healthData.map(({ integrationId, integrationName, healthInfo }) => {
-        const disksData = matchFileSystemAndSmart(healthInfo.fileSystem, healthInfo.smart);
+        const disksData = matchFileSystemAndSmart(healthInfo.fileSystem ?? [], healthInfo.smart ?? []);
         const memoryUsage = formatMemoryUsage(healthInfo.memAvailableInBytes, healthInfo.memUsedInBytes);
         return (
           <Stack
@@ -165,7 +165,7 @@ export const SystemHealthMonitoring = ({
                 />
               )}
               {options.gpu &&
-                healthInfo.gpu.map((gpu) => (
+                (healthInfo.gpu ?? []).map((gpu) => (
                   <GpuRing key={gpu.gpuId} gpu={gpu} isTiny={isTiny} fahrenheit={options.fahrenheit} />
                 ))}
             </Flex>
@@ -301,5 +301,5 @@ export const matchFileSystemAndSmart = (fileSystems: FileSystem[], smartData: Sm
         overallStatus: smartDisk?.overallStatus ?? "",
       };
     })
-    .toSorted((fileSystemA, fileSystemB) => fileSystemA.deviceName.localeCompare(fileSystemB.deviceName));
+    .toSorted((fileSystemA, fileSystemB) => (fileSystemA.deviceName ?? "").localeCompare(fileSystemB.deviceName ?? ""));
 };

packages/widgets/src/indexer-manager/component.tsx

@@ -65,7 +65,7 @@ export default function IndexerManagerWidget({
         <ScrollArea className="indexer-manager-list-scroll-area" h="100%" scrollbars="y">
           {indexersData.map(({ integrationId, indexers }) => (
             <Stack gap={4} className={`indexer-manager-${integrationId}-list-container`} p={0} key={integrationId}>
-              {indexers.map((indexer) => (
+              {(indexers ?? []).map((indexer) => (
                 <Group
                   className={`indexer-manager-line indexer-manager-${indexer.name}`}
                   key={indexer.id}

packages/widgets/src/media-releases/component.tsx

@@ -80,7 +80,7 @@ const Item = ({ item, options }: ItemProps) => {
             top={0}
             left={0}
             style={{
-              backgroundImage: `url(${item.imageUrls.backdrop})`,
+              backgroundImage: `url(${item.imageUrls?.backdrop})`,
               borderRadius: 8,
               backgroundRepeat: "no-repeat",
               backgroundSize: "cover",
@@ -91,7 +91,7 @@ const Item = ({ item, options }: ItemProps) => {
         )}
         <Group justify="space-between" h="100%" wrap="nowrap">
           <Group align="start" wrap="nowrap" style={{ zIndex: 0 }}>
-            {options.layout === "poster" && <Image w={60} src={item.imageUrls.poster} alt={item.title} />}
+            {options.layout === "poster" && <Image w={60} src={item.imageUrls?.poster} alt={item.title} />}
             <Stack gap={4}>
               <Stack gap={0}>
                 <Text size="sm" fw="bold" lineClamp={2}>
@@ -130,7 +130,7 @@ const Item = ({ item, options }: ItemProps) => {
                   </>
                 )}
               </Group>
-              {item.tags.length > 0 && (
+              {(item.tags ?? []).length > 0 && (
                 <OverflowBadge
                   size="xs"
                   groupGap={4}

packages/widgets/src/media-requests/stats/component.tsx

@@ -43,48 +43,49 @@ export default function MediaServerWidget({
   const board = useRequiredBoard();
 
   if (!requestStats) return <WidgetEmptyState />;
-  if (requestStats.users.length === 0 && requestStats.stats.length === 0) throw new NoIntegrationDataError();
+  if ((requestStats.users ?? []).length === 0 && (requestStats.stats ?? []).length === 0)
+    throw new NoIntegrationDataError();
 
   const data = [
     {
       name: "approved",
       icon: IconThumbUp,
-      number: requestStats.stats.reduce((count, { approved }) => count + approved, 0),
+      number: (requestStats.stats ?? []).reduce((count, { approved }) => count + approved, 0),
     },
     {
       name: "pending",
       icon: IconHourglass,
-      number: requestStats.stats.reduce((count, { pending }) => count + pending, 0),
+      number: (requestStats.stats ?? []).reduce((count, { pending }) => count + pending, 0),
     },
     {
       name: "processing",
       icon: IconLoaderQuarter,
-      number: requestStats.stats.reduce((count, { processing }) => count + processing, 0),
+      number: (requestStats.stats ?? []).reduce((count, { processing }) => count + processing, 0),
     },
     {
       name: "declined",
       icon: IconThumbDown,
-      number: requestStats.stats.reduce((count, { declined }) => count + declined, 0),
+      number: (requestStats.stats ?? []).reduce((count, { declined }) => count + declined, 0),
     },
     {
       name: "available",
       icon: IconPlayerPlay,
-      number: requestStats.stats.reduce((count, { available }) => count + available, 0),
+      number: (requestStats.stats ?? []).reduce((count, { available }) => count + available, 0),
     },
     {
       name: "tv",
       icon: IconDeviceTv,
-      number: requestStats.stats.reduce((count, { tv }) => count + tv, 0),
+      number: (requestStats.stats ?? []).reduce((count, { tv }) => count + tv, 0),
     },
     {
       name: "movie",
       icon: IconMovie,
-      number: requestStats.stats.reduce((count, { movie }) => count + movie, 0),
+      number: (requestStats.stats ?? []).reduce((count, { movie }) => count + movie, 0),
     },
     {
       name: "total",
       icon: IconReceipt,
-      number: requestStats.stats.reduce((count, { total }) => count + total, 0),
+      number: (requestStats.stats ?? []).reduce((count, { total }) => count + total, 0),
     },
   ] satisfies { name: keyof RequestStats; icon: Icon; number: number }[];
 
@@ -132,7 +133,7 @@ export default function MediaServerWidget({
             {t("titles.users.main")} ({t("titles.users.requests")})
           </Text>
           <Stack className="mediaRequests-stats-users-wrapper" flex={1} w="100%" gap={4} style={{ overflow: "hidden" }}>
-            {requestStats.users.slice(0, 10).map((user) => (
+            {(requestStats.users ?? []).slice(0, 10).map((user) => (
               <Card
                 component="a"
                 href={user.link}

packages/widgets/src/media-server/component.tsx

@@ -76,7 +76,7 @@ export default function MediaServerWidget({ options, integrationIds }: WidgetCom
   const flatSessions = useMemo(
     () =>
       currentStreams.flatMap((pair) =>
-        pair.sessions.map((session) => ({
+        (pair.sessions ?? []).map((session) => ({
           ...session,
           integrationKind: pair.integrationKind,
           integrationName: integrationDefs[pair.integrationKind].name,

packages/widgets/src/media-transcoding/panels/queue.panel.tsx

@@ -27,7 +27,7 @@ export function QueuePanel(props: QueuePanelProps) {
 
   const t = useI18n("widget.mediaTranscoding.panel.queue");
 
-  if (queue.array.length === 0) {
+  if ((queue.array ?? []).length === 0) {
     return (
       <Center style={{ flex: "1" }}>
         <Title order={6}>{t("empty")}</Title>
@@ -53,7 +53,7 @@ export function QueuePanel(props: QueuePanelProps) {
           </TableTr>
         </TableThead>
         <TableTbody>
-          {queue.array.map((item) => (
+          {(queue.array ?? []).map((item) => (
             <TableTr key={item.id}>
               <TableTd py={2}>
                 <Group gap={4} wrap="nowrap">

packages/widgets/src/media-transcoding/panels/workers.panel.tsx

@@ -26,7 +26,7 @@ interface WorkersPanelProps {
 export function WorkersPanel(props: WorkersPanelProps) {
   const t = useI18n("widget.mediaTranscoding.panel.workers");
 
-  if (props.workers.length === 0) {
+  if ((props.workers ?? []).length === 0) {
     return (
       <Center style={{ flex: "1" }}>
         <Title order={6}>{t("empty")}</Title>

packages/widgets/src/network-controller/network-status/component.tsx

@@ -25,19 +25,19 @@ export default function NetworkControllerNetworkStatusWidget({
     integrationIds,
   });
 
-  const data = useMemo(() => summaries.flatMap(({ summary }) => summary), [summaries]);
+  const data = useMemo(() => summaries.flatMap(({ summary }) => (summary ? [summary] : [])), [summaries]);
 
   return (
     <Box p={"sm"}>
       {options.content === "wifi" ? (
         <WifiVariant
-          countGuests={data.reduce((sum, summary) => sum + summary.wifi.guests, 0)}
-          countUsers={data.reduce((sum, summary) => sum + summary.wifi.users, 0)}
+          countGuests={data.reduce((sum, summary) => sum + (summary.wifi?.guests ?? 0), 0)}
+          countUsers={data.reduce((sum, summary) => sum + (summary.wifi?.users ?? 0), 0)}
         />
       ) : (
         <WiredVariant
-          countGuests={data.reduce((sum, summary) => sum + summary.lan.guests, 0)}
-          countUsers={data.reduce((sum, summary) => sum + summary.lan.users, 0)}
+          countGuests={data.reduce((sum, summary) => sum + (summary.lan?.guests ?? 0), 0)}
+          countUsers={data.reduce((sum, summary) => sum + (summary.lan?.users ?? 0), 0)}
         />
       )}
     </Box>

packages/widgets/src/notifications/component.tsx

@@ -24,8 +24,8 @@ export default function NotificationsWidget({ options, integrationIds }: WidgetC
   const sortedNotifications = useMemo(
     () =>
       notificationIntegrations
-        .flatMap((integration) => integration.data)
-        .sort((entryA, entryB) => entryB.time.getTime() - entryA.time.getTime()),
+        .flatMap((integration) => integration.data ?? [])
+        .sort((a, b) => (b.time?.getTime?.() ?? 0) - (a.time?.getTime?.() ?? 0)),
     [notificationIntegrations],
   );
 

packages/widgets/src/speedtest-tracker/component.tsx

@@ -24,7 +24,7 @@ export default function SpeedtestTrackerWidget({ options, integrationIds }: Widg
         (acc, item) => ({
           latestResult: item.dashboard.latestResult ?? acc.latestResult,
           stats: mergeStats(acc.stats, item.dashboard.stats),
-          recentResults: [...acc.recentResults, ...item.dashboard.recentResults],
+          recentResults: [...acc.recentResults, ...(item.dashboard.recentResults ?? [])],
         }),
         { latestResult: null, stats: null, recentResults: [] },
       ),
@@ -32,7 +32,9 @@ export default function SpeedtestTrackerWidget({ options, integrationIds }: Widg
   );
 
   const twelveHoursAgo = Date.now() - 12 * 60 * 60 * 1000;
-  const recentFiltered = combined.recentResults.filter((result) => result.created_at.getTime() > twelveHoursAgo);
+  const recentFiltered = combined.recentResults.filter(
+    (result) => new Date(result.created_at).getTime() > twelveHoursAgo,
+  );
 
   const hasStatSection =
     (options.showLatestResult && combined.latestResult !== null) || (options.showStats && combined.stats !== null);

packages/widgets/src/speedtest-tracker/recent-results.tsx

@@ -40,7 +40,7 @@ function buildXAxisTicks(data: { ts: number }[]): XAxisTicks {
 
   return {
     midnightTs: foundMidnight,
-    xTicks: Array.from(tickSet).sort((tsA, tsB) => tsA - tsB),
+    xTicks: Array.from(tickSet).toSorted((tsA, tsB) => tsA - tsB),
     topDateTicks: topTicks,
   };
 }
@@ -161,10 +161,10 @@ function SpeedHistoryChart({ results, height }: { results: SpeedtestTrackerResul
   const data = useMemo(
     () =>
       [...results]
-        .sort((resultA, resultB) => resultA.created_at.getTime() - resultB.created_at.getTime())
+        .toSorted((resultA, resultB) => new Date(resultA.created_at).getTime() - new Date(resultB.created_at).getTime())
         .filter((result) => (result.download_bits ?? 0) > 0)
         .map((result) => ({
-          ts: result.created_at.getTime(),
+          ts: new Date(result.created_at).getTime(),
           Download: parseFloat(((result.download_bits ?? 0) / 1_000_000).toFixed(2)),
           Upload:
             result.upload_bits != null && result.upload_bits > 0
@@ -273,12 +273,12 @@ function PingHistoryChart({ results, height }: { results: SpeedtestTrackerResult
   const data = useMemo(
     () =>
       [...results]
-        .sort((resultA, resultB) => resultA.created_at.getTime() - resultB.created_at.getTime())
+        .toSorted((resultA, resultB) => new Date(resultA.created_at).getTime() - new Date(resultB.created_at).getTime())
         .map((result) =>
           result.ping === null
             ? null
             : {
-                ts: result.created_at.getTime(),
+                ts: new Date(result.created_at).getTime(),
                 Ping: result.ping,
               },
         )

packages/widgets/src/stocks/component.tsx

@@ -35,8 +35,9 @@ export default function StockPriceWidget({ options, width, height }: WidgetCompo
     calculateChangePercentage(data.priceHistory.at(-1) ?? 0, data.previousClose),
   );
 
-  const stockValuesMin = Math.min(...data.priceHistory);
-  const stockGraphValues = data.priceHistory.map((value) => value - stockValuesMin + 50);
+  const priceHistory = data.priceHistory ?? [];
+  const stockValuesMin = priceHistory.length > 0 ? Math.min(...priceHistory) : 0;
+  const stockGraphValues = priceHistory.map((value) => value - stockValuesMin + 50);
   const trendColor = stockValuesChange > 0 ? "green.7" : stockValuesChange < 0 ? "red.7" : "gray.6";
 
   return (

packages/widgets/src/timetable/component.tsx

@@ -34,7 +34,7 @@ const TimetableWidgetInner = ({ station, baseUrl }: TimetableWidgetInnerProps) =
     <Stack w="100%" gap="xs" p="sm">
       <Text fw="bold">{t("title", { station: station.label })}</Text>
       {(timetable?.entries ?? []).map((entry) => (
-        <Group key={`${entry.timestamp.toISOString()}-${entry.location}`} justify="space-between" w="100%">
+        <Group key={`${new Date(entry.timestamp).toISOString()}-${entry.location}`} justify="space-between" w="100%">
           <Group gap="sm">
             {entry.line && (
               <Badge

packages/widgets/src/tracearr/component.tsx

@@ -37,24 +37,28 @@ function TracearrContent({ integrationIds, options, width }: TracearrContentProp
       const { stats, streams, violations, recentActivity } = item.dashboard;
       const vData = violations ?? { data: [], meta: { total: 0, page: 1, pageSize: 5 } };
       const aData = recentActivity ?? { data: [], meta: { total: 0, page: 1, pageSize: 5 } };
+      const sData = streams ?? {
+        data: [],
+        summary: { total: 0, transcodes: 0, directStreams: 0, directPlays: 0, totalBitrate: "0", byServer: [] },
+      };
 
       return {
         stats: {
-          activeStreams: acc.stats.activeStreams + stats.activeStreams,
-          totalUsers: acc.stats.totalUsers + stats.totalUsers,
-          totalSessions: acc.stats.totalSessions + stats.totalSessions,
-          recentViolations: acc.stats.recentViolations + stats.recentViolations,
-          timestamp: stats.timestamp,
+          activeStreams: acc.stats.activeStreams + (stats?.activeStreams ?? 0),
+          totalUsers: acc.stats.totalUsers + (stats?.totalUsers ?? 0),
+          totalSessions: acc.stats.totalSessions + (stats?.totalSessions ?? 0),
+          recentViolations: acc.stats.recentViolations + (stats?.recentViolations ?? 0),
+          timestamp: stats?.timestamp ?? "",
         },
         streams: {
-          data: [...acc.streams.data, ...streams.data],
+          data: [...acc.streams.data, ...(sData.data ?? [])],
           summary: {
-            total: acc.streams.summary.total + streams.summary.total,
-            transcodes: acc.streams.summary.transcodes + streams.summary.transcodes,
-            directStreams: acc.streams.summary.directStreams + streams.summary.directStreams,
-            directPlays: acc.streams.summary.directPlays + streams.summary.directPlays,
-            totalBitrate: streams.summary.totalBitrate,
-            byServer: [...acc.streams.summary.byServer, ...streams.summary.byServer],
+            total: acc.streams.summary.total + (sData.summary?.total ?? 0),
+            transcodes: acc.streams.summary.transcodes + (sData.summary?.transcodes ?? 0),
+            directStreams: acc.streams.summary.directStreams + (sData.summary?.directStreams ?? 0),
+            directPlays: acc.streams.summary.directPlays + (sData.summary?.directPlays ?? 0),
+            totalBitrate: sData.summary?.totalBitrate ?? "0",
+            byServer: [...acc.streams.summary.byServer, ...(sData.summary?.byServer ?? [])],
           },
         },
         violations: {

packages/widgets/src/umami/umami-content.tsx

@@ -57,7 +57,7 @@ export function UmamiContent({
   );
 
   const multiEventTotal = multiEventSeries
-    ? multiEventSeries.flatMap(({ dataPoints }) => dataPoints).reduce((sum, { y }) => sum + y, 0)
+    ? multiEventSeries.flatMap(({ dataPoints }) => dataPoints ?? []).reduce((sum, { y }) => sum + y, 0)
     : undefined;
 
   const firstResult = results[0];
@@ -73,13 +73,13 @@ export function UmamiContent({
 
   const { visitorStats } = firstResult;
 
-  const chartData = visitorStats.dataPoints.map((point: UmamiVisitorStats["dataPoints"][number]) => ({
+  const chartData = (visitorStats.dataPoints ?? []).map((point: UmamiVisitorStats["dataPoints"][number]) => ({
     label: formatXLabel(point.timestamp, timeFrame),
     visitors: point.visitors,
     ...(point.events !== undefined ? { events: point.events } : {}),
   }));
 
-  const hasEventSeries = visitorStats.dataPoints.some(({ events }) => events !== undefined);
+  const hasEventSeries = (visitorStats.dataPoints ?? []).some(({ events }) => events !== undefined);
   const series = [
     { name: "visitors", color: "blue.5" },
     ...(hasEventSeries ? [{ name: "events", color: "orange.5" }] : []),

packages/widgets/src/umami/umami-events-content.tsx

@@ -45,14 +45,14 @@ export function UmamiEventsContent({
 
   // Collect all unique timestamps across all series
   const allTimestamps = Array.from(
-    new Set(series.flatMap(({ dataPoints }) => dataPoints.map(({ x: xPoint }) => xPoint))),
+    new Set(series.flatMap(({ dataPoints }) => (dataPoints ?? []).map(({ x: xPoint }) => xPoint))),
   ).toSorted();
 
   // Build per-event lookup by timestamp string
   const byEvent = new Map(
     series.map((serie: UmamiEventSeries) => [
       serie.eventName,
-      new Map(serie.dataPoints.map((point) => [point.x, point.y])),
+      new Map((serie.dataPoints ?? []).map((point) => [point.x, point.y])),
     ]),
   );
 

packages/widgets/src/ups/component.tsx

@@ -44,7 +44,7 @@ function UpsContent({ integrationIds, options, width }: UpsContentProps) {
   if (!data) return <WidgetEmptyState />;
 
   const devices = data.flatMap((instance) =>
-    instance.summaries.map((summary) => ({ key: `${instance.integrationId}:${summary.id}`, summary })),
+    (instance.summaries ?? []).map((summary) => ({ key: `${instance.integrationId}:${summary.id}`, summary })),
   );
 
   if (devices.length === 0) {