Dashboard status strip, "Not set up yet" list, sidebar badges and user menu

The dashboard opens with one line saying whether anything needs attention
(from the same alert report as the Alerts page) and never claims "all clear"
when some checks couldn't run. Widgets with nothing configured are listed once
under "Not set up yet" instead of one grey card each. The sidebar shows the
active alert count and open maintenance windows next to their pages (and on a
closed group), and the foot of the sidebar is one user menu holding theme,
privacy and sign-out. One shared alert poll serves the strip and the badge.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
bobbanandClaude Sonnet 5.5 committed 2026-10-14 23:18:31 +02:00
1 parent aab2f8cb4a
commit 7d56ad18b7
5 files changed
+369 -22

No files matched your search

+97
View File
@@ -0,0 +1,97 @@
import { Link } from "react-router-dom";
import { IconAlertTriangle, IconCircleCheck, IconInfoCircle } from "@tabler/icons-react";
import { alertBadge, useAlertsReport } from "../hooks/useAlertsReport";
const SEVERITY_ORDER = { critical: 0, warning: 1, info: 2 } as const;
/** One line at the top of the dashboard: is anything wrong right now? Reads the same alert report as the Alerts page. */
export default function StatusStrip() {
const { report, failed, reload } = useAlertsReport();
if (!report) {
return (
<div className="alert alert-secondary d-flex align-items-center gap-2 mb-3" role="status">
<IconInfoCircle size={18} />
<div>{failed ? "Couldn't load the alert status." : "Checking status…"}</div>
{failed && (
<button type="button" className="btn btn-sm ms-auto" onClick={reload}>
Try again
</button>
)}
</div>
);
}
const badge = alertBadge(report);
const active = report.alerts
.filter((a) => !a.silenced && a.severity !== "info")
.sort((a, b) => SEVERITY_ORDER[a.severity] - SEVERITY_ORDER[b.severity]);
const silenced = report.counts.silenced;
const blind = report.couldntCheck.length;
const notes: string[] = [];
if (silenced > 0) notes.push(`${silenced} silenced by maintenance`);
if (blind > 0 && badge) notes.push(`${blind} check${blind === 1 ? "" : "s"} couldn't run`);
if (!badge) {
// Nothing is wrong that we can see — but if some checks couldn't run, "all clear" would claim more than is known.
const unsure = blind > 0;
return (
<div className={`alert ${unsure ? "alert-warning" : "alert-success"} mb-3`} role="status">
<div className="d-flex align-items-center gap-2">
{unsure ? <IconAlertTriangle size={18} className="flex-shrink-0" /> : <IconCircleCheck size={18} className="flex-shrink-0" />}
<div>
<strong>{unsure ? "No active alerts, but some checks couldn't run." : "All clear."}</strong>{" "}
{unsure ? (
<span>
{report.couldntCheck.map((c) => c.name).join(", ")} — see <Link to="/alerts">Alerts</Link> for what that leaves unchecked.
</span>
) : (
<span className="text-secondary">No active alerts.</span>
)}
{silenced > 0 && <span className="text-secondary"> {silenced} silenced by maintenance.</span>}
</div>
</div>
</div>
);
}
const parts = [
report.counts.critical > 0 ? `${report.counts.critical} critical` : null,
report.counts.warning > 0 ? `${report.counts.warning} warning${report.counts.warning === 1 ? "" : "s"}` : null,
].filter(Boolean);
return (
<div className={`alert ${badge.level === "critical" ? "alert-danger" : "alert-warning"} mb-3`} role="alert">
<div className="d-flex gap-2 w-100">
<IconAlertTriangle size={18} className="flex-shrink-0 mt-1" />
<div className="flex-fill">
<div className="d-flex flex-wrap align-items-center gap-2">
<div>
<strong>
{badge.count} {badge.count === 1 ? "thing needs" : "things need"} attention
</strong>{" "}
— {parts.join(", ")}
{notes.length > 0 && <span className="opacity-75"> · {notes.join(" · ")}</span>}
</div>
<Link to="/alerts" className="btn btn-sm ms-auto flex-shrink-0">
View all alerts
</Link>
</div>
{active.length > 0 && (
<ul className="mb-0 mt-2 ps-3">
{active.slice(0, 3).map((a) => (
<li key={a.id}>
<Link to={a.link ?? "/alerts"} className="alert-link">
{a.message}
</Link>
</li>
))}
{active.length > 3 && <li className="opacity-75">and {active.length - 3} more</li>}
</ul>
)}
</div>
</div>
</div>
);
}
+64
View File
@@ -0,0 +1,64 @@
import { useSyncExternalStore } from "react";
import { api, type AlertsReport } from "../api/client";
/**
* The current alert report, shared by everything on the page that shows it (the sidebar badge and the dashboard strip), so
* one request every minute serves them all. The server keeps the result for a minute as well, so this costs no extra checks.
*/
interface State {
report: AlertsReport | null;
/** The last attempt failed (the previous report, if any, is kept). */
failed: boolean;
}
const POLL_MS = 60_000;
let state: State = { report: null, failed: false };
const listeners = new Set<() => void>();
let timer: ReturnType<typeof setInterval> | null = null;
let inFlight = false;
function set(next: State) {
state = next;
for (const l of listeners) l();
}
async function refresh(): Promise<void> {
if (inFlight) return;
inFlight = true;
try {
set({ report: await api.alerts.list(), failed: false });
} catch {
set({ report: state.report, failed: true });
} finally {
inFlight = false;
}
}
function subscribe(listener: () => void): () => void {
listeners.add(listener);
if (listeners.size === 1) {
void refresh();
timer = setInterval(() => void refresh(), POLL_MS);
}
return () => {
listeners.delete(listener);
if (listeners.size === 0 && timer) {
clearInterval(timer);
timer = null;
}
};
}
export function useAlertsReport(): State & { reload: () => void } {
const s = useSyncExternalStore(subscribe, () => state);
return { ...s, reload: () => void refresh() };
}
/** What the sidebar shows next to Alerts: how many problems are active, coloured by the worst one. Silenced and informational ones don't count. */
export function alertBadge(report: AlertsReport | null): { count: number; level: "critical" | "warning" } | null {
if (!report) return null;
const count = report.counts.critical + report.counts.warning;
if (count === 0) return null;
return { count, level: report.counts.critical > 0 ? "critical" : "warning" };
}
+111 -21
View File
@@ -1,4 +1,4 @@
import { useEffect, useState, type ReactNode } from "react";
import { useEffect, useRef, useState, type ReactNode } from "react";
import { Link, NavLink, useLocation } from "react-router-dom";
import {
IconLayoutDashboard,
@@ -33,12 +33,27 @@ import {
IconPlug,
IconExternalLink,
IconAlertTriangle,
IconChevronUp,
IconLogout,
} from "@tabler/icons-react";
import { api, type CurrentUser, type MaintenanceWindow } from "../api/client";
import { formatRemaining } from "../utils/duration";
import { getTheme, setTheme, type Theme } from "../utils/theme";
import CommandPalette from "../components/CommandPalette";
import { isLightColor, useEnvironment } from "../utils/environment";
import { alertBadge, useAlertsReport } from "../hooks/useAlertsReport";
interface NavBadge {
text: string;
className: string;
title: string;
}
/** Up to two initials for the little avatar in the user menu. */
function initialsOf(name: string): string {
const words = name.replace(/@.*$/, "").split(/[\s._-]+/).filter(Boolean);
return (words.length > 1 ? words[0][0] + words[1][0] : (words[0] ?? "?").slice(0, 2)).toUpperCase();
}
type Role = "operator" | "admin";
@@ -165,6 +180,24 @@ export default function AppShell({ user, children }: { user: CurrentUser; childr
const [theme, setThemeState] = useState<Theme>(() => getTheme());
const [maintenance, setMaintenance] = useState<MaintenanceWindow[]>([]);
const environment = useEnvironment();
const { report } = useAlertsReport();
const [menuOpen, setMenuOpen] = useState(false);
const menuRef = useRef<HTMLDivElement>(null);
// Closes the user menu when you click elsewhere or press Escape.
useEffect(() => {
if (!menuOpen) return;
const onDown = (e: MouseEvent) => {
if (menuRef.current && !menuRef.current.contains(e.target as Node)) setMenuOpen(false);
};
const onKey = (e: KeyboardEvent) => e.key === "Escape" && setMenuOpen(false);
document.addEventListener("mousedown", onDown);
document.addEventListener("keydown", onKey);
return () => {
document.removeEventListener("mousedown", onDown);
document.removeEventListener("keydown", onKey);
};
}, [menuOpen]);
// Everyone sees what's currently silenced, so nobody is left wondering why an alert never came.
useEffect(() => {
@@ -214,6 +247,32 @@ export default function AppShell({ user, children }: { user: CurrentUser; childr
});
}
// What needs a look, shown next to the page that deals with it.
const badges: Record<string, NavBadge> = {};
const alerts = alertBadge(report);
if (alerts) {
badges["/alerts"] = {
text: String(alerts.count),
className: alerts.level === "critical" ? "bg-red text-red-fg" : "bg-yellow text-yellow-fg",
title: `${alerts.count} active alert${alerts.count === 1 ? "" : "s"}`,
};
}
if (maintenance.length > 0) {
badges["/maintenance"] = {
text: String(maintenance.length),
className: "bg-blue text-blue-fg",
title: `${maintenance.length} maintenance window${maintenance.length === 1 ? "" : "s"} open`,
};
}
const badgeOf = (to: string) => {
const b = badges[to];
return b ? (
<span className={`badge ms-auto ${b.className}`} title={b.title}>
{b.text}
</span>
) : null;
};
function toggleTheme() {
const next: Theme = theme === "dark" ? "light" : "dark";
setTheme(next);
@@ -252,6 +311,7 @@ export default function AppShell({ user, children }: { user: CurrentUser; childr
<NavLink to={entry.to} end={entry.to === "/"} className="nav-link" onClick={() => setSidebarOpen(false)}>
<span className="nav-link-icon d-md-none d-lg-inline-block">{entry.icon}</span>
<span className="nav-link-title">{entry.label}</span>
{badgeOf(entry.to)}
</NavLink>
</li>
);
@@ -268,16 +328,29 @@ export default function AppShell({ user, children }: { user: CurrentUser; childr
>
<span className="nav-link-icon d-md-none d-lg-inline-block">{entry.icon}</span>
<span className="nav-link-title">{entry.label}</span>
{/* A closed group still says that something inside it needs a look. */}
{!open &&
(() => {
const inside = entry.items.map((item) => badges[item.to]).filter(Boolean);
if (inside.length === 0) return null;
const worst = inside.find((b) => b.className.includes("bg-red")) ?? inside.find((b) => b.className.includes("bg-yellow")) ?? inside[0];
return (
<span className={`badge ms-auto me-4 ${worst.className}`} title={inside.map((b) => b.title).join(", ")}>
{inside.reduce((n, b) => n + Number(b.text), 0)}
</span>
);
})()}
</button>
<div className={`dropdown-menu ${open ? "show" : ""}`}>
{entry.items.map((item) => (
<NavLink
key={item.to}
to={item.to}
className={({ isActive }) => `dropdown-item ${isActive ? "active" : ""}`}
className={({ isActive }) => `dropdown-item d-flex align-items-center ${isActive ? "active" : ""}`}
onClick={() => setSidebarOpen(false)}
>
{item.label}
{badgeOf(item.to)}
</NavLink>
))}
</div>
@@ -285,29 +358,46 @@ export default function AppShell({ user, children }: { user: CurrentUser; childr
);
})}
</ul>
<div className="navbar-footer px-3">
<div className="navbar-footer px-3 user-menu" ref={menuRef}>
{menuOpen && (
<div className="user-menu-list" role="menu">
<button type="button" className="user-menu-item" role="menuitem" onClick={toggleTheme}>
{theme === "dark" ? <IconSun size={16} /> : <IconMoon size={16} />}
{theme === "dark" ? "Light mode" : "Dark mode"}
</button>
<NavLink
to="/privacy"
className="user-menu-item"
role="menuitem"
onClick={() => {
setMenuOpen(false);
setSidebarOpen(false);
}}
>
<IconShieldLock size={16} />
Privacy
</NavLink>
<a className="user-menu-item" role="menuitem" href="/auth/logout">
<IconLogout size={16} />
Sign out
</a>
</div>
)}
<button
type="button"
className="btn btn-outline-secondary btn-sm w-100 mb-2 d-flex align-items-center justify-content-center gap-2"
onClick={toggleTheme}
className="user-menu-toggle"
aria-haspopup="menu"
aria-expanded={menuOpen}
title={user.email ?? undefined}
onClick={() => setMenuOpen((open) => !open)}
>
{theme === "dark" ? <IconSun size={16} /> : <IconMoon size={16} />}
{theme === "dark" ? "Light mode" : "Dark mode"}
<span className="avatar avatar-sm">{initialsOf(user.name ?? user.email ?? user.sub)}</span>
<span className="user-menu-who">
<span className="d-block text-truncate">{user.name ?? user.email ?? user.sub}</span>
<span className="d-block small opacity-75">{user.role}</span>
</span>
<IconChevronUp size={16} className={menuOpen ? "" : "user-menu-chevron-closed"} />
</button>
<NavLink
to="/privacy"
className="btn btn-outline-secondary btn-sm w-100 mb-2 d-flex align-items-center justify-content-center gap-2"
onClick={() => setSidebarOpen(false)}
>
<IconShieldLock size={16} />
Privacy
</NavLink>
<div className="text-secondary small mb-2">
Signed in as {user.name ?? user.email ?? user.sub} · {user.role}
</div>
<a className="btn btn-outline-secondary btn-sm w-100" href="/auth/logout">
Sign out
</a>
</div>
</div>
</div>
+37 -1
View File
@@ -13,6 +13,7 @@ import {
type TailscaleDevicesResponse,
} from "../api/client";
import { formatAgo } from "../utils/duration";
import StatusStrip from "../components/StatusStrip";
const DNS_TYPE_COLORS: Record<string, string> = {
A: "#60a5fa",
@@ -180,7 +181,8 @@ function MiniStat({ label, value, accent }: { label: string; value: ReactNode; a
}
/** The single card shape shared by every dashboard widget — DNS, Secrets, and each integration — so they all read as one family: a label + status badge, then whatever stats/breakdown that widget has. */
function WidgetCard({ label, badge, children }: { label: string; badge?: ReactNode; children: ReactNode }) {
function WidgetCard({ label, badge, hide, children }: { label: string; badge?: ReactNode; /** Nothing is set up for this yet: it is listed under "Not set up yet" instead of taking a card. */ hide?: boolean; children: ReactNode }) {
if (hide) return null;
return (
<div className="col-md-6">
<div className="card h-100">
@@ -535,6 +537,18 @@ export default function Dashboard({ user }: { user: CurrentUser }) {
}, {}),
).map(([type, count]) => ({ label: SECRET_TYPE_LABELS[type as SecretRecord["type"]] ?? type, count }));
// What has nothing set up yet. These get one list at the bottom instead of a grey "Not configured" card each.
const notSetUp: { label: string; to: string; what: string }[] = [];
if (dnsStats?.totalProviders === 0) notSetUp.push({ label: "DNS", to: "/dns", what: "connect a DNS provider to see zones and records" });
if (secrets !== null && totalSecrets === 0) notSetUp.push({ label: "Secrets", to: "/secrets", what: "track when a token, certificate or password expires" });
if (serverSummary?.total === 0) notSetUp.push({ label: "Servers", to: "/servers", what: "add a server and install its agent" });
if (domainList !== null && domains.length === 0) notSetUp.push({ label: "Domains", to: "/domains", what: "appear after a DNS zone is added and the daily check has run" });
if (integrations !== null) {
for (const { type, label } of WIDGETS) {
if (!integrations.some((i) => i.type === type)) notSetUp.push({ label, to: "/integrations", what: "connect it under Integrations" });
}
}
return (
<>
<div className="row row-cards mb-3">
@@ -543,6 +557,7 @@ export default function Dashboard({ user }: { user: CurrentUser }) {
<p className="text-secondary">
Welcome back, {user.name ?? user.email ?? user.sub}.
</p>
<StatusStrip />
</div>
</div>
@@ -550,6 +565,7 @@ export default function Dashboard({ user }: { user: CurrentUser }) {
<div className="row row-cards mb-3">
<WidgetCard
label="DNS"
hide={dnsStats?.totalProviders === 0}
badge={
!dnsStats ? undefined : dnsStats.totalProviders === 0 ? (
<span className="badge bg-secondary-lt text-secondary">Not configured</span>
@@ -597,6 +613,7 @@ export default function Dashboard({ user }: { user: CurrentUser }) {
<WidgetCard
label="Secrets"
hide={secrets !== null && totalSecrets === 0}
badge={
!secrets ? undefined : totalSecrets === 0 ? (
<span className="badge bg-secondary-lt text-secondary">Not configured</span>
@@ -635,6 +652,7 @@ export default function Dashboard({ user }: { user: CurrentUser }) {
<WidgetCard
label="Servers"
hide={serverSummary?.total === 0}
badge={
!serverSummary ? undefined : serverSummary.total === 0 ? (
<span className="badge bg-secondary-lt text-secondary">Not configured</span>
@@ -729,6 +747,7 @@ export default function Dashboard({ user }: { user: CurrentUser }) {
<WidgetCard
label="Domains"
hide={domainList !== null && domains.length === 0}
badge={
!domainList ? undefined : domains.length === 0 ? (
<span className="badge bg-secondary-lt text-secondary">Not configured</span>
@@ -847,6 +866,7 @@ export default function Dashboard({ user }: { user: CurrentUser }) {
<WidgetCard
key={type}
label={label}
hide={integrations === null || !integrations.some((i) => i.type === type)}
badge={
isLive ? (
<span className="badge bg-green-lt text-green">Connected</span>
@@ -1072,6 +1092,22 @@ export default function Dashboard({ user }: { user: CurrentUser }) {
);
})}
</div>
{notSetUp.length > 0 && (
<div className="card mt-4">
<div className="card-header">
<h3 className="card-title">Not set up yet</h3>
</div>
<div className="list-group list-group-flush">
{notSetUp.map((n) => (
<Link key={n.label} to={n.to} className="list-group-item list-group-item-action d-flex align-items-center gap-3">
<span className="fw-medium">{n.label}</span>
<span className="text-secondary small">{n.what}</span>
</Link>
))}
</div>
</div>
)}
</>
);
}
+60
View File
@@ -85,6 +85,66 @@ html[data-env] .navbar-vertical {
border-top: 4px solid var(--hlm-env-color);
}
/* The user menu at the foot of the sidebar: who is signed in, with theme, privacy and sign-out behind one button. */
.user-menu {
position: relative;
}
.user-menu-toggle {
display: flex;
align-items: center;
gap: 0.6rem;
width: 100%;
padding: 0.4rem 0.5rem;
color: inherit;
text-align: left;
background: color-mix(in srgb, currentColor 7%, transparent);
border: 1px solid color-mix(in srgb, currentColor 20%, transparent);
border-radius: var(--tblr-border-radius, 4px);
}
.user-menu-toggle:hover,
.user-menu-toggle[aria-expanded="true"] {
background: color-mix(in srgb, currentColor 14%, transparent);
}
.user-menu-who {
flex: 1;
min-width: 0;
line-height: 1.2;
}
.user-menu-chevron-closed {
transform: rotate(180deg);
}
.user-menu-list {
margin-bottom: 0.4rem;
padding: 0.25rem;
background: color-mix(in srgb, currentColor 9%, transparent);
border: 1px solid color-mix(in srgb, currentColor 20%, transparent);
border-radius: var(--tblr-border-radius, 4px);
}
.user-menu-item {
display: flex;
align-items: center;
gap: 0.6rem;
width: 100%;
padding: 0.4rem 0.5rem;
color: inherit;
text-align: left;
text-decoration: none;
background: none;
border: 0;
border-radius: var(--tblr-border-radius, 4px);
}
.user-menu-item:hover {
color: inherit;
background: color-mix(in srgb, currentColor 14%, transparent);
}
/* Sidebar submenus: a little tighter than Tabler's dropdown rows, so several open groups still fit on one screen. */
.navbar-vertical .dropdown-menu .dropdown-item {
padding-top: 0.3rem;