Self-hosted, plugin-based server management.
TypeScript dockerhomelabpluginsrdpremote-desktopself-hostedserver-managementsftpsshterminaltermixvnc
/* eslint-disable react-refresh/only-export-components */
import {
createContext,
useCallback,
useContext,
useEffect,
useMemo,
useState,
type ReactNode,
} from "react";
import { getBranding, type BrandingSettings } from "@/api/settings-api";
import {
BRANDING_ICON_SELECTORS,
captureDefaultIconHrefs,
nextIconHref,
} from "./branding-document.ts";
const DEFAULT_APP_NAME = "Termix";
const DEFAULT_ICON_HREFS: Record<string, string> = {};
interface BrandingContextValue {
ready: boolean;
appName: string;
tagline: string;
logo: string | null;
/** Re-applies a freshly saved BrandingSettings without a page reload. */
applyBranding: (settings: BrandingSettings) => void;
}
const BrandingContext = createContext<BrandingContextValue>({
ready: false,
appName: DEFAULT_APP_NAME,
tagline: "",
logo: null,
applyBranding: () => {},
});
function applyDocumentBranding(settings: BrandingSettings): void {
document.title = settings.appName;
if (settings.logo) {
captureDefaultIconHrefs(DEFAULT_ICON_HREFS, (selector) =>
document.querySelector<HTMLLinkElement>(selector),
);
}
for (const selector of BRANDING_ICON_SELECTORS) {
const link = document.querySelector<HTMLLinkElement>(selector);
if (!link) continue;
link.href = nextIconHref(
settings.logo,
DEFAULT_ICON_HREFS[selector],
link.href,
);
}
}
export function BrandingProvider({ children }: { children: ReactNode }) {
const [ready, setReady] = useState(false);
const [branding, setBranding] = useState<BrandingSettings>({
appName: DEFAULT_APP_NAME,
tagline: "",
logo: null,
});
useEffect(() => {
let cancelled = false;
getBranding()
.then((settings) => {
if (cancelled) return;
setBranding(settings);
applyDocumentBranding(settings);
})
.catch(() => {})
.finally(() => {
if (!cancelled) setReady(true);
});
return () => {
cancelled = true;
};
}, []);
const applyBranding = useCallback((settings: BrandingSettings) => {
setBranding(settings);
applyDocumentBranding(settings);
}, []);
const value = useMemo(
() => ({
ready,
appName: branding.appName,
tagline: branding.tagline,
logo: branding.logo,
applyBranding,
}),
[ready, branding, applyBranding],
);
return (
<BrandingContext.Provider value={value}>
{children}
</BrandingContext.Provider>
);
}
export function useBranding(): BrandingContextValue {
return useContext(BrandingContext);
}