@rapidmx/web-client 0.15.1 → 0.17.0

package/apps/shared/components/admin/settings/BrandingForm.tsx

@@ -1,423 +1,423 @@
-///////////////////////////////////////////////////////////////////////////////
-// Copyright (C) 2026 Jean-Philippe Steinmetz
-// SPDX-License-Identifier: MPL-2.0
-///////////////////////////////////////////////////////////////////////////////
-import React, { ChangeEvent, FormEvent, useRef, useState } from "react";
-import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
-import {
-    Branding,
-    deleteBrandingIcon,
-    deleteBrandingLogo,
-    deleteBrandingStylesheet,
-    updateBranding,
-    uploadBrandingIcon,
-    uploadBrandingLogo,
-    uploadBrandingStylesheet,
-} from "@rapidmx/react-shared/branding/brandingApi.js";
-import Alert from "@rapidmx/react-shared/components/feedback/Alert.js";
-import Button from "@rapidmx/react-shared/components/buttons/Button.js";
-import CopyButton from "@rapidmx/react-shared/components/buttons/CopyButton.js";
-
-const INPUT_CLASS =
-    "w-full text-sm py-2 px-3 border border-border rounded-sm bg-surface text-text focus:outline-none focus:border-primary";
-
-const MAX_UPLOAD_BYTES = 5 * 1024 * 1024;
-
-/** A header that uses both variables - the snippet the Branding page offers to copy. */
-export const HEADER_HTML_EXAMPLE = `<div style="display:flex; align-items:center; justify-content:space-between; padding:0.5rem 1rem">
-    <span>{APP_TITLE}</span>
-    <span>{USER_MENU}</span>
-</div>`;
-
-/** SVG logo/icon uploads are refused (the server refuses them too): an SVG served from this origin can carry script. */
-export function isSvgFile(file: File): boolean {
-    return file.type === "image/svg+xml" || file.name.toLowerCase().endsWith(".svg");
-}
-
-const RASTER_IMAGE_ACCEPT = "image/png,image/jpeg,image/gif,image/webp,image/x-icon,image/vnd.microsoft.icon";
-
-export interface BrandingFormProps {
-    branding: Branding;
-    onChange: (b: Branding) => void;
-    /** Set when shown in a page that already introduces branding (the setup wizard): the title and introduction are
-     * left out, and the section headings sit one level lower. */
-    embedded?: boolean;
-}
-
-/** The branding editor, shared by the Branding page and the setup wizard. */
-export default function BrandingForm({ branding, onChange, embedded = false }: BrandingFormProps) {
-    const SectionHeading = embedded ? "h3" : "h2";
-    const [companyName, setCompanyName] = useState(branding.companyName);
-    const [title, setTitle] = useState(branding.title);
-    const [headerHtml, setHeaderHtml] = useState(branding.headerHtml ?? "");
-    const [footerHtml, setFooterHtml] = useState(branding.footerHtml ?? "");
-    const [logoUrlInput, setLogoUrlInput] = useState(branding.logoUrl ?? "");
-    const [iconUrlInput, setIconUrlInput] = useState(branding.iconUrl ?? "");
-    const [stylesheetUrlInput, setStylesheetUrlInput] = useState(branding.stylesheetUrl ?? "");
-
-    const [error, setError] = useState<string | null>(null);
-    const [saving, setSaving] = useState(false);
-    const [saved, setSaved] = useState(false);
-    const [assetBusy, setAssetBusy] = useState<string | null>(null);
-
-    const logoFileRef = useRef<HTMLInputElement>(null);
-    const iconFileRef = useRef<HTMLInputElement>(null);
-    const stylesheetFileRef = useRef<HTMLInputElement>(null);
-
-    function runAsset(name: string, action: () => Promise<Branding>) {
-        setError(null);
-        setAssetBusy(name);
-        return action()
-            .then((updated) => {
-                onChange(updated);
-                setLogoUrlInput(updated.logoUrl ?? "");
-                setIconUrlInput(updated.iconUrl ?? "");
-                setStylesheetUrlInput(updated.stylesheetUrl ?? "");
-            })
-            .catch((err) => setError(err instanceof ApiRequestError ? err.message : "Could not update branding."))
-            .finally(() => setAssetBusy(null));
-    }
-
-    function handleLogoFileChange(e: ChangeEvent<HTMLInputElement>) {
-        const file = e.target.files?.[0];
-        if (!file) return;
-        if (isSvgFile(file)) {
-            setError(`"${file.name}" is an SVG — upload a PNG, JPEG, GIF, or WebP logo instead.`);
-        } else if (file.size > MAX_UPLOAD_BYTES) {
-            setError(`"${file.name}" is too large — logos must be 5MB or smaller.`);
-        } else {
-            void runAsset("logo-upload", () => uploadBrandingLogo(file));
-        }
-        e.target.value = "";
-    }
-
-    function handleIconFileChange(e: ChangeEvent<HTMLInputElement>) {
-        const file = e.target.files?.[0];
-        if (!file) return;
-        if (isSvgFile(file)) {
-            setError(`"${file.name}" is an SVG — upload a PNG, JPEG, GIF, WebP, or ICO icon instead.`);
-        } else if (file.size > MAX_UPLOAD_BYTES) {
-            setError(`"${file.name}" is too large — icons must be 5MB or smaller.`);
-        } else {
-            void runAsset("icon-upload", () => uploadBrandingIcon(file));
-        }
-        e.target.value = "";
-    }
-
-    function handleStylesheetFileChange(e: ChangeEvent<HTMLInputElement>) {
-        const file = e.target.files?.[0];
-        if (!file) return;
-        if (file.size > MAX_UPLOAD_BYTES) {
-            setError(`"${file.name}" is too large — stylesheets must be 5MB or smaller.`);
-        } else {
-            void runAsset("stylesheet-upload", () => uploadBrandingStylesheet(file));
-        }
-        e.target.value = "";
-    }
-
-    async function handleSubmit(e: FormEvent) {
-        e.preventDefault();
-        setError(null);
-        setSaved(false);
-        setSaving(true);
-        try {
-            const updated = await updateBranding({ companyName, title, headerHtml, footerHtml });
-            onChange(updated);
-            setSaved(true);
-        } catch (err) {
-            setError(err instanceof ApiRequestError ? err.message : "Could not save branding.");
-        } finally {
-            setSaving(false);
-        }
-    }
-
-    return (
-        <div className="max-w-2xl">
-            {!embedded && (
-                <>
-                    <h1 className="text-xl font-bold uppercase tracking-wide mb-1">Branding</h1>
-                    <p className="text-sm text-text-muted mb-5">
-                        Customize the logo, nav-header icon, product name, and chrome shown to every visitor of the
-                        webmail and admin console — including anonymous booking-page visitors. The header appears on the
-                        webmail and public pages, not in the admin console; the footer appears in both.
-                    </p>
-                </>
-            )}
-
-            {error && <Alert>{error}</Alert>}
-            {saved && !error && <div className="mb-4 text-sm text-success font-medium">Saved.</div>}
-
-            <div className="flex flex-col gap-6">
-                <section className="flex flex-col gap-3">
-                    <SectionHeading className="text-sm font-bold uppercase tracking-wide text-text-muted">Logo</SectionHeading>
-                    <div className="flex items-center gap-4">
-                        <img
-                            src={branding.logoUrl || "/images/logo.svg"}
-                            alt="Current logo"
-                            width="64"
-                            height="64"
-                            className="border border-border rounded-sm bg-surface-alt p-1"
-                        />
-                        <div className="flex flex-col gap-2">
-                            <Button
-                                type="button"
-                                variant="secondary"
-                                className="!w-auto"
-                                loading={assetBusy === "logo-upload"}
-                                disabled={assetBusy !== null}
-                                onClick={() => logoFileRef.current?.click()}
-                            >
-                                Upload logo
-                            </Button>
-                            <input
-                                ref={logoFileRef}
-                                type="file"
-                                accept={RASTER_IMAGE_ACCEPT}
-                                aria-label="Upload logo"
-                                className="hidden"
-                                onChange={handleLogoFileChange}
-                            />
-                            {branding.logoUrl && (
-                                <Button
-                                    type="button"
-                                    variant="text"
-                                    disabled={assetBusy !== null}
-                                    loading={assetBusy === "logo-delete"}
-                                    onClick={() => void runAsset("logo-delete", async () => {
-                                        await deleteBrandingLogo();
-                                        return { ...branding, logoUrl: undefined };
-                                    })}
-                                >
-                                    Remove logo
-                                </Button>
-                            )}
-                        </div>
-                    </div>
-                    <label className="flex flex-col gap-1.5 text-sm">
-                        <span className="font-semibold">Or use an external image URL</span>
-                        <div className="flex gap-2">
-                            <input
-                                aria-label="Logo URL"
-                                className={INPUT_CLASS}
-                                value={logoUrlInput}
-                                onChange={(e) => setLogoUrlInput(e.target.value)}
-                            />
-                            <Button
-                                type="button"
-                                variant="secondary"
-                                className="!w-auto"
-                                disabled={assetBusy !== null || logoUrlInput === (branding.logoUrl ?? "")}
-                                loading={assetBusy === "logo-url"}
-                                onClick={() => void runAsset("logo-url", () => updateBranding({ logoUrl: logoUrlInput }))}
-                            >
-                                Set
-                            </Button>
-                        </div>
-                    </label>
-                </section>
-
-                <section className="flex flex-col gap-3">
-                    <SectionHeading className="text-sm font-bold uppercase tracking-wide text-text-muted">Icon</SectionHeading>
-                    <p className="text-xs text-text-muted -mt-1">
-                        A compact mark for navigation headers, independent of the full logo above. Falls back to
-                        the logo, then a default asset, when not set.
-                    </p>
-                    <div className="flex items-center gap-4">
-                        <img
-                            src={branding.iconUrl || branding.logoUrl || "/images/logo.svg"}
-                            alt="Current icon"
-                            width="64"
-                            height="64"
-                            className="border border-border rounded-sm bg-surface-alt p-1"
-                        />
-                        <div className="flex flex-col gap-2">
-                            <Button
-                                type="button"
-                                variant="secondary"
-                                className="!w-auto"
-                                loading={assetBusy === "icon-upload"}
-                                disabled={assetBusy !== null}
-                                onClick={() => iconFileRef.current?.click()}
-                            >
-                                Upload icon
-                            </Button>
-                            <input
-                                ref={iconFileRef}
-                                type="file"
-                                accept={RASTER_IMAGE_ACCEPT}
-                                aria-label="Upload icon"
-                                className="hidden"
-                                onChange={handleIconFileChange}
-                            />
-                            {branding.iconUrl && (
-                                <Button
-                                    type="button"
-                                    variant="text"
-                                    disabled={assetBusy !== null}
-                                    loading={assetBusy === "icon-delete"}
-                                    onClick={() => void runAsset("icon-delete", async () => {
-                                        await deleteBrandingIcon();
-                                        return { ...branding, iconUrl: undefined };
-                                    })}
-                                >
-                                    Remove icon
-                                </Button>
-                            )}
-                        </div>
-                    </div>
-                    <label className="flex flex-col gap-1.5 text-sm">
-                        <span className="font-semibold">Or use an external image URL</span>
-                        <div className="flex gap-2">
-                            <input
-                                aria-label="Icon URL"
-                                className={INPUT_CLASS}
-                                value={iconUrlInput}
-                                onChange={(e) => setIconUrlInput(e.target.value)}
-                            />
-                            <Button
-                                type="button"
-                                variant="secondary"
-                                className="!w-auto"
-                                disabled={assetBusy !== null || iconUrlInput === (branding.iconUrl ?? "")}
-                                loading={assetBusy === "icon-url"}
-                                onClick={() => void runAsset("icon-url", () => updateBranding({ iconUrl: iconUrlInput }))}
-                            >
-                                Set
-                            </Button>
-                        </div>
-                    </label>
-                </section>
-
-                <section className="flex flex-col gap-3">
-                    <SectionHeading className="text-sm font-bold uppercase tracking-wide text-text-muted">Custom stylesheet</SectionHeading>
-                    <div className="flex items-center gap-3">
-                        <span className="text-sm text-text-muted truncate">
-                            {branding.stylesheetUrl || "None configured"}
-                        </span>
-                    </div>
-                    <div className="flex gap-2">
-                        <Button
-                            type="button"
-                            variant="secondary"
-                            className="!w-auto"
-                            loading={assetBusy === "stylesheet-upload"}
-                            disabled={assetBusy !== null}
-                            onClick={() => stylesheetFileRef.current?.click()}
-                        >
-                            Upload CSS file
-                        </Button>
-                        <input
-                            ref={stylesheetFileRef}
-                            type="file"
-                            accept="text/css,.css"
-                            aria-label="Upload stylesheet"
-                            className="hidden"
-                            onChange={handleStylesheetFileChange}
-                        />
-                        {branding.stylesheetUrl && (
-                            <Button
-                                type="button"
-                                variant="text"
-                                disabled={assetBusy !== null}
-                                loading={assetBusy === "stylesheet-delete"}
-                                onClick={() => void runAsset("stylesheet-delete", async () => {
-                                    await deleteBrandingStylesheet();
-                                    return { ...branding, stylesheetUrl: undefined };
-                                })}
-                            >
-                                Remove stylesheet
-                            </Button>
-                        )}
-                    </div>
-                    <label className="flex flex-col gap-1.5 text-sm">
-                        <span className="font-semibold">Or use an external stylesheet URL</span>
-                        <div className="flex gap-2">
-                            <input
-                                aria-label="Stylesheet URL"
-                                className={INPUT_CLASS}
-                                value={stylesheetUrlInput}
-                                onChange={(e) => setStylesheetUrlInput(e.target.value)}
-                            />
-                            <Button
-                                type="button"
-                                variant="secondary"
-                                className="!w-auto"
-                                disabled={assetBusy !== null || stylesheetUrlInput === (branding.stylesheetUrl ?? "")}
-                                loading={assetBusy === "stylesheet-url"}
-                                onClick={() =>
-                                    void runAsset("stylesheet-url", () => updateBranding({ stylesheetUrl: stylesheetUrlInput }))
-                                }
-                            >
-                                Set
-                            </Button>
-                        </div>
-                    </label>
-                </section>
-
-                <form onSubmit={handleSubmit} className="flex flex-col gap-4 pt-2 border-t border-border">
-                    <label className="flex flex-col gap-1.5 text-sm">
-                        <span className="font-semibold">Company name</span>
-                        <input
-                            aria-label="Company name"
-                            className={INPUT_CLASS}
-                            value={companyName}
-                            onChange={(e) => setCompanyName(e.target.value)}
-                        />
-                    </label>
-                    <label className="flex flex-col gap-1.5 text-sm">
-                        <span className="font-semibold">Product title</span>
-                        <input
-                            aria-label="Product title"
-                            className={INPUT_CLASS}
-                            value={title}
-                            onChange={(e) => setTitle(e.target.value)}
-                        />
-                        <span className="text-xs text-text-muted">Shown as the browser tab title.</span>
-                    </label>
-                    <label className="flex flex-col gap-1.5 text-sm">
-                        <span className="font-semibold">Header HTML (optional)</span>
-                        <textarea
-                            aria-label="Header HTML"
-                            className={`${INPUT_CLASS} font-mono`}
-                            rows={3}
-                            value={headerHtml}
-                            onChange={(e) => setHeaderHtml(e.target.value)}
-                        />
-                        <span className="text-xs text-text-muted">
-                            A header replaces the app's own title bar and the icon at the top of the icon rail, and stays at the top of the window. Write{" "}
-                            <code>{"{USER_MENU}"}</code> where the account menu (avatar, Settings, Sign Out) should go, and <code>{"{APP_TITLE}"}</code>{" "}
-                            where the name of the app on screen should show. Both work in the footer too. <code>{"{USER_MENU}"}</code> is replaced once
-                            (the header's, else the footer's); without it the menu sits in a small cell at the right end of the header, so it is never lost.
-                            Put it where your styles don't hide it on a phone.
-                        </span>
-                    </label>
-                    <div className="flex flex-col gap-1.5 text-sm" role="group" aria-label="Header example">
-                        <div className="flex items-center justify-between gap-2">
-                            <span className="font-semibold">Example header</span>
-                            <CopyButton value={HEADER_HTML_EXAMPLE} label="Copy the example header HTML" />
-                        </div>
-                        <pre className="overflow-x-auto rounded-sm border border-border bg-surface-alt p-3 font-mono text-xs text-text">{HEADER_HTML_EXAMPLE}</pre>
-                    </div>
-                    <label className="flex flex-col gap-1.5 text-sm">
-                        <span className="font-semibold">Footer HTML (optional)</span>
-                        <textarea
-                            aria-label="Footer HTML"
-                            className={`${INPUT_CLASS} font-mono`}
-                            rows={3}
-                            value={footerHtml}
-                            onChange={(e) => setFooterHtml(e.target.value)}
-                        />
-                        <span className="text-xs text-text-muted">
-                            <code>{"{APP_TITLE}"}</code> works here as well, and <code>{"{USER_MENU}"}</code> takes the account menu (opening upward) when the header has none.
-                        </span>
-                    </label>
-                    <div>
-                        <Button type="submit" loading={saving} disabled={saving} className="!w-auto">
-                            Save
-                        </Button>
-                    </div>
-                </form>
-            </div>
-        </div>
-    );
-}
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2026 Jean-Philippe Steinmetz
+// SPDX-License-Identifier: MPL-2.0
+///////////////////////////////////////////////////////////////////////////////
+import React, { ChangeEvent, FormEvent, useRef, useState } from "react";
+import { ApiRequestError } from "@rapidmx/react-shared/util/api.js";
+import {
+    Branding,
+    deleteBrandingIcon,
+    deleteBrandingLogo,
+    deleteBrandingStylesheet,
+    updateBranding,
+    uploadBrandingIcon,
+    uploadBrandingLogo,
+    uploadBrandingStylesheet,
+} from "@rapidmx/react-shared/branding/brandingApi.js";
+import Alert from "@rapidmx/react-shared/components/feedback/Alert.js";
+import Button from "@rapidmx/react-shared/components/buttons/Button.js";
+import CopyButton from "@rapidmx/react-shared/components/buttons/CopyButton.js";
+
+const INPUT_CLASS =
+    "w-full text-sm py-2 px-3 border border-border rounded-sm bg-surface text-text focus:outline-none focus:border-primary";
+
+const MAX_UPLOAD_BYTES = 5 * 1024 * 1024;
+
+/** A header that uses both variables - the snippet the Branding page offers to copy. */
+export const HEADER_HTML_EXAMPLE = `<div style="display:flex; align-items:center; justify-content:space-between; padding:0.5rem 1rem">
+    <span>{APP_TITLE}</span>
+    <span>{USER_MENU}</span>
+</div>`;
+
+/** SVG logo/icon uploads are refused (the server refuses them too): an SVG served from this origin can carry script. */
+export function isSvgFile(file: File): boolean {
+    return file.type === "image/svg+xml" || file.name.toLowerCase().endsWith(".svg");
+}
+
+const RASTER_IMAGE_ACCEPT = "image/png,image/jpeg,image/gif,image/webp,image/x-icon,image/vnd.microsoft.icon";
+
+export interface BrandingFormProps {
+    branding: Branding;
+    onChange: (b: Branding) => void;
+    /** Set when shown in a page that already introduces branding (the setup wizard): the title and introduction are
+     * left out, and the section headings sit one level lower. */
+    embedded?: boolean;
+}
+
+/** The branding editor, shared by the Branding page and the setup wizard. */
+export default function BrandingForm({ branding, onChange, embedded = false }: BrandingFormProps) {
+    const SectionHeading = embedded ? "h3" : "h2";
+    const [companyName, setCompanyName] = useState(branding.companyName);
+    const [title, setTitle] = useState(branding.title);
+    const [headerHtml, setHeaderHtml] = useState(branding.headerHtml ?? "");
+    const [footerHtml, setFooterHtml] = useState(branding.footerHtml ?? "");
+    const [logoUrlInput, setLogoUrlInput] = useState(branding.logoUrl ?? "");
+    const [iconUrlInput, setIconUrlInput] = useState(branding.iconUrl ?? "");
+    const [stylesheetUrlInput, setStylesheetUrlInput] = useState(branding.stylesheetUrl ?? "");
+
+    const [error, setError] = useState<string | null>(null);
+    const [saving, setSaving] = useState(false);
+    const [saved, setSaved] = useState(false);
+    const [assetBusy, setAssetBusy] = useState<string | null>(null);
+
+    const logoFileRef = useRef<HTMLInputElement>(null);
+    const iconFileRef = useRef<HTMLInputElement>(null);
+    const stylesheetFileRef = useRef<HTMLInputElement>(null);
+
+    function runAsset(name: string, action: () => Promise<Branding>) {
+        setError(null);
+        setAssetBusy(name);
+        return action()
+            .then((updated) => {
+                onChange(updated);
+                setLogoUrlInput(updated.logoUrl ?? "");
+                setIconUrlInput(updated.iconUrl ?? "");
+                setStylesheetUrlInput(updated.stylesheetUrl ?? "");
+            })
+            .catch((err) => setError(err instanceof ApiRequestError ? err.message : "Could not update branding."))
+            .finally(() => setAssetBusy(null));
+    }
+
+    function handleLogoFileChange(e: ChangeEvent<HTMLInputElement>) {
+        const file = e.target.files?.[0];
+        if (!file) return;
+        if (isSvgFile(file)) {
+            setError(`"${file.name}" is an SVG — upload a PNG, JPEG, GIF, or WebP logo instead.`);
+        } else if (file.size > MAX_UPLOAD_BYTES) {
+            setError(`"${file.name}" is too large — logos must be 5MB or smaller.`);
+        } else {
+            void runAsset("logo-upload", () => uploadBrandingLogo(file));
+        }
+        e.target.value = "";
+    }
+
+    function handleIconFileChange(e: ChangeEvent<HTMLInputElement>) {
+        const file = e.target.files?.[0];
+        if (!file) return;
+        if (isSvgFile(file)) {
+            setError(`"${file.name}" is an SVG — upload a PNG, JPEG, GIF, WebP, or ICO icon instead.`);
+        } else if (file.size > MAX_UPLOAD_BYTES) {
+            setError(`"${file.name}" is too large — icons must be 5MB or smaller.`);
+        } else {
+            void runAsset("icon-upload", () => uploadBrandingIcon(file));
+        }
+        e.target.value = "";
+    }
+
+    function handleStylesheetFileChange(e: ChangeEvent<HTMLInputElement>) {
+        const file = e.target.files?.[0];
+        if (!file) return;
+        if (file.size > MAX_UPLOAD_BYTES) {
+            setError(`"${file.name}" is too large — stylesheets must be 5MB or smaller.`);
+        } else {
+            void runAsset("stylesheet-upload", () => uploadBrandingStylesheet(file));
+        }
+        e.target.value = "";
+    }
+
+    async function handleSubmit(e: FormEvent) {
+        e.preventDefault();
+        setError(null);
+        setSaved(false);
+        setSaving(true);
+        try {
+            const updated = await updateBranding({ companyName, title, headerHtml, footerHtml });
+            onChange(updated);
+            setSaved(true);
+        } catch (err) {
+            setError(err instanceof ApiRequestError ? err.message : "Could not save branding.");
+        } finally {
+            setSaving(false);
+        }
+    }
+
+    return (
+        <div className="max-w-2xl">
+            {!embedded && (
+                <>
+                    <h1 className="text-xl font-bold uppercase tracking-wide mb-1">Branding</h1>
+                    <p className="text-sm text-text-muted mb-5">
+                        Customize the logo, nav-header icon, product name, and chrome shown to every visitor of the
+                        webmail and admin console — including anonymous booking-page visitors. The header appears on the
+                        webmail and public pages, not in the admin console; the footer appears in both.
+                    </p>
+                </>
+            )}
+
+            {error && <Alert>{error}</Alert>}
+            {saved && !error && <div className="mb-4 text-sm text-success font-medium">Saved.</div>}
+
+            <div className="flex flex-col gap-6">
+                <section className="flex flex-col gap-3">
+                    <SectionHeading className="text-sm font-bold uppercase tracking-wide text-text-muted">Logo</SectionHeading>
+                    <div className="flex items-center gap-4">
+                        <img
+                            src={branding.logoUrl || "/images/logo.svg"}
+                            alt="Current logo"
+                            width="64"
+                            height="64"
+                            className="border border-border rounded-sm bg-surface-alt p-1"
+                        />
+                        <div className="flex flex-col gap-2">
+                            <Button
+                                type="button"
+                                variant="secondary"
+                                className="!w-auto"
+                                loading={assetBusy === "logo-upload"}
+                                disabled={assetBusy !== null}
+                                onClick={() => logoFileRef.current?.click()}
+                            >
+                                Upload logo
+                            </Button>
+                            <input
+                                ref={logoFileRef}
+                                type="file"
+                                accept={RASTER_IMAGE_ACCEPT}
+                                aria-label="Upload logo"
+                                className="hidden"
+                                onChange={handleLogoFileChange}
+                            />
+                            {branding.logoUrl && (
+                                <Button
+                                    type="button"
+                                    variant="text"
+                                    disabled={assetBusy !== null}
+                                    loading={assetBusy === "logo-delete"}
+                                    onClick={() => void runAsset("logo-delete", async () => {
+                                        await deleteBrandingLogo();
+                                        return { ...branding, logoUrl: undefined };
+                                    })}
+                                >
+                                    Remove logo
+                                </Button>
+                            )}
+                        </div>
+                    </div>
+                    <label className="flex flex-col gap-1.5 text-sm">
+                        <span className="font-semibold">Or use an external image URL</span>
+                        <div className="flex gap-2">
+                            <input
+                                aria-label="Logo URL"
+                                className={INPUT_CLASS}
+                                value={logoUrlInput}
+                                onChange={(e) => setLogoUrlInput(e.target.value)}
+                            />
+                            <Button
+                                type="button"
+                                variant="secondary"
+                                className="!w-auto"
+                                disabled={assetBusy !== null || logoUrlInput === (branding.logoUrl ?? "")}
+                                loading={assetBusy === "logo-url"}
+                                onClick={() => void runAsset("logo-url", () => updateBranding({ logoUrl: logoUrlInput }))}
+                            >
+                                Set
+                            </Button>
+                        </div>
+                    </label>
+                </section>
+
+                <section className="flex flex-col gap-3">
+                    <SectionHeading className="text-sm font-bold uppercase tracking-wide text-text-muted">Icon</SectionHeading>
+                    <p className="text-xs text-text-muted -mt-1">
+                        A compact mark for navigation headers, independent of the full logo above. Falls back to
+                        the logo, then a default asset, when not set.
+                    </p>
+                    <div className="flex items-center gap-4">
+                        <img
+                            src={branding.iconUrl || branding.logoUrl || "/images/logo.svg"}
+                            alt="Current icon"
+                            width="64"
+                            height="64"
+                            className="border border-border rounded-sm bg-surface-alt p-1"
+                        />
+                        <div className="flex flex-col gap-2">
+                            <Button
+                                type="button"
+                                variant="secondary"
+                                className="!w-auto"
+                                loading={assetBusy === "icon-upload"}
+                                disabled={assetBusy !== null}
+                                onClick={() => iconFileRef.current?.click()}
+                            >
+                                Upload icon
+                            </Button>
+                            <input
+                                ref={iconFileRef}
+                                type="file"
+                                accept={RASTER_IMAGE_ACCEPT}
+                                aria-label="Upload icon"
+                                className="hidden"
+                                onChange={handleIconFileChange}
+                            />
+                            {branding.iconUrl && (
+                                <Button
+                                    type="button"
+                                    variant="text"
+                                    disabled={assetBusy !== null}
+                                    loading={assetBusy === "icon-delete"}
+                                    onClick={() => void runAsset("icon-delete", async () => {
+                                        await deleteBrandingIcon();
+                                        return { ...branding, iconUrl: undefined };
+                                    })}
+                                >
+                                    Remove icon
+                                </Button>
+                            )}
+                        </div>
+                    </div>
+                    <label className="flex flex-col gap-1.5 text-sm">
+                        <span className="font-semibold">Or use an external image URL</span>
+                        <div className="flex gap-2">
+                            <input
+                                aria-label="Icon URL"
+                                className={INPUT_CLASS}
+                                value={iconUrlInput}
+                                onChange={(e) => setIconUrlInput(e.target.value)}
+                            />
+                            <Button
+                                type="button"
+                                variant="secondary"
+                                className="!w-auto"
+                                disabled={assetBusy !== null || iconUrlInput === (branding.iconUrl ?? "")}
+                                loading={assetBusy === "icon-url"}
+                                onClick={() => void runAsset("icon-url", () => updateBranding({ iconUrl: iconUrlInput }))}
+                            >
+                                Set
+                            </Button>
+                        </div>
+                    </label>
+                </section>
+
+                <section className="flex flex-col gap-3">
+                    <SectionHeading className="text-sm font-bold uppercase tracking-wide text-text-muted">Custom stylesheet</SectionHeading>
+                    <div className="flex items-center gap-3">
+                        <span className="text-sm text-text-muted truncate">
+                            {branding.stylesheetUrl || "None configured"}
+                        </span>
+                    </div>
+                    <div className="flex gap-2">
+                        <Button
+                            type="button"
+                            variant="secondary"
+                            className="!w-auto"
+                            loading={assetBusy === "stylesheet-upload"}
+                            disabled={assetBusy !== null}
+                            onClick={() => stylesheetFileRef.current?.click()}
+                        >
+                            Upload CSS file
+                        </Button>
+                        <input
+                            ref={stylesheetFileRef}
+                            type="file"
+                            accept="text/css,.css"
+                            aria-label="Upload stylesheet"
+                            className="hidden"
+                            onChange={handleStylesheetFileChange}
+                        />
+                        {branding.stylesheetUrl && (
+                            <Button
+                                type="button"
+                                variant="text"
+                                disabled={assetBusy !== null}
+                                loading={assetBusy === "stylesheet-delete"}
+                                onClick={() => void runAsset("stylesheet-delete", async () => {
+                                    await deleteBrandingStylesheet();
+                                    return { ...branding, stylesheetUrl: undefined };
+                                })}
+                            >
+                                Remove stylesheet
+                            </Button>
+                        )}
+                    </div>
+                    <label className="flex flex-col gap-1.5 text-sm">
+                        <span className="font-semibold">Or use an external stylesheet URL</span>
+                        <div className="flex gap-2">
+                            <input
+                                aria-label="Stylesheet URL"
+                                className={INPUT_CLASS}
+                                value={stylesheetUrlInput}
+                                onChange={(e) => setStylesheetUrlInput(e.target.value)}
+                            />
+                            <Button
+                                type="button"
+                                variant="secondary"
+                                className="!w-auto"
+                                disabled={assetBusy !== null || stylesheetUrlInput === (branding.stylesheetUrl ?? "")}
+                                loading={assetBusy === "stylesheet-url"}
+                                onClick={() =>
+                                    void runAsset("stylesheet-url", () => updateBranding({ stylesheetUrl: stylesheetUrlInput }))
+                                }
+                            >
+                                Set
+                            </Button>
+                        </div>
+                    </label>
+                </section>
+
+                <form onSubmit={handleSubmit} className="flex flex-col gap-4 pt-2 border-t border-border">
+                    <label className="flex flex-col gap-1.5 text-sm">
+                        <span className="font-semibold">Company name</span>
+                        <input
+                            aria-label="Company name"
+                            className={INPUT_CLASS}
+                            value={companyName}
+                            onChange={(e) => setCompanyName(e.target.value)}
+                        />
+                    </label>
+                    <label className="flex flex-col gap-1.5 text-sm">
+                        <span className="font-semibold">Product title</span>
+                        <input
+                            aria-label="Product title"
+                            className={INPUT_CLASS}
+                            value={title}
+                            onChange={(e) => setTitle(e.target.value)}
+                        />
+                        <span className="text-xs text-text-muted">Shown as the browser tab title.</span>
+                    </label>
+                    <label className="flex flex-col gap-1.5 text-sm">
+                        <span className="font-semibold">Header HTML (optional)</span>
+                        <textarea
+                            aria-label="Header HTML"
+                            className={`${INPUT_CLASS} font-mono`}
+                            rows={3}
+                            value={headerHtml}
+                            onChange={(e) => setHeaderHtml(e.target.value)}
+                        />
+                        <span className="text-xs text-text-muted">
+                            A header replaces the app's own title bar and the icon at the top of the icon rail, and stays at the top of the window. Write{" "}
+                            <code>{"{USER_MENU}"}</code> where the account menu (avatar, Settings, Sign Out) should go, and <code>{"{APP_TITLE}"}</code>{" "}
+                            where the name of the app on screen should show. Both work in the footer too. <code>{"{USER_MENU}"}</code> is replaced once
+                            (the header's, else the footer's); without it the menu sits in a small cell at the right end of the header, so it is never lost.
+                            Put it where your styles don't hide it on a phone.
+                        </span>
+                    </label>
+                    <div className="flex flex-col gap-1.5 text-sm" role="group" aria-label="Header example">
+                        <div className="flex items-center justify-between gap-2">
+                            <span className="font-semibold">Example header</span>
+                            <CopyButton value={HEADER_HTML_EXAMPLE} label="Copy the example header HTML" />
+                        </div>
+                        <pre className="overflow-x-auto rounded-sm border border-border bg-surface-alt p-3 font-mono text-xs text-text">{HEADER_HTML_EXAMPLE}</pre>
+                    </div>
+                    <label className="flex flex-col gap-1.5 text-sm">
+                        <span className="font-semibold">Footer HTML (optional)</span>
+                        <textarea
+                            aria-label="Footer HTML"
+                            className={`${INPUT_CLASS} font-mono`}
+                            rows={3}
+                            value={footerHtml}
+                            onChange={(e) => setFooterHtml(e.target.value)}
+                        />
+                        <span className="text-xs text-text-muted">
+                            <code>{"{APP_TITLE}"}</code> works here as well, and <code>{"{USER_MENU}"}</code> takes the account menu (opening upward) when the header has none.
+                        </span>
+                    </label>
+                    <div>
+                        <Button type="submit" loading={saving} disabled={saving} className="!w-auto">
+                            Save
+                        </Button>
+                    </div>
+                </form>
+            </div>
+        </div>
+    );
+}