The best way to control Claude Code, Codex and more from any computer or phone
refactor(web): document appearance and title are applied from app start (#25004)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Julius Marminge committed
Oct 25, 2026 at 15:31 UTC
4ee47883efefff2cea5a309d50b7ef642ac3005e
4 files changed
+111
-124
apps/web/src/appInit.tsx
new
+106
@@ -0,0 +1,106 @@
1
+import type { ClientSettings } from "@t3tools/contracts/settings";
2
+import { createBrowserHistory, createHashHistory } from "@tanstack/react-router";
3
+
4
+import { applyAppearanceContrast } from "./appearanceContrast";
5
+import { applyAppearanceFontVariables } from "./appearanceFonts";
6
+import { APP_BASE_NAME, APP_DISPLAY_NAME, APP_STAGE_LABEL } from "./branding";
7
+import { resolveServerBackedAppDisplayName } from "./branding.logic";
8
+import { isElectron } from "./env";
9
+import { getClientSettings, subscribeClientSettings } from "./hooks/useSettings";
10
+import {
11
+ syncDocumentElectronPlatformClasses,
12
+ syncDocumentWindowControlsOverlayClass,
13
+} from "./lib/windowControlsOverlay";
14
+import { prepareProviderAuthDelivery } from "./providerAuthDelivery";
15
+import { getRouter, type AppRouter } from "./router";
16
+import { appAtomRegistry } from "./rpc/atomRegistry";
17
+import { primaryServerConfigAtom } from "./state/server";
18
+
19
+/** Writes appearance settings onto the document, touching only the groups that changed. */
20
+function startClientAppearance(): void {
21
+ const root = document.documentElement;
22
+ let applied: ClientSettings | null = null;
23
+ const apply = () => {
24
+ const settings = getClientSettings();
25
+ const previous = applied;
26
+ applied = settings;
27
+ if (previous?.diffColorScheme !== settings.diffColorScheme) {
28
+ root.dataset.diffColorScheme = settings.diffColorScheme;
29
+ }
30
+ if (previous?.chatWidth !== settings.chatWidth) {
31
+ root.dataset.chatWidth = settings.chatWidth;
32
+ }
33
+ if (previous?.redesignEnabled !== settings.redesignEnabled) {
34
+ root.toggleAttribute("data-redesign", settings.redesignEnabled);
35
+ }
36
+ if (previous?.appearanceContrast !== settings.appearanceContrast) {
37
+ applyAppearanceContrast(root, settings.appearanceContrast);
38
+ }
39
+ if (previous?.glassOpacity !== settings.glassOpacity) {
40
+ root.style.setProperty("--glass-opacity", `${settings.glassOpacity}%`);
41
+ if (settings.glassOpacity === 100) {
42
+ root.style.setProperty("--glass-blur", "0px");
43
+ } else {
44
+ root.style.removeProperty("--glass-blur");
45
+ }
46
+ }
47
+ if (
48
+ previous?.fontFamilySans !== settings.fontFamilySans ||
49
+ previous.fontFamilyCode !== settings.fontFamilyCode ||
50
+ previous.fontFamilyComposer !== settings.fontFamilyComposer ||
51
+ previous.fontSizeInterface !== settings.fontSizeInterface ||
52
+ previous.fontSizePrompt !== settings.fontSizePrompt ||
53
+ previous.fontSizeCode !== settings.fontSizeCode ||
54
+ previous.fontSmoothing !== settings.fontSmoothing
55
+ ) {
56
+ applyAppearanceFontVariables(root, {
57
+ sans: settings.fontFamilySans,
58
+ code: settings.fontFamilyCode,
59
+ composer: settings.fontFamilyComposer,
60
+ sizeInterface: settings.fontSizeInterface,
61
+ sizePrompt: settings.fontSizePrompt,
62
+ sizeCode: settings.fontSizeCode,
63
+ smoothing: settings.fontSmoothing,
64
+ });
65
+ }
66
+ };
67
+ subscribeClientSettings(apply);
68
+ apply();
69
+}
70
+
71
+function startDocumentTitle(): void {
72
+ appAtomRegistry.subscribe(
73
+ primaryServerConfigAtom,
74
+ (config) => {
75
+ document.title = resolveServerBackedAppDisplayName({
76
+ baseName: APP_BASE_NAME,
77
+ fallbackDisplayName: APP_DISPLAY_NAME,
78
+ fallbackStageLabel: APP_STAGE_LABEL,
79
+ primaryServerVersion: config?.environment.serverVersion ?? null,
80
+ });
81
+ },
82
+ { immediate: true },
83
+ );
84
+}
85
+
86
+/**
87
+ * Starts every app-lifetime service once, before the first render, and returns the router.
88
+ * They run for the life of the page, so their disposers are dropped here.
89
+ */
90
+export function startAppServices(): AppRouter {
91
+ // Ahead of the history: the provider auth code must leave the address before anything reads it.
92
+ prepareProviderAuthDelivery();
93
+
94
+ // Electron loads the app from a file-backed shell, so hash history avoids path resolution issues.
95
+ const router = getRouter(isElectron ? createHashHistory() : createBrowserHistory());
96
+
97
+ if (isElectron) {
98
+ syncDocumentElectronPlatformClasses(navigator.platform);
99
+ syncDocumentWindowControlsOverlayClass();
100
+ }
101
+
102
+ startClientAppearance();
103
+ startDocumentTitle();
104
+
105
+ return router;
106
+}
apps/web/src/hooks/useSettings.ts
+1
-1
@@ -104,7 +104,7 @@ function setClientSettingsHydrationStatus(nextStatus: ClientSettingsHydrationSta
104
emitClientSettingsHydrationChange();
105
}
106
107
-function subscribeClientSettings(listener: () => void): () => void {
107
+export function subscribeClientSettings(listener: () => void): () => void {
108
clientSettingsListeners.add(listener);
109
void hydrateClientSettings().catch(() => undefined);
110
return () => {
apps/web/src/main.tsx
+3
-19
@@ -1,32 +1,16 @@
1
import React from "react";
2
import ReactDOM from "react-dom/client";
3
-import { createHashHistory, createBrowserHistory } from "@tanstack/react-router";
3
4
import "@fontsource-variable/inter";
5
import "./index.css";
6
8
-import { prepareProviderAuthDelivery } from "./providerAuthDelivery";
9
-import { isElectron } from "./env";
7
import { hasCloudPublicConfig } from "./cloud/publicConfig";
11
-import { getRouter } from "./router";
12
-import {
13
- syncDocumentElectronPlatformClasses,
14
- syncDocumentWindowControlsOverlayClass,
15
-} from "./lib/windowControlsOverlay";
8
+import { isElectron } from "./env";
9
+import { startAppServices } from "./appInit";
10
import { AppRoot } from "./AppRoot";
11
import { clearChunkReloadGuard, reloadOnceForChunkLoadError } from "./lib/chunkReloadGuard";
12
19
-prepareProviderAuthDelivery();
20
-
21
-// Electron loads the app from a file-backed shell, so hash history avoids path resolution issues.
22
-const history = isElectron ? createHashHistory() : createBrowserHistory();
23
-
24
-const router = getRouter(history);
25
-
26
-if (isElectron) {
27
- syncDocumentElectronPlatformClasses(navigator.platform);
28
- syncDocumentWindowControlsOverlayClass();
29
-}
13
+const router = startAppServices();
14
15
const clerkPublishableKey = import.meta.env.VITE_CLERK_PUBLISHABLE_KEY as string | undefined;
16
apps/web/src/routes/__root.tsx
+1
-104
@@ -14,8 +14,7 @@ import {
14
import { Check, Copy } from "lucide";
15
import { useEffect, useEffectEvent, useRef, useState } from "react";
16
17
-import { APP_BASE_NAME, APP_DISPLAY_NAME, APP_STAGE_LABEL, APP_VERSION } from "../branding";
18
-import { resolveServerBackedAppDisplayName } from "../branding.logic";
17
+import { APP_DISPLAY_NAME, APP_VERSION } from "../branding";
18
import { AppSidebarLayout } from "../components/AppSidebarLayout";
19
import { CommandPalette } from "../components/CommandPalette";
20
import { CustomSnoozeDialogHost } from "../components/CustomSnoozeDialog";
@@ -56,8 +55,6 @@ import {
55
} from "../components/ui/toast";
56
import { isElectron } from "../env";
57
import { cn } from "../lib/utils";
59
-import { applyAppearanceFontVariables } from "~/appearanceFonts";
60
-import { applyAppearanceContrast } from "~/appearanceContrast";
58
import { useClientSettings } from "../hooks/useSettings";
59
import {
60
deriveLogicalProjectKeyFromSettings,
@@ -170,7 +167,6 @@ function RootRouteView() {
167
if (pathname === "/pair" || pathname === "/connect" || pathname === "/connect-agent") {
168
return (
169
<>
173
- <DocumentTitleSync />
170
<BrowserChromeThemeSync key={pathname} />
171
<Outlet />
172
</>
@@ -181,7 +177,6 @@ function RootRouteView() {
177
if (hostedPromptLinkLanding !== null) {
178
return (
179
<>
184
- <DocumentTitleSync />
180
<BrowserChromeThemeSync key={pathname} />
181
{hostedPromptLinkLanding}
182
</>
@@ -192,12 +187,8 @@ function RootRouteView() {
187
return (
188
<ToastProvider>
189
<AnchoredToastProvider>
195
- <DocumentTitleSync />
190
<BrowserChromeThemeSync key={pathname} />
197
- <ContrastAppearanceSync />
191
<EnvironmentThemeSync />
199
- <GlassAppearanceSync />
200
- <FontAppearanceSync />
192
<ProviderAuthCallbackCoordinator />
193
<CustomSnoozeDialogHost />
194
<GuestShareDialogHost />
@@ -214,7 +205,6 @@ function RootRouteView() {
205
if (authGateState.status !== "authenticated" && authGateState.status !== "hosted-static") {
206
return (
207
<>
217
- <DocumentTitleSync />
208
<BrowserChromeThemeSync key={pathname} />
209
<Outlet />
210
</>
@@ -232,12 +222,8 @@ function RootRouteView() {
222
return (
223
<ToastProvider>
224
<AnchoredToastProvider>
235
- <DocumentTitleSync />
225
<BrowserChromeThemeSync key={pathname} />
237
- <ContrastAppearanceSync />
226
<EnvironmentThemeSync />
239
- <GlassAppearanceSync />
240
- <FontAppearanceSync />
227
<ProviderAuthCallbackCoordinator />
228
<ChatGptWelcomeCoordinator />
229
<FirstRunGate
@@ -285,78 +271,6 @@ function EnvironmentThemeSync() {
271
return null;
272
}
273
288
-function ContrastAppearanceSync() {
289
- const appearanceContrast = useClientSettings((settings) => settings.appearanceContrast);
290
- const diffColorScheme = useClientSettings((settings) => settings.diffColorScheme);
291
-
292
- useEffect(() => {
293
- document.documentElement.dataset.diffColorScheme = diffColorScheme;
294
- }, [diffColorScheme]);
295
-
296
- const chatWidth = useClientSettings((settings) => settings.chatWidth);
297
- const redesignEnabled = useClientSettings((settings) => settings.redesignEnabled);
298
- useEffect(() => {
299
- document.documentElement.toggleAttribute("data-redesign", redesignEnabled);
300
- }, [redesignEnabled]);
301
- useEffect(() => {
302
- document.documentElement.dataset.chatWidth = chatWidth;
303
- }, [chatWidth]);
304
-
305
- useEffect(() => {
306
- applyAppearanceContrast(document.documentElement, appearanceContrast);
307
- }, [appearanceContrast]);
308
-
309
- return null;
310
-}
311
-
312
-function GlassAppearanceSync() {
313
- const glassOpacity = useClientSettings((settings) => settings.glassOpacity);
314
-
315
- useEffect(() => {
316
- const style = document.documentElement.style;
317
- style.setProperty("--glass-opacity", `${glassOpacity}%`);
318
- if (glassOpacity === 100) {
319
- style.setProperty("--glass-blur", "0px");
320
- } else {
321
- style.removeProperty("--glass-blur");
322
- }
323
- }, [glassOpacity]);
324
-
325
- return null;
326
-}
327
-
328
-function FontAppearanceSync() {
329
- const fontFamilySans = useClientSettings((settings) => settings.fontFamilySans);
330
- const fontFamilyCode = useClientSettings((settings) => settings.fontFamilyCode);
331
- const fontFamilyComposer = useClientSettings((settings) => settings.fontFamilyComposer);
332
- const fontSizeInterface = useClientSettings((settings) => settings.fontSizeInterface);
333
- const fontSizePrompt = useClientSettings((settings) => settings.fontSizePrompt);
334
- const fontSizeCode = useClientSettings((settings) => settings.fontSizeCode);
335
- const fontSmoothing = useClientSettings((settings) => settings.fontSmoothing);
336
-
337
- useEffect(() => {
338
- applyAppearanceFontVariables(document.documentElement, {
339
- sans: fontFamilySans,
340
- code: fontFamilyCode,
341
- composer: fontFamilyComposer,
342
- sizeInterface: fontSizeInterface,
343
- sizePrompt: fontSizePrompt,
344
- sizeCode: fontSizeCode,
345
- smoothing: fontSmoothing,
346
- });
347
- }, [
348
- fontFamilyCode,
349
- fontFamilyComposer,
350
- fontFamilySans,
351
- fontSizeCode,
352
- fontSizeInterface,
353
- fontSizePrompt,
354
- fontSmoothing,
355
- ]);
356
-
357
- return null;
358
-}
359
-
274
// Each route paints its own surface for browser chrome to sample.
275
function BrowserChromeThemeSync() {
276
useEffect(() => {
@@ -370,23 +284,6 @@ function BrowserChromeThemeSync() {
284
return null;
285
}
286
373
-function DocumentTitleSync() {
374
- const primaryServerVersion =
375
- useAtomValue(primaryServerConfigAtom)?.environment.serverVersion ?? null;
376
- const title = resolveServerBackedAppDisplayName({
377
- baseName: APP_BASE_NAME,
378
- fallbackDisplayName: APP_DISPLAY_NAME,
379
- fallbackStageLabel: APP_STAGE_LABEL,
380
- primaryServerVersion,
381
- });
382
-
383
- useEffect(() => {
384
- document.title = title;
385
- }, [title]);
386
-
387
- return null;
388
-}
389
-
287
function HostedStaticEnvironmentBootstrap() {
288
const { environments } = useEnvironments();
289
const activeEnvironmentId = useActiveEnvironmentId();