Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
import { Component, Show, Accessor, Setter } from 'solid-js';
import SettingsPanel from '@/components/shared/SettingsPanel';
import { Button } from '@/components/shared/Button';
import { ExternalTextLink } from '@/components/shared/ExternalTextLink';
import { Toggle } from '@/components/shared/Toggle';
import { EnvironmentLockBadge } from '@/components/shared/EnvironmentLockBadge';
import { FilterButtonGroup, type FilterOption } from '@/components/shared/FilterButtonGroup';
import type { TelemetryPreviewResponse } from '@/api/settings';
import { DockerRuntimeSettingsCard } from './DockerRuntimeSettingsCard';
import { GuestDockerDiscoverySettingsCard } from './GuestDockerDiscoverySettingsCard';
import { BrandingSettingsCard } from './BrandingSettingsCard';
import type { ReportBrandSettings } from '@/types/config';
import Sun from 'lucide-solid/icons/sun';
import Moon from 'lucide-solid/icons/moon';
import Languages from 'lucide-solid/icons/languages';
import Thermometer from 'lucide-solid/icons/thermometer';
import Maximize2 from 'lucide-solid/icons/maximize-2';
import {
activeLocale,
setLocalePreference,
SUPPORTED_LOCALE_LABELS,
SUPPORTED_LOCALES,
t,
type SupportedLocale,
} from '@/i18n';
import { temperatureStore } from '@/utils/temperature';
import { layoutStore } from '@/utils/layout';
import {
PVE_POLLING_MAX_SECONDS,
PVE_POLLING_MIN_SECONDS,
getPvePollingCadenceSummary,
getPvePollingCustomOption,
getPvePollingPresetOptions,
} from '@/utils/systemSettingsPresentation';
import { PRIVACY_DOC_URL } from '@/utils/docsLinks';
import Laptop from 'lucide-solid/icons/laptop';
const getThemePreferenceOptions = (): FilterOption<'light' | 'dark' | 'system'>[] => [
{ value: 'light', label: t('settings.general.theme.option.light'), icon: Sun },
{ value: 'dark', label: t('settings.general.theme.option.dark'), icon: Moon },
{ value: 'system', label: t('settings.general.theme.option.system'), icon: Laptop },
];
const getLocalePreferenceOptions = (): FilterOption<SupportedLocale>[] =>
SUPPORTED_LOCALES.map((locale) => ({
value: locale,
label: SUPPORTED_LOCALE_LABELS[locale],
}));
const TEMPERATURE_UNIT_OPTIONS: FilterOption<'celsius' | 'fahrenheit'>[] = [
{ value: 'celsius', label: 'Celsius' },
{ value: 'fahrenheit', label: 'Fahrenheit' },
];
const TELEMETRY_ENV_VAR = 'PULSE_TELEMETRY';
const PVE_POLLING_INTERVAL_ENV_VAR = 'PVE_POLLING_INTERVAL';
const getPvePollingOptions = (): FilterOption<number | 'custom'>[] => [
...getPvePollingPresetOptions(),
getPvePollingCustomOption(),
];
export interface GeneralSettingsPanelProps {
darkMode: Accessor<boolean>;
themePreference: Accessor<'light' | 'dark' | 'system'>;
setThemePreference: (pref: 'light' | 'dark' | 'system') => void;
pvePollingInterval: Accessor<number>;
setPVEPollingInterval: Setter<number>;
pvePollingSelection: Accessor<number | 'custom'>;
setPVEPollingSelection: Setter<number | 'custom'>;
pvePollingCustomSeconds: Accessor<number>;
setPVEPollingCustomSeconds: Setter<number>;
pvePollingEnvLocked: () => boolean;
setHasUnsavedChanges: Setter<boolean>;
reportBrandDisplayName: Accessor<string>;
setReportBrandDisplayName: Setter<string>;
reportBrandLogoBase64: Accessor<string>;
setReportBrandLogoBase64: Setter<string>;
reportBrandLogoFormat: Accessor<NonNullable<ReportBrandSettings['logoFormat']>>;
setReportBrandLogoFormat: Setter<NonNullable<ReportBrandSettings['logoFormat']>>;
telemetryEnabled: Accessor<boolean>;
telemetryEnabledLocked: () => boolean;
savingTelemetry: Accessor<boolean>;
handleTelemetryEnabledChange: (enabled: boolean) => Promise<void>;
telemetryPreview: Accessor<TelemetryPreviewResponse | null>;
telemetryPreviewEnabled: Accessor<boolean>;
telemetryPreviewPayload: Accessor<string>;
loadingTelemetryPreview: Accessor<boolean>;
resettingTelemetryInstallID: Accessor<boolean>;
handleLoadTelemetryPreview: () => Promise<void>;
handleCopyTelemetryPreview: () => Promise<void>;
handleResetTelemetryInstallID: () => Promise<void>;
disableDockerUpdateActions: Accessor<boolean>;
disableDockerUpdateActionsLocked: () => boolean;
savingDockerUpdateActions: Accessor<boolean>;
handleDisableDockerUpdateActionsChange: (disabled: boolean) => Promise<void>;
enableProxmoxGuestDockerInventory: Accessor<boolean>;
guestDockerInventoryLocked: () => boolean;
savingGuestDockerInventory: Accessor<boolean>;
handleGuestDockerInventoryChange: (enabled: boolean) => Promise<void>;
}
export const GeneralSettingsPanel: Component<GeneralSettingsPanelProps> = (props) => {
const handlePVEPollingSelection = (value: number | 'custom') => {
if (props.pvePollingEnvLocked()) return;
props.setPVEPollingSelection(value);
props.setPVEPollingInterval(value === 'custom' ? props.pvePollingCustomSeconds() : value);
props.setHasUnsavedChanges(true);
};
return (
<div class="space-y-3 sm:space-y-6">
{/* Appearance Card */}
<SettingsPanel
title={t('settings.general.appearance.title')}
noPadding
bodyClass="divide-y divide-border"
>
<div class="flex items-center justify-between gap-2 p-2 sm:gap-4 sm:p-6">
<div class="flex min-w-0 items-center gap-3">
{/* Animated theme icon */}
<div
class={`relative hidden shrink-0 rounded-md border border-border bg-surface p-2.5 transition-all duration-300 sm:block`}
>
<div class="relative w-5 h-5">
<Sun
class={`absolute inset-0 w-5 h-5 text-slate-500 transition-all duration-300 ${props.darkMode() ? 'opacity-0 rotate-90 scale-50' : 'opacity-100 rotate-0 scale-100'}`}
strokeWidth={2}
/>
<Moon
class={`absolute inset-0 w-5 h-5 text-slate-500 transition-all duration-300 ${props.darkMode() ? 'opacity-100 rotate-0 scale-100' : 'opacity-0 -rotate-90 scale-50'}`}
strokeWidth={2}
/>
</div>
</div>
<div class="min-w-0 text-sm text-muted">
<p class="text-[10px] font-medium leading-tight text-base-content sm:truncate sm:text-sm">
{t('settings.general.theme.title')}
</p>
<p class="hidden text-xs text-muted sm:line-clamp-2">
{t('settings.general.theme.description')}
</p>
</div>
</div>
<FilterButtonGroup
class="max-w-[72%] shrink-0 [&_button]:px-1.5 [&_svg]:hidden sm:w-auto sm:max-w-full sm:[&_button]:px-3 sm:[&_svg]:block"
options={getThemePreferenceOptions()}
value={props.themePreference()}
onChange={props.setThemePreference}
variant="settings"
/>
</div>
{/* Language Selector: stacks on phones so every locale option fits on one line */}
<div class="flex flex-col items-start gap-2 p-2 sm:flex-row sm:items-center sm:justify-between sm:gap-4 sm:p-6">
<div class="flex min-w-0 items-center gap-3">
<div class="hidden shrink-0 rounded-md border border-border bg-surface p-2.5 sm:block">
<Languages class="w-5 h-5 text-slate-500" strokeWidth={2} />
</div>
<div class="min-w-0 text-sm text-muted">
<p class="truncate text-xs font-medium text-base-content sm:text-sm">
{t('settings.general.language.title')}
</p>
<p class="hidden text-xs text-muted sm:line-clamp-2">
{t('settings.general.language.description')}
</p>
</div>
</div>
<FilterButtonGroup
class="max-w-full shrink-0 [&_button]:px-1.5 sm:w-auto sm:[&_button]:px-3"
options={getLocalePreferenceOptions()}
value={activeLocale()}
onChange={setLocalePreference}
variant="settings"
ariaLabel={t('settings.general.language.ariaLabel')}
/>
</div>
{/* Temperature Unit Selector */}
<div class="flex items-center justify-between gap-2 p-2 sm:gap-4 sm:p-6">
<div class="flex min-w-0 items-center gap-3">
<div class="hidden shrink-0 rounded-md border border-border bg-surface p-2.5 sm:block">
<Thermometer class="w-5 h-5" strokeWidth={2} />
</div>
<div class="min-w-0 text-sm text-muted">
<p class="text-[10px] font-medium leading-tight text-base-content sm:truncate sm:text-sm">
{t('settings.general.temperature.title')}
</p>
<p class="hidden text-xs text-muted sm:line-clamp-2">
{t('settings.general.temperature.description')}
</p>
</div>
</div>
<FilterButtonGroup
class="max-w-[72%] shrink-0 [&_button]:px-1.5 sm:w-auto sm:max-w-full sm:[&_button]:px-3"
options={TEMPERATURE_UNIT_OPTIONS}
value={temperatureStore.unit()}
onChange={(value) => temperatureStore.setUnit(value)}
variant="settings"
/>
</div>
{/* Full-width Mode Toggle */}
<div class="flex items-center justify-between gap-2 p-2 sm:gap-4 sm:p-6">
<div class="flex min-w-0 items-center gap-3">
<div class="hidden shrink-0 rounded-md border border-border bg-surface p-2.5 sm:block">
<Maximize2 class="w-5 h-5 text-slate-500" strokeWidth={2} />
</div>
<div class="min-w-0 text-sm text-muted">
<p class="truncate text-xs font-medium text-base-content sm:text-sm">
{t('settings.general.fullWidth.title')}
</p>
<p class="hidden text-xs text-muted sm:line-clamp-2">
{t('settings.general.fullWidth.description')}
</p>
</div>
</div>
<Toggle
checked={layoutStore.isFullWidth()}
class="shrink-0"
ariaLabel={t('settings.general.fullWidth.title')}
onChange={() => layoutStore.toggle()}
/>
</div>
<div class="p-2 sm:p-6">
<BrandingSettingsCard
displayName={props.reportBrandDisplayName}
setDisplayName={props.setReportBrandDisplayName}
logoBase64={props.reportBrandLogoBase64}
setLogoBase64={props.setReportBrandLogoBase64}
logoFormat={props.reportBrandLogoFormat}
setLogoFormat={props.setReportBrandLogoFormat}
setHasUnsavedChanges={props.setHasUnsavedChanges}
/>
</div>
</SettingsPanel>
{/* Usage Data + Privacy Card */}
<SettingsPanel
id="usage-telemetry"
title={t('settings.general.telemetry.section.title')}
description={t('settings.general.telemetry.section.description')}
noPadding
bodyClass="divide-y divide-border"
>
<div class="space-y-3 p-2.5 sm:space-y-4 sm:p-6">
<div class="flex items-center justify-between gap-4">
<div class="flex-1 min-w-0 space-y-1">
<div class="flex items-center gap-2">
<span class="text-sm font-medium text-base-content truncate">
{t('settings.general.telemetry.title')}
</span>
<Show when={props.telemetryEnabledLocked()}>
<EnvironmentLockBadge envVar={TELEMETRY_ENV_VAR} />
</Show>
</div>
<p class="hidden text-xs leading-relaxed text-muted sm:block">
{t('settings.general.telemetry.description')}{' '}
<ExternalTextLink href={PRIVACY_DOC_URL} variant="muted">
{t('settings.general.telemetry.fullDetails')}
</ExternalTextLink>
</p>
<ExternalTextLink
href={PRIVACY_DOC_URL}
variant="muted"
class="text-[11px] sm:hidden"
>
{t('settings.general.telemetry.fullDetails')}
</ExternalTextLink>
</div>
<Toggle
checked={props.telemetryEnabled()}
class="shrink-0"
ariaLabel={t('settings.general.telemetry.title')}
disabled={props.telemetryEnabledLocked() || props.savingTelemetry()}
onChange={() => props.handleTelemetryEnabledChange(!props.telemetryEnabled())}
/>
</div>
<div class="flex flex-wrap gap-2 sm:gap-3">
<Button
variant="primary"
size="settingsActionXs"
disabled={props.loadingTelemetryPreview()}
onClick={() => void props.handleLoadTelemetryPreview()}
>
{props.telemetryPreview()
? t('settings.general.telemetry.refreshPayload')
: t('settings.general.telemetry.previewPayload')}
</Button>
<Button
variant="secondary"
size="settingsActionXs"
disabled={props.resettingTelemetryInstallID()}
onClick={() => void props.handleResetTelemetryInstallID()}
>
{t('settings.general.telemetry.resetId')}
</Button>
<Show when={props.telemetryPreviewPayload()}>
<Button
variant="secondary"
size="settingsActionXs"
onClick={() => void props.handleCopyTelemetryPreview()}
>
{t('settings.general.telemetry.copyJson')}
</Button>
</Show>
</div>
<Show when={props.telemetryPreviewPayload()}>
<div class="rounded-md border border-border bg-surface-alt">
<div class="flex flex-col gap-1 border-b border-border px-4 py-3">
<p class="text-xs font-semibold uppercase tracking-wide text-muted">
{t('settings.general.telemetry.payloadTitle')}
</p>
<Show when={!props.telemetryPreviewEnabled()}>
<p class="text-xs text-muted leading-relaxed">
{t('settings.general.telemetry.disabledPreview')}
</p>
</Show>
</div>
<pre
aria-label={t('settings.general.telemetry.payloadAriaLabel')}
class="overflow-x-auto px-4 py-3 text-xs leading-relaxed text-base-content"
>
{props.telemetryPreviewPayload()}
</pre>
</div>
</Show>
</div>
</SettingsPanel>
<DockerRuntimeSettingsCard
disableDockerUpdateActions={props.disableDockerUpdateActions}
disableDockerUpdateActionsLocked={props.disableDockerUpdateActionsLocked}
savingDockerUpdateActions={props.savingDockerUpdateActions}
handleDisableDockerUpdateActionsChange={props.handleDisableDockerUpdateActionsChange}
/>
<GuestDockerDiscoverySettingsCard
enableProxmoxGuestDockerInventory={props.enableProxmoxGuestDockerInventory}
guestDockerInventoryLocked={props.guestDockerInventoryLocked}
savingGuestDockerInventory={props.savingGuestDockerInventory}
handleGuestDockerInventoryChange={props.handleGuestDockerInventoryChange}
/>
{/* Monitoring Cadence Card */}
<SettingsPanel
title={t('settings.general.monitoringCadence.section.title')}
description={t('settings.general.monitoringCadence.section.description')}
noPadding
bodyClass="divide-y divide-border"
>
<div class="p-2.5 sm:p-6">
<div class="space-y-3 sm:space-y-4">
<div class="space-y-2">
<p class="text-[10px] font-bold uppercase tracking-wider text-muted">
{getPvePollingCadenceSummary(props.pvePollingInterval())}
</p>
<p class="text-xs text-muted leading-relaxed max-w-3xl">
{t('settings.general.monitoringCadence.description')}
</p>
</div>
<div class="space-y-4 pt-2">
{/* Preset buttons */}
<FilterButtonGroup
class="grid-cols-2 xl:grid-cols-5"
options={getPvePollingOptions()}
value={props.pvePollingSelection()}
onChange={handlePVEPollingSelection}
variant="prominent"
disabled={props.pvePollingEnvLocked()}
/>
{/* Custom interval input */}
<Show when={props.pvePollingSelection() === 'custom'}>
<div class="mt-4 flex flex-col sm:flex-row sm:items-center gap-4 rounded-md border border-dashed border-border bg-surface-hover p-4 transition-all animate-in fade-in slide-in-from-top-1">
<div class="flex-1 min-w-0">
<label
for="pve-custom-polling-seconds"
class="block text-sm font-medium text-base-content truncate"
>
{t('settings.general.monitoringCadence.custom.title')}
</label>
<p class="text-xs text-muted mt-0.5 line-clamp-2">
{t('settings.general.monitoringCadence.custom.description', {
min: PVE_POLLING_MIN_SECONDS,
max: PVE_POLLING_MAX_SECONDS,
})}
</p>
</div>
<input
id="pve-custom-polling-seconds"
type="number"
min={PVE_POLLING_MIN_SECONDS}
max={PVE_POLLING_MAX_SECONDS}
value={props.pvePollingCustomSeconds()}
class="w-full sm:w-32 min-h-10 rounded-md border border-border px-3 py-2 text-sm focus:outline-hidden focus:ring-2 focus:ring-blue-500 focus:border-transparent dark:focus:ring-blue-400 shadow-xs"
disabled={props.pvePollingEnvLocked()}
onInput={(e) => {
if (props.pvePollingEnvLocked()) return;
const parsed = Math.floor(Number(e.currentTarget.value));
if (Number.isNaN(parsed)) {
return;
}
const clamped = Math.min(
PVE_POLLING_MAX_SECONDS,
Math.max(PVE_POLLING_MIN_SECONDS, parsed),
);
props.setPVEPollingCustomSeconds(clamped);
props.setPVEPollingInterval(clamped);
props.setHasUnsavedChanges(true);
}}
/>
</div>
</Show>
{/* Env override warning */}
<Show when={props.pvePollingEnvLocked()}>
<div class="flex items-center gap-3 rounded-md border border-amber-200 bg-amber-50 px-4 py-3 text-xs text-amber-800 dark:border-amber-800 dark:bg-amber-900/25 dark:text-amber-200">
<svg
class="h-4 w-4 shrink-0 mt-0.5 self-start"
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
stroke-width="2"
>
<circle cx="12" cy="12" r="10" />
<line x1="12" y1="8" x2="12" y2="12" />
<circle cx="12" cy="16" r="0.5" />
</svg>
<span class="leading-relaxed">
{t('settings.general.monitoringCadence.envLocked', {
envVar: PVE_POLLING_INTERVAL_ENV_VAR,
})}
</span>
</div>
</Show>
</div>
</div>
</div>
</SettingsPanel>
</div>
);
};