Skip to content

Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.

Studio: keep Glass cheap on the Linux app by dropping its live blur except the sidebar's (#16957)

Daniel Han0992bd3e8a9b
diff --git a/studio/frontend/src/features/chat-background/material.ts b/studio/frontend/src/features/chat-background/material.ts
index d1df5d90acc..c7c98ad17a2 100644
--- a/studio/frontend/src/features/chat-background/material.ts
+++ b/studio/frontend/src/features/chat-background/material.ts
@@ -5,6 +5,7 @@
import { isMacPlatform } from "@/features/settings/lib/keyboard-shortcuts";
// eslint-disable-next-line no-restricted-imports
import { useTheme } from "@/features/settings/stores/theme-store";
+import { isWebKitGTK } from "@/components/ui/theme-view-transition";
import { isTauri } from "@/lib/api-base";
import { useEffect, useState } from "react";
import { create } from "zustand";
@@ -177,6 +178,12 @@ const WEBKIT_LAYERS =
typeof navigator !== "undefined" &&
/AppleWebKit/.test(navigator.userAgent) &&
!/Chrom|Edg|Android/i.test(navigator.userAgent);
+// WebKitGTK (the Linux app) also runs every backdrop-filter again on each composite, on the CPU, so
+// there glass drops its live blur except the sidebar's (index.css, data-glass-cpu). macOS WebKit
+// composites backdrops on the GPU and keeps real frosted glass.
+const WEBKIT_GTK =
+ typeof navigator !== "undefined" &&
+ isWebKitGTK(navigator.platform, navigator.userAgent);
export function WindowMaterialMount({ route }: { route?: BackgroundRoute }) {
const material = useMaterialStore((s) => s.material);
@@ -230,6 +237,12 @@ export function WindowMaterialMount({ route }: { route?: BackgroundRoute }) {
WEBKIT_LAYERS && material !== "solid" && material !== "transparent" && here,
);
}, [material, here]);
+ useEffect(() => {
+ document.documentElement.toggleAttribute(
+ "data-glass-cpu",
+ WEBKIT_GTK && material !== "solid" && material !== "transparent" && here,
+ );
+ }, [material, here]);
useEffect(() => {
const root = document.documentElement;
const wantsNative = material === "macos" && nativeMaterialAvailable();
diff --git a/studio/frontend/src/index.css b/studio/frontend/src/index.css
index aa3862af098..3ddb7c446d9 100644
--- a/studio/frontend/src/index.css
+++ b/studio/frontend/src/index.css
@@ -6494,7 +6494,7 @@ html[data-glass][data-chat-wallpaper-workspace-ready]:not([data-glass-plain]) [d
html[data-glass^="liquid"] :is([data-wallpaper-workspace], [data-chat-content-root]):has(> .chat-wallpaper[data-ready]) :is(.unsloth-composer-surface, .unsloth-files-panel),
html[data-glass^="liquid"] .wallpaper-preview-composer {
position: relative;
- background-image: var(--glass-sheen);
+ background-image: var(--glass-glow, none), var(--glass-sheen);
--composer-shadow: var(--glass-rim);
}
/* The bevel: a gradient ring, since a gradient border-box layer would show through the clear fill. */
@@ -6814,7 +6814,7 @@ html[data-glass][data-glass-menus] :is([data-slot$="menu-content"], [data-slot$=
backdrop-filter: blur(max(var(--glass-blur), 18px)) saturate(var(--glass-saturate));
}
html[data-glass^="liquid"][data-glass-menus] :is([data-slot$="menu-content"], [data-slot$="menu-sub-content"], [data-slot="select-content"], [data-slot="combobox-content"], [data-slot="popover-content"], [data-slot="hover-card-content"], .menu-soft-surface, .menu-soft-surface-up, .dropdown-surface) {
- background-image: var(--glass-sheen);
+ background-image: var(--glass-glow, none), var(--glass-sheen);
}
/* Its fill is pinned (layered !important) to a surface resolved on <html>. */
html[data-glass][data-glass-menus] .browser-menu[data-slot] {
@@ -6905,7 +6905,7 @@ html[data-glass][data-glass-menus] :is([data-slot$="menu-content"], [data-slot$=
--color-panel-input-surface-hover: var(--glass-hover);
}
html[data-glass^="liquid"][data-glass-menus] [data-slot="dialog-content"] {
- background-image: var(--glass-sheen);
+ background-image: var(--glass-glow, none), var(--glass-sheen);
box-shadow: var(--glass-rim);
}
/* These panes clear the surface token, so ink drawn in the page colour (dark buttons' labels) takes the opaque one back. */
@@ -7258,3 +7258,91 @@ html[data-glass-clear] #root [data-slot="sidebar-inner"] :is(.bg-sidebar, .sideb
background-color: color-mix(in srgb, var(--glass-page-card) var(--glass-fill-alpha, 50%), transparent) !important;
}
}
+
+/* WebKitGTK only (data-glass-cpu, set by WindowMaterialMount): it runs every backdrop-filter again on
+ each composite, on the CPU, so a caret blink, a scrolled line or a menu frame re-blurred every glass
+ surface on screen and glass typing, scrolling and menus cost far more than solid. There only the
+ sidebar keeps its live blur (one static surface over the wallpaper costs little); the rest carry a
+ denser fill, and dialogs and menus an opaque one, so nothing behind them ghosts through. Blurs a
+ component sets itself (Tailwind backdrop-* classes) are not Glass's and stay as they are with Glass off. */
+html[data-glass][data-glass-cpu] *:not([data-slot="sidebar-inner"], [class*="backdrop-"]),
+html[data-glass][data-glass-cpu] *:not([data-windows-glass-frame], [class*="backdrop-"])::before,
+html[data-glass][data-glass-cpu] *:not([class*="backdrop-"])::after {
+ -webkit-backdrop-filter: none !important;
+ backdrop-filter: none !important;
+}
+html[data-glass][data-glass-cpu] {
+ --glass-composer-floor: 110%;
+ --glass-menu-floor: 110%;
+ --glass-opacity-set: var(--glass-opacity, 1);
+}
+/* A low strength would otherwise read as clear plastic with no blur behind it; above the floor the slider still works. */
+html[data-glass][data-glass-cpu] body {
+ --glass-opacity: max(.9, var(--glass-opacity-set));
+ --glass-menu-fill: var(--popover);
+}
+html[data-glass][data-glass-menus][data-glass-cpu] [data-slot="dialog-content"] {
+ background-color: var(--glass-page-bg);
+}
+/* Sonner's rule above sets its blur !important at a higher specificity than the universal one. */
+html[data-glass][data-glass-menus][data-glass-cpu] [data-sonner-toast][data-styled="true"] {
+ background-color: var(--popover) !important;
+ -webkit-backdrop-filter: none !important;
+ backdrop-filter: none !important;
+}
+/* Every surface that loses its blur above takes an opaque fill, or one dense enough that nothing behind it
+ reads through: text scrolling under a header or a menu over a page would otherwise overlap sharply. */
+/* Plain light glass (no image) gives menus their own thin fill; on this path they keep the opaque one. */
+html[data-glass][data-glass-menus][data-glass-plain][data-glass-cpu]:not(.dark) :is([data-slot$="menu-content"], [data-slot$="menu-sub-content"], [data-slot="select-content"], [data-slot="combobox-content"], [data-slot="popover-content"], [data-slot="hover-card-content"], .menu-soft-surface, .menu-soft-surface-up, .dropdown-surface) {
+ --glass-menu-fill: var(--glass-page-popover);
+}
+html[data-glass][data-glass-menus][data-glass-cpu] :is(.tooltip-compact, .tooltip-rich) {
+ background-color: var(--tooltip-bg);
+}
+/* Stuck page headers (the Library tab row): content scrolls under them. At rest they stay clear. */
+html[data-glass][data-glass-cpu][data-chat-wallpaper-workspace-ready] [data-wallpaper-workspace][data-wallpaper-route="page"] > [data-slot="sidebar-inset"] .sticky:not(.library-header-row:not([data-stuck]), [data-page-model-header]) {
+ background-color: var(--glass-page-bg);
+}
+/* Sticky bars inside panels, dialogs, sheets and menus. */
+html[data-glass][data-glass-cpu] :is([data-slot="chat-settings-panel"], [data-slot="dialog-content"], [data-slot="sheet-content"]) .sticky {
+ background-color: var(--glass-page-bg);
+}
+html[data-glass][data-glass-cpu] :is([data-slot$="popover-content"], [data-slot$="menu-content"]) .sticky {
+ background-color: var(--glass-page-popover);
+}
+/* Side panes over the wallpaper: the chat settings panel and the browser panel. */
+html[data-glass][data-glass-cpu][data-chat-wallpaper-workspace-ready] [data-slot="chat-settings-panel"],
+html[data-glass][data-glass-cpu][data-chat-wallpaper-workspace-ready]:not([data-browser-overlay-open]) [data-slot="browser-panel"] > .browser-chrome,
+html[data-glass][data-glass-cpu][data-chat-wallpaper-workspace-ready]:not([data-browser-overlay-open]) [data-slot="browser-panel"]:not([data-browser-document]) > .browser-panel-body {
+ background-color: var(--glass-panel-fill);
+}
+/* Light page controls and cards are thin white washes over the image. */
+html[data-glass][data-glass-cpu]:not(.dark) {
+ --glass-control: rgb(255 255 255 / .8);
+}
+html[data-glass][data-glass-cpu]:not(.dark)[data-chat-wallpaper-workspace-ready] [data-wallpaper-route="page"] > [data-slot="sidebar-inset"],
+html[data-glass][data-glass-cpu]:not(.dark)[data-chat-wallpaper-workspace-ready] [data-wallpaper-route="page"] > [data-slot="sidebar-inset"] .api-monitor-page {
+ --page-glass-card-fill: rgb(255 255 255 / .85);
+}
+/* Liquid 3D's wide inner glows and lifts are blurred box-shadows, which WebKitGTK re-rasterises on the
+ CPU whenever the surface repaints; there the glows are drawn as gradients and the lifts get a smaller blur. */
+html[data-glass="liquid-3d"][data-glass-cpu] {
+ --glass-rim: inset 0 1px 1px rgb(255 255 255 / .347);
+ --glass-glow: linear-gradient(rgb(255 255 255 / .2), rgb(255 255 255 / .05) 12px, transparent 26px), linear-gradient(to top, rgb(255 255 255 / .12), transparent 24px);
+ --glass-lift: 0 6px 14px -8px rgb(0 0 0 / .19), 0 2px 6px -4px rgb(0 0 0 / .075);
+ --popup-shadow: 0 6px 14px -8px rgb(0 0 0 / .12), 0 2px 6px -2px rgb(0 0 0 / .045);
+}
+html.dark[data-glass="liquid-3d"][data-glass-cpu] {
+ --glass-rim: inset 0 1px 1px rgb(255 255 255 / .109);
+ --glass-glow: linear-gradient(rgb(255 255 255 / .055), rgb(255 255 255 / .014) 12px, transparent 26px), linear-gradient(to top, rgb(255 255 255 / .028), transparent 24px);
+ --glass-lift: 0 0 8px 0 color-mix(in srgb, var(--background) 75%, transparent);
+ --popup-shadow: 0 8px 18px -8px rgb(0 0 0 / .52);
+}
+html[data-glass="liquid-3d"][data-glass-cpu] :is(.unsloth-composer-surface, .unsloth-files-panel, .wallpaper-preview-composer) {
+ --glass-rim: inset 0 1px 1px rgb(255 255 255 / .385), inset 0 0 0 1px color-mix(in srgb, var(--foreground) 9%, transparent);
+ --glass-glow: linear-gradient(rgb(255 255 255 / .22), rgb(255 255 255 / .06) 12px, transparent 26px), linear-gradient(to top, rgb(255 255 255 / .14), transparent 24px);
+}
+html.dark[data-glass="liquid-3d"][data-glass-cpu] :is(.unsloth-composer-surface, .unsloth-files-panel, .wallpaper-preview-composer) {
+ --glass-rim: inset 0 1px 1px rgb(255 255 255 / .121);
+ --glass-glow: linear-gradient(rgb(255 255 255 / .06), rgb(255 255 255 / .016) 12px, transparent 26px), linear-gradient(to top, rgb(255 255 255 / .032), transparent 24px);
+}
diff --git a/studio/frontend/tests/glass-webkit-blur.test.ts b/studio/frontend/tests/glass-webkit-blur.test.ts
new file mode 100644
index 00000000000..eef96920e31
--- /dev/null
+++ b/studio/frontend/tests/glass-webkit-blur.test.ts
@@ -0,0 +1,139 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright 2026-present the Unsloth AI Inc. team. All rights reserved. See /studio/LICENSE.AGPL-3.0
+
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import postcss from "postcss";
+
+import { readSrc } from "./helpers/kit.ts";
+
+const CSS = readSrc("index.css");
+const MATERIAL = readSrc("features/chat-background/material.ts");
+const GATE = "html[data-glass][data-glass-cpu]";
+
+function ruleAt(selectorStart: string): string {
+ const at = CSS.indexOf(selectorStart);
+ assert.ok(at > 0, `rule ${selectorStart} exists`);
+ return CSS.slice(at, CSS.indexOf("}", at) + 1);
+}
+
+test("the CPU glass flag is WebKitGTK only and follows the layer flag's material and scope gate", () => {
+ assert.match(MATERIAL, /import \{ isWebKitGTK \} from "@\/components\/ui\/theme-view-transition";/);
+ assert.match(
+ MATERIAL,
+ /const WEBKIT_GTK =\s*typeof navigator !== "undefined" &&\s*isWebKitGTK\(navigator\.platform, navigator\.userAgent\);/,
+ "macOS WebKit composites backdrops on the GPU and keeps real glass",
+ );
+ assert.match(
+ MATERIAL,
+ /toggleAttribute\(\s*"data-glass-cpu",\s*WEBKIT_GTK && material !== "solid" && material !== "transparent" && here,\s*\)/,
+ "solid, Transparent and out-of-scope routes never carry the flag",
+ );
+});
+
+test("WebKitGTK glass drops every live blur except the sidebar's", () => {
+ const rule = ruleAt(`${GATE} *:not([data-slot="sidebar-inner"], [class*="backdrop-"]),`);
+ assert.ok(
+ rule.includes(`${GATE} *:not([data-windows-glass-frame], [class*="backdrop-"])::before,`),
+ "the framed sidebar's glass keeps its blur",
+ );
+ assert.ok(rule.includes(`${GATE} *:not([class*="backdrop-"])::after {`), "a component's own backdrop-* blur is not Glass's");
+ assert.match(rule, /-webkit-backdrop-filter: none !important;/);
+ assert.match(rule, /\n\s*backdrop-filter: none !important;/);
+ assert.doesNotMatch(rule, /:has\(/, "a :has() here would re-match on every DOM change");
+ const toast = ruleAt(`html[data-glass][data-glass-menus][data-glass-cpu] [data-sonner-toast][data-styled="true"] {`);
+ assert.match(toast, /\n\s*backdrop-filter: none !important;/, "Sonner's own !important blur outranks the universal rule");
+});
+
+test("no later important blur can win the cascade back", () => {
+ const at = CSS.indexOf(`${GATE} *:not(`);
+ assert.doesNotMatch(CSS.slice(at), /backdrop-filter:\s*blur[^;]*!important/);
+});
+
+test("dialogs and menus go opaque on that path, so nothing behind them ghosts through", () => {
+ assert.match(ruleAt(`html[data-glass][data-glass-menus][data-glass-cpu] [data-slot="dialog-content"] {`), /background-color: var\(--glass-page-bg\);/);
+ const body = ruleAt(`${GATE} body {`);
+ assert.match(body, /--glass-menu-fill: var\(--popover\);/, "resolved on body, where --popover is still opaque");
+ assert.match(body, /--glass-opacity: max\(\.9, var\(--glass-opacity-set\)\);/);
+ const floors = ruleAt(`${GATE} {`);
+ assert.match(floors, /--glass-composer-floor: 110%;/, "over 100%, so the default strength reaches the 96% cap");
+ assert.doesNotMatch(floors, /--glass-sidebar-floor/, "the sidebar keeps its blur and its normal tint");
+ assert.match(floors, /--glass-opacity-set: var\(--glass-opacity, 1\);/);
+});
+
+test("WebKitGTK liquid 3D draws its wide inner glows as gradients, not blurred shadows", () => {
+ for (const sel of [
+ 'html[data-glass="liquid-3d"][data-glass-cpu] {',
+ 'html.dark[data-glass="liquid-3d"][data-glass-cpu] {',
+ 'html[data-glass="liquid-3d"][data-glass-cpu] :is(.unsloth-composer-surface',
+ 'html.dark[data-glass="liquid-3d"][data-glass-cpu] :is(.unsloth-composer-surface',
+ ]) {
+ const rule = ruleAt(sel);
+ const rim = /--glass-rim: ([^;]*);/.exec(rule)?.[1] ?? "";
+ assert.ok(rim, `${sel} sets the rim`);
+ for (const shadow of rim.split(/,(?![^(]*\))/)) {
+ const blur = /inset\s+-?[\d.]+(?:px)?\s+-?[\d.]+(?:px)?\s+([\d.]+)px/.exec(shadow)?.[1];
+ assert.ok(!blur || Number(blur) <= 2, `${sel}: no wide blurred inset (${shadow.trim()})`);
+ }
+ assert.match(rule, /--glass-glow: linear-gradient\(/);
+ }
+ const glowUses = CSS.match(/background-image: var\(--glass-glow, none\), var\(--glass-sheen\);/g) ?? [];
+ assert.equal(glowUses.length, 3, "composer, menus and dialogs; elsewhere --glass-glow is unset, so the layer is none");
+});
+
+test("the WebKitGTK rules are unlayered top-level rules", () => {
+ const found: string[] = [];
+ postcss.parse(CSS).walkRules((rule) => {
+ if (!rule.selector.includes("[data-glass-cpu]")) return;
+ found.push(rule.selector);
+ assert.equal(rule.parent?.type, "root", `${rule.selector} must not sit inside @layer or another block`);
+ });
+ assert.ok(found.length >= 9, "blur, fill, dialog, toast and glow rules all present");
+});
+
+// Every surface the CPU path strips of its blur, and what keeps text behind it from reading through.
+test("no surface that loses its blur is left with a see-through fill", () => {
+ const plainMenus = ruleAt('html[data-glass][data-glass-menus][data-glass-plain][data-glass-cpu]:not(.dark) :is(');
+ assert.match(plainMenus, /--glass-menu-fill: var\(--glass-page-popover\);/, "plain light menus set their own thin fill on the element");
+ assert.match(
+ ruleAt("html[data-glass][data-glass-menus][data-glass-cpu] :is(.tooltip-compact, .tooltip-rich) {"),
+ /background-color: var\(--tooltip-bg\);/,
+ );
+ const pageSticky = ruleAt(
+ 'html[data-glass][data-glass-cpu][data-chat-wallpaper-workspace-ready] [data-wallpaper-workspace][data-wallpaper-route="page"] > [data-slot="sidebar-inset"] .sticky:not(',
+ );
+ assert.match(pageSticky, /:not\(\.library-header-row:not\(\[data-stuck\]\), \[data-page-model-header\]\)/, "headers at rest stay clear");
+ assert.match(pageSticky, /background-color: var\(--glass-page-bg\);/);
+ assert.match(
+ ruleAt('html[data-glass][data-glass-cpu] :is([data-slot="chat-settings-panel"], [data-slot="dialog-content"], [data-slot="sheet-content"]) .sticky {'),
+ /background-color: var\(--glass-page-bg\);/,
+ );
+ assert.match(
+ ruleAt('html[data-glass][data-glass-cpu] :is([data-slot$="popover-content"], [data-slot$="menu-content"]) .sticky {'),
+ /background-color: var\(--glass-page-popover\);/,
+ );
+ const panes = ruleAt('html[data-glass][data-glass-cpu][data-chat-wallpaper-workspace-ready] [data-slot="chat-settings-panel"],');
+ assert.ok(panes.includes("> .browser-chrome,") && panes.includes("> .browser-panel-body {"));
+ assert.match(panes, /background-color: var\(--glass-panel-fill\);/);
+ assert.match(ruleAt("html[data-glass][data-glass-cpu]:not(.dark) {"), /--glass-control: rgb\(255 255 255 \/ \.8\);/);
+ assert.match(
+ ruleAt('html[data-glass][data-glass-cpu]:not(.dark)[data-chat-wallpaper-workspace-ready] [data-wallpaper-route="page"] > [data-slot="sidebar-inset"],'),
+ /--page-glass-card-fill: rgb\(255 255 255 \/ \.85\);/,
+ );
+});
+
+test("each CPU-path fill outranks the glass rule it replaces", () => {
+ // Same selector plus [data-glass-cpu]: one more attribute always wins, whatever the order.
+ const pairs: [string, string][] = [
+ ['html[data-glass][data-glass-menus][data-glass-plain]:not(.dark) :is(', 'html[data-glass][data-glass-menus][data-glass-plain][data-glass-cpu]:not(.dark) :is('],
+ ["html[data-glass][data-glass-menus] :is(.tooltip-compact, .tooltip-rich) {", "html[data-glass][data-glass-menus][data-glass-cpu] :is(.tooltip-compact, .tooltip-rich) {"],
+ ['html[data-glass][data-chat-wallpaper-workspace-ready] [data-wallpaper-workspace][data-wallpaper-route="page"] > [data-slot="sidebar-inset"] .sticky {',
+ 'html[data-glass][data-glass-cpu][data-chat-wallpaper-workspace-ready] [data-wallpaper-workspace][data-wallpaper-route="page"] > [data-slot="sidebar-inset"] .sticky:not('],
+ ["html[data-glass]:not(.dark) {", "html[data-glass][data-glass-cpu]:not(.dark) {"],
+ ];
+ for (const [base, cpu] of pairs) {
+ assert.ok(CSS.includes(base), `base rule still exists: ${base}`);
+ assert.ok(CSS.includes(cpu), `cpu override exists: ${cpu}`);
+ }
+});