From be05673868f8b5cf612cd5be53e5e2af34adb81d Mon Sep 17 00:00:00 2001
From: Pratyush Sharma <56130065+pratyush618@users.noreply.github.com>
Date: Sat, 2 May 2026 02:21:17 +0530
Subject: [PATCH 1/3] feat(dashboard): apply branding overrides to layout

---
 dashboard/src/components/layout/app-shell.tsx |  2 +
 .../src/components/layout/mobile-menu.tsx     |  5 ++-
 dashboard/src/components/layout/sidebar.tsx   |  5 ++-
 dashboard/src/features/settings/derived.ts    | 41 +++++++++++++++++++
 dashboard/src/features/settings/index.ts      |  1 +
 5 files changed, 50 insertions(+), 4 deletions(-)
 create mode 100644 dashboard/src/features/settings/derived.ts

diff --git a/dashboard/src/components/layout/app-shell.tsx b/dashboard/src/components/layout/app-shell.tsx
index 8a8f9aa..d18ded4 100644
--- a/dashboard/src/components/layout/app-shell.tsx
+++ b/dashboard/src/components/layout/app-shell.tsx
@@ -1,11 +1,13 @@
 import type { ReactNode } from "react";
 import { TooltipProvider } from "@/components/ui";
+import { useApplyAccent } from "@/features/settings";
 import { CommandPalette } from "./command-palette";
 import { Header } from "./header";
 import { RouteErrorBoundary } from "./route-error-boundary";
 import { Sidebar } from "./sidebar";
 
 export function AppShell({ children }: { children: ReactNode }) {
+  useApplyAccent();
   return (
     <TooltipProvider delayDuration={300}>
       <div className="flex min-h-screen bg-[var(--bg)] text-[var(--fg)]">
diff --git a/dashboard/src/components/layout/mobile-menu.tsx b/dashboard/src/components/layout/mobile-menu.tsx
index e1fbf31..49127c8 100644
--- a/dashboard/src/components/layout/mobile-menu.tsx
+++ b/dashboard/src/components/layout/mobile-menu.tsx
@@ -23,8 +23,8 @@ import {
   SheetTitle,
   SheetTrigger,
 } from "@/components/ui";
+import { useBranding } from "@/features/settings";
 import { cn } from "@/lib/cn";
-import { site } from "@/lib/site";
 
 interface NavItem {
   to: string;
@@ -66,6 +66,7 @@ const NAV: Array<{ title: string; items: NavItem[] }> = [
 
 export function MobileMenu() {
   const { pathname } = useLocation();
+  const { title } = useBranding();
   const [open, setOpen] = useState(false);
 
   // Close on navigation
@@ -82,7 +83,7 @@ export function MobileMenu() {
       </SheetTrigger>
       <SheetContent side="left" className="flex flex-col p-0">
         <SheetHeader className="border-b border-[var(--border)] px-5 py-4">
-          <SheetTitle>{site.name} Dashboard</SheetTitle>
+          <SheetTitle>{title} Dashboard</SheetTitle>
         </SheetHeader>
         <nav className="flex-1 overflow-y-auto px-3 py-3">
           {NAV.map((group) => (
diff --git a/dashboard/src/components/layout/sidebar.tsx b/dashboard/src/components/layout/sidebar.tsx
index d4a4955..4236963 100644
--- a/dashboard/src/components/layout/sidebar.tsx
+++ b/dashboard/src/components/layout/sidebar.tsx
@@ -14,8 +14,8 @@ import {
   Settings2,
   Skull,
 } from "lucide-react";
+import { useBranding } from "@/features/settings";
 import { cn } from "@/lib/cn";
-import { site } from "@/lib/site";
 
 interface NavItem {
   to: string;
@@ -62,6 +62,7 @@ const NAV: NavGroup[] = [
 
 export function Sidebar() {
   const { pathname } = useLocation();
+  const { title } = useBranding();
   return (
     <aside className="hidden lg:flex w-60 shrink-0 flex-col border-r border-[var(--border)] bg-[var(--bg-subtle)]">
       <div className="flex items-center gap-2 px-5 py-4">
@@ -69,7 +70,7 @@ export function Sidebar() {
           <AlertOctagon className="size-4" aria-hidden />
         </div>
         <div className="flex flex-col leading-tight">
-          <span className="text-sm font-semibold tracking-tight">{site.name}</span>
+          <span className="text-sm font-semibold tracking-tight">{title}</span>
           <span className="text-[10px] uppercase tracking-wider text-[var(--fg-subtle)]">
             Dashboard
           </span>
diff --git a/dashboard/src/features/settings/derived.ts b/dashboard/src/features/settings/derived.ts
new file mode 100644
index 0000000..39ce273
--- /dev/null
+++ b/dashboard/src/features/settings/derived.ts
@@ -0,0 +1,41 @@
+import { useEffect } from "react";
+import { site } from "@/lib/site";
+import { useSettings } from "./hooks";
+import { SETTING_KEYS } from "./types";
+
+/**
+ * Resolved branding values. Falls back to the bundled defaults when no
+ * override is configured; never returns an empty string.
+ */
+export function useBranding(): { title: string } {
+  const { data } = useSettings();
+  const override = data?.[SETTING_KEYS.brandTitle]?.trim();
+  return { title: override || site.name };
+}
+
+/**
+ * Apply the configured accent color as a CSS variable on the root
+ * element. Invalid colors are silently ignored — the dashboard keeps
+ * the bundled default rather than producing broken styling.
+ *
+ * The dim variant (used for muted badges and hover states) is derived
+ * via ``color-mix`` so the override stays coherent with the base color.
+ */
+export function useApplyAccent(): void {
+  const { data } = useSettings();
+  const value = data?.[SETTING_KEYS.brandAccent]?.trim();
+  useEffect(() => {
+    const root = document.documentElement;
+    if (!value || !CSS.supports("color", value)) {
+      root.style.removeProperty("--color-accent");
+      root.style.removeProperty("--color-accent-dim");
+      return;
+    }
+    root.style.setProperty("--color-accent", value);
+    root.style.setProperty("--color-accent-dim", `color-mix(in srgb, ${value} 18%, transparent)`);
+    return () => {
+      root.style.removeProperty("--color-accent");
+      root.style.removeProperty("--color-accent-dim");
+    };
+  }, [value]);
+}
diff --git a/dashboard/src/features/settings/index.ts b/dashboard/src/features/settings/index.ts
index 46eea67..7a139be 100644
--- a/dashboard/src/features/settings/index.ts
+++ b/dashboard/src/features/settings/index.ts
@@ -1,6 +1,7 @@
 export { BrandingSection } from "./components/branding-section";
 export { ExternalLinksSection } from "./components/external-links-section";
 export { IntegrationsSection } from "./components/integrations-section";
+export { useApplyAccent, useBranding } from "./derived";
 export { settingsQuery, useDeleteSetting, useSettings, useUpdateSetting } from "./hooks";
 export type { ExternalLink, IntegrationUrls, SettingsSnapshot } from "./types";
 export { SETTING_KEYS } from "./types";

From 6b7c4ec2898bbe9abe5703ef5570a0b15e2c211a Mon Sep 17 00:00:00 2001
From: Pratyush Sharma <56130065+pratyush618@users.noreply.github.com>
Date: Sat, 2 May 2026 02:23:21 +0530
Subject: [PATCH 2/3] feat(dashboard): render external links in sidebar

---
 .../src/components/layout/mobile-menu.tsx     | 26 ++++++++++++++-
 dashboard/src/components/layout/sidebar.tsx   | 26 ++++++++++++++-
 .../components/external-links-section.tsx     | 30 +++--------------
 dashboard/src/features/settings/derived.ts    | 32 ++++++++++++++++++-
 dashboard/src/features/settings/index.ts      |  7 +++-
 5 files changed, 92 insertions(+), 29 deletions(-)

diff --git a/dashboard/src/components/layout/mobile-menu.tsx b/dashboard/src/components/layout/mobile-menu.tsx
index 49127c8..b827102 100644
--- a/dashboard/src/components/layout/mobile-menu.tsx
+++ b/dashboard/src/components/layout/mobile-menu.tsx
@@ -5,6 +5,7 @@ import {
   Box,
   CircuitBoard,
   Cog,
+  ExternalLink as ExternalLinkIcon,
   LayoutDashboard,
   ListTree,
   type LucideIcon,
@@ -23,7 +24,7 @@ import {
   SheetTitle,
   SheetTrigger,
 } from "@/components/ui";
-import { useBranding } from "@/features/settings";
+import { useBranding, useExternalLinks } from "@/features/settings";
 import { cn } from "@/lib/cn";
 
 interface NavItem {
@@ -67,6 +68,7 @@ const NAV: Array<{ title: string; items: NavItem[] }> = [
 export function MobileMenu() {
   const { pathname } = useLocation();
   const { title } = useBranding();
+  const externalLinks = useExternalLinks();
   const [open, setOpen] = useState(false);
 
   // Close on navigation
@@ -114,6 +116,28 @@ export function MobileMenu() {
               </ul>
             </div>
           ))}
+          {externalLinks.length > 0 ? (
+            <div className="mt-4">
+              <div className="px-2 pb-1 text-[10px] font-semibold uppercase tracking-wider text-[var(--fg-subtle)]">
+                Links
+              </div>
+              <ul className="flex flex-col gap-0.5">
+                {externalLinks.map((link) => (
+                  <li key={`${link.label}|${link.url}`}>
+                    <a
+                      href={link.url}
+                      target="_blank"
+                      rel="noreferrer noopener"
+                      className="flex items-center gap-2.5 rounded-md px-2 py-1.5 text-sm text-[var(--fg-muted)] transition-colors hover:bg-[var(--surface-2)] hover:text-[var(--fg)]"
+                    >
+                      <ExternalLinkIcon className="size-4" aria-hidden />
+                      <span className="truncate">{link.label}</span>
+                    </a>
+                  </li>
+                ))}
+              </ul>
+            </div>
+          ) : null}
         </nav>
       </SheetContent>
     </Sheet>
diff --git a/dashboard/src/components/layout/sidebar.tsx b/dashboard/src/components/layout/sidebar.tsx
index 4236963..ff42312 100644
--- a/dashboard/src/components/layout/sidebar.tsx
+++ b/dashboard/src/components/layout/sidebar.tsx
@@ -6,6 +6,7 @@ import {
   Box,
   CircuitBoard,
   Cog,
+  ExternalLink as ExternalLinkIcon,
   LayoutDashboard,
   ListTree,
   type LucideIcon,
@@ -14,7 +15,7 @@ import {
   Settings2,
   Skull,
 } from "lucide-react";
-import { useBranding } from "@/features/settings";
+import { useBranding, useExternalLinks } from "@/features/settings";
 import { cn } from "@/lib/cn";
 
 interface NavItem {
@@ -63,6 +64,7 @@ const NAV: NavGroup[] = [
 export function Sidebar() {
   const { pathname } = useLocation();
   const { title } = useBranding();
+  const externalLinks = useExternalLinks();
   return (
     <aside className="hidden lg:flex w-60 shrink-0 flex-col border-r border-[var(--border)] bg-[var(--bg-subtle)]">
       <div className="flex items-center gap-2 px-5 py-4">
@@ -105,6 +107,28 @@ export function Sidebar() {
             </ul>
           </div>
         ))}
+        {externalLinks.length > 0 ? (
+          <div className="mt-5">
+            <div className="px-2 pb-1.5 text-[10px] font-semibold uppercase tracking-wider text-[var(--fg-subtle)]">
+              Links
+            </div>
+            <ul className="flex flex-col gap-0.5">
+              {externalLinks.map((link) => (
+                <li key={`${link.label}|${link.url}`}>
+                  <a
+                    href={link.url}
+                    target="_blank"
+                    rel="noreferrer noopener"
+                    className="flex items-center gap-2.5 rounded-md px-2 py-1.5 text-sm text-[var(--fg-muted)] transition-colors hover:bg-[var(--surface-2)] hover:text-[var(--fg)]"
+                  >
+                    <ExternalLinkIcon className="size-4" aria-hidden />
+                    <span className="truncate">{link.label}</span>
+                  </a>
+                </li>
+              ))}
+            </ul>
+          </div>
+        ) : null}
       </nav>
       <div className="border-t border-[var(--border)] px-5 py-3 text-[11px] text-[var(--fg-subtle)]">
         {import.meta.env.DEV ? "dev build" : "production"}
diff --git a/dashboard/src/features/settings/components/external-links-section.tsx b/dashboard/src/features/settings/components/external-links-section.tsx
index 566d740..a36c3df 100644
--- a/dashboard/src/features/settings/components/external-links-section.tsx
+++ b/dashboard/src/features/settings/components/external-links-section.tsx
@@ -9,6 +9,7 @@ import {
   CardTitle,
   Input,
 } from "@/components/ui";
+import { parseExternalLinks } from "../derived";
 import { useDeleteSetting, useUpdateSetting } from "../hooks";
 import { type ExternalLink, SETTING_KEYS, type SettingsSnapshot } from "../types";
 
@@ -23,30 +24,6 @@ function draftId(): string {
   return crypto.randomUUID();
 }
 
-/**
- * Parse the JSON-encoded ``external_links`` setting into a typed list,
- * tolerating malformed values (returns ``[]``) so a bad write never
- * breaks the page.
- */
-function parseLinks(raw: string | undefined): ExternalLink[] {
-  if (!raw) return [];
-  try {
-    const parsed = JSON.parse(raw);
-    if (!Array.isArray(parsed)) return [];
-    return parsed
-      .filter(
-        (item): item is ExternalLink =>
-          typeof item === "object" &&
-          item !== null &&
-          typeof (item as ExternalLink).label === "string" &&
-          typeof (item as ExternalLink).url === "string",
-      )
-      .map((item) => ({ label: item.label, url: item.url }));
-  } catch {
-    return [];
-  }
-}
-
 /**
  * User-defined links rendered in the sidebar (e.g. wiki, runbook, status
  * page). Stored as a single JSON-encoded array under
@@ -56,7 +33,10 @@ export function ExternalLinksSection({ settings }: { settings: SettingsSnapshot
   const update = useUpdateSetting();
   const remove = useDeleteSetting();
 
-  const initial = useMemo(() => parseLinks(settings[SETTING_KEYS.externalLinks]), [settings]);
+  const initial = useMemo(
+    () => parseExternalLinks(settings[SETTING_KEYS.externalLinks]),
+    [settings],
+  );
   const [links, setLinks] = useState<DraftLink[]>(() =>
     initial.map((link) => ({ ...link, id: draftId() })),
   );
diff --git a/dashboard/src/features/settings/derived.ts b/dashboard/src/features/settings/derived.ts
index 39ce273..dd47ab7 100644
--- a/dashboard/src/features/settings/derived.ts
+++ b/dashboard/src/features/settings/derived.ts
@@ -1,7 +1,37 @@
 import { useEffect } from "react";
 import { site } from "@/lib/site";
 import { useSettings } from "./hooks";
-import { SETTING_KEYS } from "./types";
+import { type ExternalLink, SETTING_KEYS } from "./types";
+
+/**
+ * Parse the JSON-encoded ``external_links`` setting into a typed list,
+ * tolerating malformed values (returns ``[]``) so a bad write never
+ * breaks the page.
+ */
+export function parseExternalLinks(raw: string | undefined): ExternalLink[] {
+  if (!raw) return [];
+  try {
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) return [];
+    return parsed
+      .filter(
+        (item): item is ExternalLink =>
+          typeof item === "object" &&
+          item !== null &&
+          typeof (item as ExternalLink).label === "string" &&
+          typeof (item as ExternalLink).url === "string",
+      )
+      .map((item) => ({ label: item.label, url: item.url }));
+  } catch {
+    return [];
+  }
+}
+
+/** User-defined external links rendered in the sidebar. */
+export function useExternalLinks(): ExternalLink[] {
+  const { data } = useSettings();
+  return parseExternalLinks(data?.[SETTING_KEYS.externalLinks]);
+}
 
 /**
  * Resolved branding values. Falls back to the bundled defaults when no
diff --git a/dashboard/src/features/settings/index.ts b/dashboard/src/features/settings/index.ts
index 7a139be..b1051d3 100644
--- a/dashboard/src/features/settings/index.ts
+++ b/dashboard/src/features/settings/index.ts
@@ -1,7 +1,12 @@
 export { BrandingSection } from "./components/branding-section";
 export { ExternalLinksSection } from "./components/external-links-section";
 export { IntegrationsSection } from "./components/integrations-section";
-export { useApplyAccent, useBranding } from "./derived";
+export {
+  parseExternalLinks,
+  useApplyAccent,
+  useBranding,
+  useExternalLinks,
+} from "./derived";
 export { settingsQuery, useDeleteSetting, useSettings, useUpdateSetting } from "./hooks";
 export type { ExternalLink, IntegrationUrls, SettingsSnapshot } from "./types";
 export { SETTING_KEYS } from "./types";

From ec92b80592a3a4f954016fb29d02dc3875f26b8d Mon Sep 17 00:00:00 2001
From: Pratyush Sharma <56130065+pratyush618@users.noreply.github.com>
Date: Sat, 2 May 2026 02:25:17 +0530
Subject: [PATCH 3/3] feat(dashboard): integration deep-links on job overview

Renders Open in Grafana / Sentry / OTel buttons when those integration URLs are configured. The {job_id} placeholder is substituted into the template so users can deep-link into pre-filtered dashboards.
---
 .../jobs/components/job-overview-tab.tsx      | 47 ++++++++++++++++++-
 dashboard/src/features/settings/derived.ts    | 23 ++++++++-
 dashboard/src/features/settings/index.ts      |  2 +
 3 files changed, 70 insertions(+), 2 deletions(-)

diff --git a/dashboard/src/features/jobs/components/job-overview-tab.tsx b/dashboard/src/features/jobs/components/job-overview-tab.tsx
index bfe2fe8..66dcf14 100644
--- a/dashboard/src/features/jobs/components/job-overview-tab.tsx
+++ b/dashboard/src/features/jobs/components/job-overview-tab.tsx
@@ -1,6 +1,9 @@
+import { ExternalLink as ExternalLinkIcon } from "lucide-react";
 import type { ReactNode } from "react";
-import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui";
+import { buttonVariants, Card, CardContent, CardHeader, CardTitle } from "@/components/ui";
+import { applyJobContext, useIntegrations } from "@/features/settings";
 import type { Job } from "@/lib/api-types";
+import { cn } from "@/lib/cn";
 import { formatAbsolute, formatDuration, formatRelative } from "@/lib/time";
 
 interface JobOverviewTabProps {
@@ -13,6 +16,7 @@ export function JobOverviewTab({ job }: JobOverviewTabProps) {
 
   return (
     <div className="grid gap-4 lg:grid-cols-2">
+      <JobIntegrations job={job} />
       <Card>
         <CardHeader className="pb-2">
           <CardTitle>Identity</CardTitle>
@@ -132,3 +136,44 @@ function tryPrettyJson(raw: string): string {
     return raw;
   }
 }
+
+/**
+ * Render configured integration shortcuts (Grafana / Sentry / OTel) for
+ * the given job. Each URL may contain a ``{job_id}`` placeholder; if it
+ * doesn't, the configured URL opens as-is. Renders nothing when no
+ * integration is configured.
+ */
+function JobIntegrations({ job }: { job: Job }) {
+  const integrations = useIntegrations();
+  const links = (
+    [
+      { label: "Open in Grafana", href: integrations.grafana },
+      { label: "Open in Sentry", href: integrations.sentry },
+      { label: "Open in OTel", href: integrations.otel },
+    ] as const
+  ).filter((entry) => entry.href);
+
+  if (links.length === 0) return null;
+
+  return (
+    <Card className="lg:col-span-2">
+      <CardHeader className="pb-2">
+        <CardTitle>Integrations</CardTitle>
+      </CardHeader>
+      <CardContent className="flex flex-wrap gap-2">
+        {links.map(({ label, href }) => (
+          <a
+            key={label}
+            href={applyJobContext(href, job.id)}
+            target="_blank"
+            rel="noreferrer noopener"
+            className={cn(buttonVariants({ variant: "outline", size: "sm" }))}
+          >
+            <ExternalLinkIcon className="size-4" aria-hidden />
+            {label}
+          </a>
+        ))}
+      </CardContent>
+    </Card>
+  );
+}
diff --git a/dashboard/src/features/settings/derived.ts b/dashboard/src/features/settings/derived.ts
index dd47ab7..369d819 100644
--- a/dashboard/src/features/settings/derived.ts
+++ b/dashboard/src/features/settings/derived.ts
@@ -1,7 +1,7 @@
 import { useEffect } from "react";
 import { site } from "@/lib/site";
 import { useSettings } from "./hooks";
-import { type ExternalLink, SETTING_KEYS } from "./types";
+import { type ExternalLink, type IntegrationUrls, SETTING_KEYS } from "./types";
 
 /**
  * Parse the JSON-encoded ``external_links`` setting into a typed list,
@@ -33,6 +33,27 @@ export function useExternalLinks(): ExternalLink[] {
   return parseExternalLinks(data?.[SETTING_KEYS.externalLinks]);
 }
 
+/** Configured integration URLs, with empty/whitespace values normalized. */
+export function useIntegrations(): IntegrationUrls {
+  const { data } = useSettings();
+  return {
+    grafana: data?.[SETTING_KEYS.integrationGrafana]?.trim() ?? "",
+    sentry: data?.[SETTING_KEYS.integrationSentry]?.trim() ?? "",
+    otel: data?.[SETTING_KEYS.integrationOtel]?.trim() ?? "",
+  };
+}
+
+/**
+ * Substitute supported placeholders in an integration URL template.
+ *
+ * Currently supports ``{job_id}``. URLs without any placeholder are
+ * returned unchanged so users can configure either a templated deep
+ * link or a static landing page.
+ */
+export function applyJobContext(template: string, jobId: string): string {
+  return template.replaceAll("{job_id}", encodeURIComponent(jobId));
+}
+
 /**
  * Resolved branding values. Falls back to the bundled defaults when no
  * override is configured; never returns an empty string.
diff --git a/dashboard/src/features/settings/index.ts b/dashboard/src/features/settings/index.ts
index b1051d3..0dbe45f 100644
--- a/dashboard/src/features/settings/index.ts
+++ b/dashboard/src/features/settings/index.ts
@@ -2,10 +2,12 @@ export { BrandingSection } from "./components/branding-section";
 export { ExternalLinksSection } from "./components/external-links-section";
 export { IntegrationsSection } from "./components/integrations-section";
 export {
+  applyJobContext,
   parseExternalLinks,
   useApplyAccent,
   useBranding,
   useExternalLinks,
+  useIntegrations,
 } from "./derived";
 export { settingsQuery, useDeleteSetting, useSettings, useUpdateSetting } from "./hooks";
 export type { ExternalLink, IntegrationUrls, SettingsSnapshot } from "./types";