Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
Hide every filter toolbar in kiosk mode
rcourtman6f10635ff8c7
diff --git a/docs/release-control/v6/internal/subsystems/frontend-primitives.md b/docs/release-control/v6/internal/subsystems/frontend-primitives.mdindex 351562de65..733417e4ec 100644--- a/docs/release-control/v6/internal/subsystems/frontend-primitives.md+++ b/docs/release-control/v6/internal/subsystems/frontend-primitives.md@@ -6204,6 +6204,25 @@ affordance, it should extend the FilterBar catalog model or add a newregistry-backed shared primitive rather than reintroducing a per-page selectrow.+Kiosk mode (`?kiosk=1`, the session flag read through+`frontend-modern/src/hooks/useKioskMode.ts`) is the read-only wall display,+and `FilterBar` owns hiding filter chrome there. While kiosk is on the shared+bar stays unmounted, so search, inline and menu filters, View options, leading+and trailing controls, and the search field's type-to-search listener are all+absent on every consumer, including the Proxmox and vSphere workload+overviews, platform tables through `PlatformTableToolbar`, Storage, Proxmox+Backups, and Alert History. Filter state that is already applied keeps+narrowing the rendered rows; kiosk changes what is shown, not what the URL or+stored preferences select. Consumers must not re-implement the gate page by+page: the Proxmox and vSphere overview toolbars lost it when they were hoisted+out of `WorkloadsSurface`, and kept rendering on kiosk displays until the rule+moved into the shared bar. A consumer whose surrounding chrome exists only for+the bar, such as the Storage view subtabs, may still hide that chrome itself.+The rule covers the shared bar only: a scope heading and its reset (the+Proxmox `Guests on <node>` heading with Show all nodes), chart-driven+selections on Proxmox Backups and Alert History, and search fields inside+opened drawers are outside it.+FilterBar does not carry a saved-views affordance. The former`savedViewsKey` / `useSavedViews` / `SavedViewsMenu` trio persisted namedquery strings to localStorage under `pulse:filterbar:saved-views:<key>`; itdiff --git a/docs/release-control/v6/internal/subsystems/performance-and-scalability.md b/docs/release-control/v6/internal/subsystems/performance-and-scalability.mdindex 351ec00504..83b984974a 100644--- a/docs/release-control/v6/internal/subsystems/performance-and-scalability.md+++ b/docs/release-control/v6/internal/subsystems/performance-and-scalability.md@@ -1487,7 +1487,7 @@ change may globally weaken the Task 03 lifecycle-state idempotency invariant.appears; the column returns by itself when data arrives. The accessorreads the unfiltered guest set so narrowing the table by search or statusnever removes the column.-18. Extend workload filter active-count, reset semantics, and mobile toolbar state through `frontend-modern/src/components/Workloads/workloadsFilterModel.ts` (defaults, `countActiveWorkloadsFilters`, `hasActiveWorkloadsFilters`) rather than rebuilding filter-local state inside `frontend-modern/src/components/Workloads/WorkloadsFilter.tsx`. Workloads filter presentation now composes the shared `FilterBar` (`frontend-modern/src/components/shared/FilterBar/FilterBar.tsx`) with a per-page `FilterDef[]` catalog rather than the legacy `PageControls` structured control deck. High-frequency Type and Status filters stay in that catalog but render as inline compact segmented controls (`inline: true`), while longer or dynamic scope filters continue through the "+ Filter" menu and chip popovers. The Add filter control inherits FilterBar's compact accessible-only label by default instead of paying for a page-local labelled-field shell. Durable presentation controls pass only their panel content through `FilterBar.viewOptions`; the shared FilterBar owns the single View trigger and popover. Contextual actions use `leadingControls`, while frequently changed analytical orientation such as the active trend range uses `trailingControls`.+18. Extend workload filter active-count, reset semantics, and mobile toolbar state through `frontend-modern/src/components/Workloads/workloadsFilterModel.ts` (defaults, `countActiveWorkloadsFilters`, `hasActiveWorkloadsFilters`) rather than rebuilding filter-local state inside `frontend-modern/src/components/Workloads/WorkloadsFilter.tsx`. Workloads filter presentation now composes the shared `FilterBar` (`frontend-modern/src/components/shared/FilterBar/FilterBar.tsx`) with a per-page `FilterDef[]` catalog rather than the legacy `PageControls` structured control deck. High-frequency Type and Status filters stay in that catalog but render as inline compact segmented controls (`inline: true`), while longer or dynamic scope filters continue through the "+ Filter" menu and chip popovers. The Add filter control inherits FilterBar's compact accessible-only label by default instead of paying for a page-local labelled-field shell. Durable presentation controls pass only their panel content through `FilterBar.viewOptions`; the shared FilterBar owns the single View trigger and popover. Contextual actions use `leadingControls`, while frequently changed analytical orientation such as the active trend range uses `trailingControls`. In kiosk mode the shared `FilterBar` keeps that toolbar unmounted, so a wall display mounts none of the bar's search field, suggestion list, View popover or type-to-search listener; overview pages must not add their own kiosk check around it.Workload autocomplete must project from the same unfiltered guest inventoryand the same search-candidate helper used by the workload predicate. Theprojection includes workload identity plus deduplicated node, Docker host,diff --git a/frontend-modern/browser-verification/6e11ba8ce4a138fe.json b/frontend-modern/browser-verification/6e11ba8ce4a138fe.jsonnew file mode 100644index 0000000000..9ea3bbba79--- /dev/null+++ b/frontend-modern/browser-verification/6e11ba8ce4a138fe.json@@ -0,0 +1,58 @@+{+ "version": 1,+ "base_sha": "410d84c69444ce4b59d00432b0b5510ce3016d0e",+ "verified_at": "2026-10-10T06:30:14Z",+ "result": "passed",+ "changed_paths": [+ "frontend-modern/src/components/shared/FilterBar/FilterBar.tsx"+ ],+ "content_sha256": {+ "frontend-modern/src/components/shared/FilterBar/FilterBar.tsx": "f11cfb13e4ec8af1680a4eaacb13547b5b0e889e8594e981608906531f3536b1"+ },+ "routes": [+ "/proxmox/overview?kiosk=1",+ "/proxmox/overview?kiosk=0",+ "/vmware/overview?kiosk=1",+ "/vmware/overview?kiosk=0",+ "/docker/overview?kiosk=1",+ "/docker/overview?kiosk=0",+ "/kubernetes/overview?kiosk=1",+ "/kubernetes/overview?kiosk=0",+ "/truenas/overview?kiosk=1",+ "/truenas/overview?kiosk=0",+ "/standalone/machines?kiosk=1",+ "/standalone/machines?kiosk=0",+ "/proxmox/storage?kiosk=1",+ "/proxmox/storage?kiosk=0",+ "/proxmox/backups?kiosk=1",+ "/proxmox/backups?kiosk=0",+ "/alerts/history?kiosk=1",+ "/alerts/history?kiosk=0"+ ],+ "viewports": [+ {+ "width": 1024,+ "height": 768+ },+ {+ "width": 375,+ "height": 812+ }+ ],+ "states": [+ "Embedded production bundle built from origin/main 410d84c694 plus this staged change (FilterBar.tsx sha256 matches content_sha256), cross-compiled for darwin and run as a private mock-mode stack on 127.0.0.1:7893 with ALLOW_ADMIN_BYPASS, driven in the desktop app browser pane. The change was first verified the same way on d2ac0c5112 on 2026-10-08 with the identical FilterBar.tsx; this pass repeats it after main added the Proxmox and vSphere page, WorkloadsFilter and WorkloadsSurface changes from the toolbar removal",+ "Baseline on unmodified main (2026-10-08, DEMO_MODE mock stack, headless Chromium 1440x900): with kiosk on, filter bars rendered on /proxmox/overview, /vmware/overview, /docker/overview, /kubernetes/overview, /truenas/overview, /standalone, /proxmox/backups and /alerts/history; only the Proxmox Storage tab hid its bar",+ "Kiosk on at 1024x768: zero .filter-bar elements and zero visible inputs on all nine routes; tables still render (Proxmox nodes and guests, vSphere 3, Docker 2, Kubernetes 6, TrueNAS 2, Machines 1, Proxmox Storage 1, Backups 2); Alert History shows its frequency card and list; no empty card or bordered shell where a bar was; no horizontal page overflow",+ "Kiosk off at 1024x768 (control): every one of those routes renders its bar again (Proxmox workload filters, vSphere workload filters, Search containers, Search workload inventory, Search TrueNAS alerts, Search machines, Proxmox storage filters, Backups filters, Alert history filters)",+ "Applied filter state survives kiosk: /proxmox/overview?q=minio shows Guests 3 with 6 rows with the bar hidden in kiosk, and the bar returns with minio in the search field after leaving kiosk",+ "Phone 375x812 with kiosk on: /proxmox/overview, /docker/overview and /vmware/overview have no bar, no Filters toggle, no input and no horizontal overflow; with kiosk off the same three pages show their bar and the Filters toggle",+ "Console: no errors"+ ],+ "interactions": [+ "Pressed p, v, e with kiosk on at /proxmox/overview: URL unchanged, focus stayed on body, 58 guest rows unchanged",+ "Pressed p, v, e with kiosk off (control): type-to-search took the keys and the URL became ?q=pve",+ "Clicked the header Enter kiosk mode button with ?q=minio applied: bar unmounted without a reload, rows stayed narrowed",+ "Hovered the top edge to reveal the kiosk header and clicked Exit kiosk mode: bar remounted with minio in the search field",+ "Resized to 375x812 (mobile emulation) and back to desktop, re-checking bars, Filters toggle and overflow"+ ]+}diff --git a/frontend-modern/src/components/Workloads/__tests__/WorkloadsFilter.test.tsx b/frontend-modern/src/components/Workloads/__tests__/WorkloadsFilter.test.tsxindex ea0140dc6d..ee796688b2 100644--- a/frontend-modern/src/components/Workloads/__tests__/WorkloadsFilter.test.tsx+++ b/frontend-modern/src/components/Workloads/__tests__/WorkloadsFilter.test.tsx@@ -2,6 +2,7 @@ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';import { render, screen, cleanup, fireEvent, within } from '@solidjs/testing-library';import { createSignal } from 'solid-js';import { WorkloadsFilter } from '../WorkloadsFilter';+import { setKioskMode } from '@/utils/url';import workloadsFilterSource from '../WorkloadsFilter.tsx?raw';import {DEFAULT_WORKLOADS_SORT_DIRECTION,@@ -957,3 +958,33 @@ describe('WorkloadsFilter', () => {});});});++describe('WorkloadsFilter in kiosk mode', () => {+ beforeEach(() => {+ vi.clearAllMocks();+ isMobileMock.mockReturnValue(false);+ window.localStorage.clear();+ });++ afterEach(() => {+ setKioskMode(false);+ window.sessionStorage.removeItem('pulse_kiosk_mode');+ cleanup();+ });++ it('keeps the Proxmox and vSphere workload toolbar off a kiosk display and restores it afterwards', () => {+ setKioskMode(true);+ render(() => <WorkloadsFilter {...makeProps({ ariaLabel: 'Proxmox workload filters' })} />);++ expect(screen.queryByTestId('search-input')).not.toBeInTheDocument();+ expect(+ screen.queryByRole('group', { name: 'Proxmox workload filters' }),+ ).not.toBeInTheDocument();+ expect(screen.queryByRole('button', { name: 'View' })).not.toBeInTheDocument();++ setKioskMode(false);++ expect(screen.getByTestId('search-input')).toBeInTheDocument();+ expect(screen.getByRole('button', { name: 'View' })).toBeInTheDocument();+ });+});diff --git a/frontend-modern/src/components/shared/FilterBar/FilterBar.test.tsx b/frontend-modern/src/components/shared/FilterBar/FilterBar.test.tsxindex e29aa39989..0a1380cef0 100644--- a/frontend-modern/src/components/shared/FilterBar/FilterBar.test.tsx+++ b/frontend-modern/src/components/shared/FilterBar/FilterBar.test.tsx@@ -1,8 +1,9 @@-import { cleanup, fireEvent, render, screen, within } from '@solidjs/testing-library';+import { cleanup, fireEvent, render, screen, waitFor, within } from '@solidjs/testing-library';import { afterEach, describe, expect, it, vi } from 'vitest';import { FilterBar } from './FilterBar';import type { FilterDef } from './filterCatalog';import { createSignal } from 'solid-js';+import { setKioskMode } from '@/utils/url';const search = {value: () => '',@@ -440,3 +441,64 @@ describe('FilterBar', () => {).not.toBeInTheDocument();});});++describe('FilterBar in kiosk mode', () => {+ afterEach(() => {+ setKioskMode(false);+ window.sessionStorage.removeItem('pulse_kiosk_mode');+ cleanup();+ vi.clearAllMocks();+ });++ it('stays unmounted while kiosk mode is on and returns when it ends', () => {+ setKioskMode(true);+ const { container } = render(() => (+ <FilterBar+ role="group"+ ariaLabel="Guest filters"+ search={search}+ filters={[inlineTypeFilter(), menuNodeFilter()]}+ isMobile={() => false}+ viewOptions={<span>Bars</span>}+ />+ ));++ expect(container.querySelector('.filter-bar')).toBeNull();+ expect(screen.queryByPlaceholderText('Search')).not.toBeInTheDocument();+ expect(screen.queryByRole('group', { name: 'Type' })).not.toBeInTheDocument();++ setKioskMode(false);++ expect(screen.getByRole('group', { name: 'Guest filters' })).toBeInTheDocument();+ expect(screen.getByPlaceholderText('Search')).toBeInTheDocument();+ expect(screen.getByRole('group', { name: 'Type' })).toBeInTheDocument();+ });++ it('leaves typed characters alone in kiosk mode instead of filtering the display', async () => {+ setKioskMode(true);+ const setValue = vi.fn();+ render(() => (+ <>+ <button type="button">Outside</button>+ <FilterBar search={{ ...search, setValue }} filters={[]} isMobile={() => false} />+ </>+ ));+ const outside = screen.getByRole('button', { name: 'Outside' });+ outside.focus();++ fireEvent.keyDown(document, { key: 'q' });+ // Type-to-search inserts the key from a queued task, so let it run while+ // kiosk is still on before judging the result.+ await new Promise((resolve) => setTimeout(resolve, 0));++ expect(setValue).not.toHaveBeenCalled();+ expect(document.activeElement).toBe(outside);++ setKioskMode(false);+ outside.focus();+ fireEvent.keyDown(document, { key: 'a' });++ await waitFor(() => expect(setValue).toHaveBeenCalledWith('a'));+ expect(setValue).not.toHaveBeenCalledWith(expect.stringContaining('q'));+ });+});diff --git a/frontend-modern/src/components/shared/FilterBar/FilterBar.tsx b/frontend-modern/src/components/shared/FilterBar/FilterBar.tsxindex 4488d97a77..e52edad46f 100644--- a/frontend-modern/src/components/shared/FilterBar/FilterBar.tsx+++ b/frontend-modern/src/components/shared/FilterBar/FilterBar.tsx@@ -4,6 +4,7 @@ import { Card } from '@/components/shared/Card';import { FilterButtonGroup } from '@/components/shared/FilterButtonGroup';import { FilterActionButton, FilterMobileToggleButton } from '@/components/shared/FilterToolbar';import { SearchInput } from '@/components/shared/SearchInput';+import { useKioskMode } from '@/hooks/useKioskMode';import { AddFilterMenu } from './AddFilterMenu';import { FilterChip } from './FilterChip';import {@@ -80,7 +81,7 @@ const FilterSearchTermChip: Component<{</div>);-export const FilterBar: Component<FilterBarProps> = (props) => {+const FilterBarToolbar: Component<FilterBarProps> = (props) => {const [mobileExpanded, setMobileExpanded] = createSignal(false);const [searchDraft, setSearchDraft] = createSignal('');const [searchTerms, setSearchTerms] = createSignal<FilterSearchTerm[]>([]);@@ -367,3 +368,15 @@ export const FilterBar: Component<FilterBarProps> = (props) => {</Card>);};++// Kiosk mode is the read-only wall display, so every filter toolbar stays+// unmounted there, type-to-search listener included. The shared bar owns the+// rule so a page that moves or adds a toolbar cannot drop it.+export const FilterBar: Component<FilterBarProps> = (props) => {+ const kioskMode = useKioskMode();+ return (+ <Show when={!kioskMode()}>+ <FilterBarToolbar {...props} />+ </Show>+ );+};diff --git a/frontend-modern/src/components/shared/SharedPrimitives.guardrails.test.ts b/frontend-modern/src/components/shared/SharedPrimitives.guardrails.test.tsindex 029eecd4dd..87c5a94539 100644--- a/frontend-modern/src/components/shared/SharedPrimitives.guardrails.test.ts+++ b/frontend-modern/src/components/shared/SharedPrimitives.guardrails.test.ts@@ -8534,6 +8534,9 @@ describe('shared primitive guardrails', () => {expect(filterBarSource).not.toContain('LabeledFilterSelect');expect(filterBarSource).not.toContain('LabeledFilterToggleGroup');expect(filterBarSource).not.toContain('filterControlsVariant');+ // Kiosk hiding lives in the shared bar, not in each page that mounts one.+ expect(filterBarSource).toContain("import { useKioskMode } from '@/hooks/useKioskMode';");+ expect(filterBarSource).toContain('<Show when={!kioskMode()}>');expect(filterChipSource).toContain('clearFilter,');expect(filterChipSource).toContain('formatFilterChipValue,');diff --git a/frontend-modern/src/features/platformPage/__tests__/PlatformTableToolbar.kiosk.test.tsx b/frontend-modern/src/features/platformPage/__tests__/PlatformTableToolbar.kiosk.test.tsxnew file mode 100644index 0000000000..11f341654e--- /dev/null+++ b/frontend-modern/src/features/platformPage/__tests__/PlatformTableToolbar.kiosk.test.tsx@@ -0,0 +1,43 @@+import { afterEach, describe, expect, it, vi } from 'vitest';+import { cleanup, render, screen } from '@solidjs/testing-library';+import { PlatformTableToolbar } from '../sharedPlatformPage';+import { setKioskMode } from '@/utils/url';++const renderToolbar = () =>+ render(() => (+ <PlatformTableToolbar+ search={() => ''}+ onSearchChange={vi.fn()}+ searchPlaceholder="Search containers"+ status="all"+ onStatusChange={vi.fn()}+ statusOptions={[+ { value: 'all', label: 'All' },+ { value: 'healthy', label: 'Healthy' },+ ]}+ visible={3}+ total={3}+ rowNoun="container"+ />+ ));++describe('PlatformTableToolbar in kiosk mode', () => {+ afterEach(() => {+ setKioskMode(false);+ window.sessionStorage.removeItem('pulse_kiosk_mode');+ cleanup();+ });++ it('stays off a kiosk display so no platform table carries search or filters, and returns after kiosk', () => {+ setKioskMode(true);+ renderToolbar();++ expect(screen.queryByPlaceholderText('Search containers')).not.toBeInTheDocument();+ expect(screen.queryByRole('group', { name: 'Status' })).not.toBeInTheDocument();++ setKioskMode(false);++ expect(screen.getByPlaceholderText('Search containers')).toBeInTheDocument();+ expect(screen.getByRole('group', { name: 'Status' })).toBeInTheDocument();+ });+});