@devries-cameron20 / t3code Mirror · read-only / commits / 4ee47883ef
Fork 0

The best way to control Claude Code, Codex and more from any computer or phone

Mirrored from https://github.com/Camo67/t3code.git

Synced Nov 22, 17:00 UTC

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();