Skip to content

Modern Docker Management, Designed for Everyone

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.go
index 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.go
index 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.go
index 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.json
index 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.css
index 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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.css
diff --git a/frontend/src/routes/(app)/settings/appearance/+page.svelte b/frontend/src/routes/(app)/settings/appearance/+page.svelte
index 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.svelte
index 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.go
index 0df4b1ff6..d07d576b8 100644
--- a/types/settings/settings.go
+++ b/types/settings/settings.go
@@ -418,6 +418,16 @@ type Update struct {
// Required: false
KeyboardShortcutsEnabled *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