feat: visual identity, theme toggle, custom CSS, loading states (M4)

Grounds the visual design in the product's own subject matter (vital-
signs monitoring) rather than generic dark-mode defaults: a signature
"pulse" green tied to healthy status (the accent color and the "up"
status color are the same hue - a steady green pulse reads as
healthy, same convention as a cardiac monitor), a small ECG-trace
brand mark, and a restrained pulsing-glow animation on healthy status
dots (prefers-reduced-motion respected) as the one deliberate motion
touch. Typography moves off the bare system-ui stack: IBM Plex Sans
for UI text, IBM Plex Mono with tabular numerals for metric values
(CPU/mem/uptime/latency), Space Grotesk used once for the wordmark -
chosen partly for IBM Plex's own systems-monitoring heritage.

Functional additions:
- Light/dark toggle, independent of config.yml's theme.mode, persisted
  to localStorage with a blocking inline script to avoid a flash of
  the wrong theme on load; auto mode now genuinely follows
  prefers-color-scheme instead of hardcoding dark.
- theme.customCssPath support via a new route handler that serves a
  user-mounted CSS file at runtime (can't be a build-time import,
  hence the targeted no-css-tags lint suppression), with a path-
  traversal guard since it's still reading from disk on every request.
- Loading-skeleton state for widgets awaiting their first WebSocket
  result, distinct from both the error state and genuine no-data.

Verified visually in Chrome: theme toggle switches instantly in both
directions, a live docker widget's status dot and monospace metrics
render correctly in both palettes, and config hot-reload still adds a
new widget without a page refresh.
This commit is contained in:
2026-08-17 14:27:07 +02:00
parent 847c4be26b
commit 1e550319aa
13 changed files with 276 additions and 44 deletions
+10 -2
View File
@@ -3,14 +3,22 @@
import type { Config } from "@/lib/config/schema";
import { useConfigSubscription } from "@/lib/ws/client";
import { GroupSection } from "./GroupSection";
import { ThemeToggle } from "./ThemeToggle";
import { PulseMark } from "./PulseMark";
export function Dashboard({ config: initialConfig }: { config: Config }) {
const config = useConfigSubscription(initialConfig);
return (
<main className="mx-auto flex max-w-6xl flex-col gap-8 px-6 py-10">
<header className="flex items-center justify-between">
<h1 className="text-lg font-semibold text-fg">{config.settings.title}</h1>
<header className="flex items-center justify-between gap-4">
<div className="flex items-center gap-3">
<PulseMark />
<h1 className="font-display text-lg font-semibold tracking-tight text-fg">
{config.settings.title}
</h1>
</div>
<ThemeToggle />
</header>
{config.groups.map((group, groupIndex) => (
<GroupSection key={group.name} group={group} groupIndex={groupIndex} />
+21
View File
@@ -0,0 +1,21 @@
export function PulseMark() {
return (
<svg
width="30"
height="16"
viewBox="0 0 60 24"
fill="none"
xmlns="http://www.w3.org/2000/svg"
aria-hidden="true"
className="text-accent"
>
<path
d="M0 12H11L15 5L20 19L24 12H33L37 8L41 12H60"
stroke="currentColor"
strokeWidth="2.5"
strokeLinecap="round"
strokeLinejoin="round"
/>
</svg>
);
}
+50
View File
@@ -0,0 +1,50 @@
"use client";
import { useEffect, useState } from "react";
const STORAGE_KEY = "pulsenode-theme";
export function ThemeToggle() {
const [theme, setTheme] = useState<"dark" | "light" | null>(null);
useEffect(() => {
// One-time read of browser-only state (DOM attribute set by the anti-FOUC
// inline script, or the OS color-scheme preference) to resolve the theme
// React couldn't know during SSR. Not a case of syncing to external state
// that changes over time, so a single setState here is the right call.
const attr = document.documentElement.dataset.theme;
if (attr === "light" || attr === "dark") {
// eslint-disable-next-line react-hooks/set-state-in-effect
setTheme(attr);
return;
}
const prefersLight = window.matchMedia("(prefers-color-scheme: light)").matches;
setTheme(prefersLight ? "light" : "dark");
}, []);
function toggle() {
const next = theme === "light" ? "dark" : "light";
setTheme(next);
document.documentElement.dataset.theme = next;
try {
localStorage.setItem(STORAGE_KEY, next);
} catch {
// private browsing or storage disabled; toggle still works for this session
}
}
if (theme === null) {
return <div className="h-7 w-16 rounded-[var(--radius-widget)] border border-border bg-surface" />;
}
return (
<button
type="button"
onClick={toggle}
className="rounded-[var(--radius-widget)] border border-border bg-surface px-3 py-1.5 text-xs text-fg-muted transition-colors hover:text-fg"
aria-label="Toggle color theme"
>
{theme === "light" ? "Light" : "Dark"}
</button>
);
}