Modern Docker Management, Designed for Everyone
Go composecontainer-managementcontainersdockerdocker-composedocker-managementgoself-hostedsveltekittypescriptweb-ui
feat: add appearance toggles for blur and interface animations (#3091)
Ben0249f7577eea
diff --git a/backend/internal/configschema/schema_test.go b/backend/internal/configschema/schema_test.goindex 0b4634cb6..08460dc79 100644--- a/backend/internal/configschema/schema_test.go+++ b/backend/internal/configschema/schema_test.go@@ -266,6 +266,7 @@ var expectedSettingOverrideKeys = []string{"accentColor","activityHistoryMaxEntries","activityHistoryRetentionDays",+ "animationsEnabled","applicationTheme","authLocalEnabled","authPasswordPolicy",@@ -302,6 +303,7 @@ var expectedSettingOverrideKeys = []string{"gitSyncMaxBinarySizeMb","gitSyncMaxFiles","gitSyncMaxTotalSizeMb",+ "glassEffectsEnabled","httpClientTimeout","iconCatalog","keyboardShortcutsEnabled",diff --git a/backend/internal/models/settings.go b/backend/internal/models/settings.goindex b6c622e1c..c263ee981 100644--- a/backend/internal/models/settings.go+++ b/backend/internal/models/settings.go@@ -170,6 +170,8 @@ type Settings struct {MobileNavigationShowLabels SettingVariable `key:"mobileNavigationShowLabels,authrequired,local" meta:"label=Show Navigation Labels;type=boolean;keywords=labels,text,icons,display,show,hide,names,captions,titles,visible,toggle;category=appearance;description=Display text labels alongside navigation icons"`SidebarHoverExpansion SettingVariable `key:"sidebarHoverExpansion,authrequired,local" meta:"label=Sidebar Hover Expansion;type=boolean;keywords=sidebar,hover,expansion,expand,desktop,mouse,over,collapsed,collapsible,icon,labels,text,preview,peek,tooltip,overlay,temporary,quick,access,navigation,menu,items,submenu,nested;category=appearance;description=Expand sidebar on hover in desktop mode"`KeyboardShortcutsEnabled SettingVariable `key:"keyboardShortcutsEnabled,authrequired,local" meta:"label=Keyboard Shortcuts;type=boolean;keywords=keyboard,shortcuts,hotkeys,keybindings,navigation,tooltips,disable;category=appearance;description=Enable keyboard shortcuts for navigation and show shortcut hints in tooltips"`+ GlassEffectsEnabled SettingVariable `key:"glassEffectsEnabled,public,local" meta:"label=Glass & Blur Effects;type=boolean;keywords=blur,glass,glassmorphism,backdrop,transparency,frosted,performance,gpu,appearance;category=appearance;description=Apply blur and glass effects to UI surfaces. Disable for solid surfaces and lower GPU usage."`+ AnimationsEnabled SettingVariable `key:"animationsEnabled,public,local" meta:"label=Interface Animations;type=boolean;keywords=animation,animations,motion,shimmer,pulse,glow,effects,performance,gpu,appearance;category=appearance;description=Enable decorative interface animations. Disable to reduce motion and GPU usage."`// Notifications category (placeholder for category metadata only - actual settings managed via notification service)NotificationsCategoryPlaceholder SettingVariable `key:"notificationsCategory,internal" meta:"label=Notifications;type=internal;keywords=notifications,alerts,email,discord,webhooks,events,messages;category=notifications;description=Configure notification providers and alerts" catmeta:"id=notifications;title=Notifications;icon=bell;url=/settings/notifications;description=Configure email and Discord notifications for container and image updates"`diff --git a/backend/internal/services/settings_service.go b/backend/internal/services/settings_service.goindex 07c084c40..8dabfd6a1 100644--- a/backend/internal/services/settings_service.go+++ b/backend/internal/services/settings_service.go@@ -189,6 +189,8 @@ func DefaultSettingsConfig() *models.Settings {IconCatalog: models.SettingVariable{Value: "selfhst"},AccentColor: models.SettingVariable{Value: "oklch(0.606 0.25 292.717)"},OledMode: models.SettingVariable{Value: "false"},+ GlassEffectsEnabled: models.SettingVariable{Value: "true"},+ AnimationsEnabled: models.SettingVariable{Value: "true"},MaxImageUploadSize: models.SettingVariable{Value: "500"},GitSyncMaxFiles: models.SettingVariable{Value: "500"},GitSyncMaxTotalSizeMb: models.SettingVariable{Value: "50"},diff --git a/frontend/messages/en.json b/frontend/messages/en.jsonindex db3f73e91..11eb2777c 100644--- a/frontend/messages/en.json+++ b/frontend/messages/en.json@@ -1754,6 +1754,10 @@"oled_mode_disabled": "Disabled","oled_mode_requires_dark": "Enable dark mode to use OLED mode.","oled_mode_requires_default_theme": "Switch back to the Default application theme to use OLED mode.",+ "glass_effects": "Glass & Blur Effects",+ "glass_effects_description": "Apply blur and glass effects to UI surfaces such as cards, dialogs, and navigation. Disable for solid surfaces and lower GPU usage.",+ "interface_animations": "Interface Animations",+ "interface_animations_description": "Enable decorative interface animations such as ambient glows and pulsing indicators. Disable to reduce motion and GPU usage.","navigation_mode_label": "Navigation Mode","navigation_mode_description": "Choose between floating navigation that overlays content or docked navigation that takes up screen space","navigation_mode_floating": "Floating",diff --git a/frontend/src/app.css b/frontend/src/app.cssindex 59322f56e..388c9863a 100644--- a/frontend/src/app.css+++ b/frontend/src/app.css@@ -587,6 +587,54 @@--glass-shadow-color: oklch(0 0 0 / 0.6);}+/*+ * Appearance performance modes (Settings → Appearance), toggled on <html> from+ * theme.ts. Absent by default, so existing installs keep the frosted-glass look+ * until a user opts out.+ *+ * `no-blur` strips backdrop-filter and makes glass surfaces opaque —+ * backdrop-filter is the dominant GPU cost on Firefox/Zen.+ * `reduce-effects` neutralizes decorative animations and transitions.+ */+html.no-blur *,+html.no-blur *::before,+html.no-blur *::after {+ -webkit-backdrop-filter: none !important;+ backdrop-filter: none !important;+}++html.no-blur :is([class^='bg-card/'], [class*=' bg-card/']) {+ background-color: var(--card) !important;+}+html.no-blur :is([class^='bg-background/'], [class*=' bg-background/']) {+ background-color: var(--background) !important;+}+html.no-blur :is([class^='bg-popover/'], [class*=' bg-popover/']) {+ background-color: var(--popover) !important;+}+html.no-blur :is([class^='bg-input/'], [class*=' bg-input/']) {+ background-color: var(--input) !important;+}++/* Modal/sheet/drawer scrims relied on blur for separation — keep them dimmed+ (not solid) so dialogs stay legible in light and dark mode. */+html.no-blur :is(.bg-white\/10, .bg-black\/40, .bg-black\/60) {+ background-color: color-mix(in oklab, black 55%, transparent) !important;+}++/* Neutralize every animation and transition — catches CSS keyframes as well as+ Svelte component transitions (dialogs, sheets, tooltips, popovers, activity+ center, profile menu). */+html.reduce-effects *,+html.reduce-effects *::before,+html.reduce-effects *::after {+ animation-duration: 0.001ms !important;+ animation-delay: 0ms !important;+ animation-iteration-count: 1 !important;+ transition-duration: 0.001ms !important;+ transition-delay: 0ms !important;+}+@theme inline {--radius-sm: calc(var(--radius) * 0.6);--radius-md: calc(var(--radius) * 0.8);diff --git a/frontend/src/lib/stores/config-store.ts b/frontend/src/lib/stores/config-store.tsindex d90dae04f..d03fa647b 100644--- a/frontend/src/lib/stores/config-store.ts+++ b/frontend/src/lib/stores/config-store.ts@@ -1,8 +1,12 @@import { settingsService } from '$lib/services/settings-service';import type { Settings } from '$lib/types/settings';-import { applyAccentColor } from '$lib/utils/theme';-import { applyApplicationTheme } from '$lib/utils/theme';-import { applyOledMode } from '$lib/utils/theme';+import {+ applyAccentColor,+ applyApplicationTheme,+ applyOledMode,+ applyGlassEffects,+ applyInterfaceAnimations+} from '$lib/utils/theme';import { get, writable } from 'svelte/store';const settingsStore = writable<Settings>();@@ -17,6 +21,8 @@ const set = (settings: Settings) => {applyApplicationTheme(settings.applicationTheme);applyAccentColor(settings.accentColor);applyOledMode(settings.oledMode ?? false);+ applyGlassEffects(settings.glassEffectsEnabled ?? true);+ applyInterfaceAnimations(settings.animationsEnabled ?? true);settingsStore.set(settings);};diff --git a/frontend/src/lib/types/settings.ts b/frontend/src/lib/types/settings.tsindex fa781b144..47c5dbd64 100644--- a/frontend/src/lib/types/settings.ts+++ b/frontend/src/lib/types/settings.ts@@ -58,6 +58,8 @@ export type Settings = {iconCatalog: IconCatalog;accentColor: string;oledMode: boolean;+ glassEffectsEnabled: boolean;+ animationsEnabled: boolean;autoInjectEnv: boolean;backupVolumeName?: string;edgeMTLSManagerCAAvailable?: boolean;diff --git a/frontend/src/lib/utils/settings.ts b/frontend/src/lib/utils/settings.tsindex bb6b66fec..52cebf8e1 100644--- a/frontend/src/lib/utils/settings.ts+++ b/frontend/src/lib/utils/settings.ts@@ -10,6 +10,8 @@ export type LocalSettings = {iconCatalog: IconCatalog;accentColor: string;oledMode: boolean;+ glassEffectsEnabled: boolean;+ animationsEnabled: boolean;mobileNavigationMode: string;mobileNavigationShowLabels: boolean;sidebarHoverExpansion: boolean;@@ -23,6 +25,8 @@ const LOCAL_SETTING_KEYS = new Set(['iconCatalog','accentColor','oledMode',+ 'glassEffectsEnabled',+ 'animationsEnabled','mobileNavigationMode','mobileNavigationShowLabels','sidebarHoverExpansion',diff --git a/frontend/src/lib/utils/theme.ts b/frontend/src/lib/utils/theme.tsindex 3a994ac0f..ac4aa138f 100644--- a/frontend/src/lib/utils/theme.ts+++ b/frontend/src/lib/utils/theme.ts@@ -365,6 +365,35 @@ export function applyOledMode(enabled: boolean): void {syncBrowserThemeColor();}+const NO_BLUR_CLASS = 'no-blur';+const REDUCE_EFFECTS_CLASS = 'reduce-effects';++/**+ * Toggle glass / backdrop-blur effects. When disabled, the `no-blur` class on+ * <html> drives app.css to strip every backdrop-filter and make glass surfaces+ * opaque — the main lever for cutting GPU usage on Firefox-based browsers.+ */+export function applyGlassEffects(enabled: boolean): void {+ if (typeof document === 'undefined') {+ return;+ }++ document.documentElement.classList.toggle(NO_BLUR_CLASS, !enabled);+}++/**+ * Toggle decorative, always-on interface animations (ambient login shimmer,+ * loading-bar glow, pulse indicators). When disabled we add a `reduce-effects`+ * class to <html> and app.css halts those animations.+ */+export function applyInterfaceAnimations(enabled: boolean): void {+ if (typeof document === 'undefined') {+ return;+ }++ document.documentElement.classList.toggle(REDUCE_EFFECTS_CLASS, !enabled);+}+export const FONT_SIZE_MIN = 12;export const FONT_SIZE_MAX = 20;export const FONT_SIZE_DEFAULT = 14; // matches `html { font-size: 14px }` in app.cssdiff --git a/frontend/src/routes/(app)/settings/appearance/+page.svelte b/frontend/src/routes/(app)/settings/appearance/+page.svelteindex 641923abc..f377855c4 100644--- a/frontend/src/routes/(app)/settings/appearance/+page.svelte+++ b/frontend/src/routes/(app)/settings/appearance/+page.svelte@@ -19,6 +19,7 @@import { applyAccentColor } from '$lib/utils/theme';import { APPLICATION_THEME_VALUES, applyApplicationTheme } from '$lib/utils/theme';import { applyOledMode } from '$lib/utils/theme';+ import { applyGlassEffects, applyInterfaceAnimations } from '$lib/utils/theme';import { AppearanceIcon, MonitorSpeakerIcon, DockIcon } from '$lib/icons';import { cn } from '$lib/utils';@@ -36,7 +37,9 @@accentColor: z.string(),enableGravatar: z.boolean(),avatarMaxUploadSizeMb: z.coerce.number().int().min(1).max(50),- oledMode: z.boolean()+ oledMode: z.boolean(),+ glassEffectsEnabled: z.boolean(),+ animationsEnabled: z.boolean()});// Track local override state using the shared store@@ -64,6 +67,8 @@applyApplicationTheme(currentSettings.applicationTheme);applyAccentColor(currentSettings.accentColor);applyOledMode(currentSettings.oledMode ?? false);+ applyGlassEffects(currentSettings.glassEffectsEnabled ?? true);+ applyInterfaceAnimations(currentSettings.animationsEnabled ?? true);}onDestroy(() => {@@ -122,6 +127,18 @@applyOledMode(checked);}+ function handleGlassEffectsChange(checked: boolean) {+ $formInputs.glassEffectsEnabled.value = checked;+ // Live preview: apply immediately so the user sees the effect+ applyGlassEffects(checked);+ }++ function handleAnimationsChange(checked: boolean) {+ $formInputs.animationsEnabled.value = checked;+ // Live preview: apply immediately so the user sees the effect+ applyInterfaceAnimations(checked);+ }+function handleLabelsSegmentSelect(segment: 'default' | 'on' | 'off') {if (segment === 'default') {clearLocalOverride('showLabels');@@ -247,6 +264,24 @@onCheckedChange={handleOledModeChange}/></SettingsRow>++ <SettingsRow label={m.glass_effects()} description={m.glass_effects_description()} layout="inline">+ <Switch+ id="glassEffectsEnabled"+ checked={$formInputs.glassEffectsEnabled.value}+ disabled={isReadOnly}+ onCheckedChange={handleGlassEffectsChange}+ />+ </SettingsRow>++ <SettingsRow label={m.interface_animations()} description={m.interface_animations_description()} layout="inline">+ <Switch+ id="animationsEnabled"+ checked={$formInputs.animationsEnabled.value}+ disabled={isReadOnly}+ onCheckedChange={handleAnimationsChange}+ />+ </SettingsRow></div></div>diff --git a/frontend/src/routes/(auth)/login/+page.svelte b/frontend/src/routes/(auth)/login/+page.svelteindex bf9938e7d..d3dc34aa4 100644--- a/frontend/src/routes/(auth)/login/+page.svelte+++ b/frontend/src/routes/(auth)/login/+page.svelte@@ -20,6 +20,13 @@let password = $state('');const queryClient = useQueryClient();+ // The ambient shimmer is a ~300vmax rotating conic-gradient that pegs the GPU+ // on Firefox-based browsers. `animationsEnabled` is a public setting, so it+ // reaches this pre-auth page via data.settings — skip rendering the shimmer+ // when animations are disabled. (OS reduced-motion is handled by the+ // prefers-reduced-motion rule in the <style> below.)+ const showAmbientMotion = $derived(data.settings?.animationsEnabled !== false);+const accentColor = $derived(data.settings?.accentColor);const logoUrl = $derived(getApplicationLogo(false, accentColor, accentColor));@@ -98,7 +105,9 @@<div class="ambient" aria-hidden="true"><div class="ambient__mesh"></div>- <div class="ambient__shimmer"></div>+ {#if showAmbientMotion}+ <div class="ambient__shimmer"></div>+ {/if}<div class="ambient__grid"></div><div class="ambient__noise"></div><div class="ambient__vignette"></div>diff --git a/types/settings/settings.go b/types/settings/settings.goindex 0df4b1ff6..d07d576b8 100644--- a/types/settings/settings.go+++ b/types/settings/settings.go@@ -418,6 +418,16 @@ type Update struct {// Required: falseKeyboardShortcutsEnabled *string `json:"keyboardShortcutsEnabled,omitempty"`+ // GlassEffectsEnabled indicates if blur/glass effects are applied to UI surfaces.+ //+ // Required: false+ GlassEffectsEnabled *string `json:"glassEffectsEnabled,omitempty"`++ // AnimationsEnabled indicates if decorative interface animations are enabled.+ //+ // Required: false+ AnimationsEnabled *string `json:"animationsEnabled,omitempty"`+// DockerApiTimeout is the timeout for Docker API operations in seconds.//// Required: false