Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

fix(sessions): Add redesign announcement banner (#18632)

Ben Bachem76846fb42175
diff --git a/web/src/features/posthog-analytics/usePostHogClientCapture.ts b/web/src/features/posthog-analytics/usePostHogClientCapture.ts
index 3412b50b49..53ec6fd1e0 100644
--- a/web/src/features/posthog-analytics/usePostHogClientCapture.ts
+++ b/web/src/features/posthog-analytics/usePostHogClientCapture.ts
@@ -185,6 +185,9 @@ const events = {
"duplicate_form_submit",
],
session_detail: [
+ "announcement_learn_more_click",
+ "announcement_feedback_click",
+ "announcement_dismiss",
"publish_button_click",
"download_button_click",
"copy_session_id_click",
diff --git a/web/src/features/sessions/ModernSession.tsx b/web/src/features/sessions/ModernSession.tsx
index c246383584..2243aa90ec 100644
--- a/web/src/features/sessions/ModernSession.tsx
+++ b/web/src/features/sessions/ModernSession.tsx
@@ -13,6 +13,7 @@ import {
} from "@/src/features/sessions/sessionDetailPageTypes";
type ModernSessionProps = {
+ headerDividerTone?: ComponentProps<typeof ModernSessionHeader>["dividerTone"];
isTimelineEnabled: boolean;
session: Pick<
EventSession,
@@ -49,6 +50,7 @@ type ModernSessionProps = {
};
export function ModernSession({
+ headerDividerTone,
isTimelineEnabled,
session,
tracesState,
@@ -93,6 +95,7 @@ export function ModernSession({
{(metadataJsonPaths) => (
<SessionReviewLeading>
<ModernSessionHeader
+ dividerTone={headerDividerTone ?? "default"}
projectId={projectId}
countTraces={session.countTraces}
minTimestamp={session.minTimestamp}
diff --git a/web/src/features/sessions/ModernSessionHeader.stories.tsx b/web/src/features/sessions/ModernSessionHeader.stories.tsx
index d7545a71bb..76b83104db 100644
--- a/web/src/features/sessions/ModernSessionHeader.stories.tsx
+++ b/web/src/features/sessions/ModernSessionHeader.stories.tsx
@@ -51,6 +51,7 @@ const manyUsers = Array.from(
);
const defaultArgs = {
+ dividerTone: "default",
projectId: "project-1",
countTraces: 24,
minTimestamp: new Date("2026-09-11T10:00:00Z"),
diff --git a/web/src/features/sessions/ModernSessionHeader.tsx b/web/src/features/sessions/ModernSessionHeader.tsx
index a956d6ffa3..273dc3a001 100644
--- a/web/src/features/sessions/ModernSessionHeader.tsx
+++ b/web/src/features/sessions/ModernSessionHeader.tsx
@@ -1,3 +1,4 @@
+import { cn } from "@/src/utils/tailwind";
import { OverflowCountBadge } from "@/src/components/OverflowCountBadge";
import { groupScoresByName } from "@/src/components/grouped-score-badge";
import { ScoreBadge } from "@/src/components/ScoreBadge/ScoreBadge";
@@ -39,6 +40,7 @@ import { numberFormatter } from "@/src/utils/numbers";
import { usePostHogClientCapture } from "@/src/features/posthog-analytics";
type ModernSessionHeaderProps = {
+ dividerTone: "default" | "orange";
projectId: string;
countTraces: number;
minTimestamp: Date;
@@ -269,6 +271,7 @@ const MetadataJsonPathEditorContent = ({
};
export function ModernSessionHeader({
+ dividerTone,
projectId,
countTraces,
minTimestamp,
@@ -434,7 +437,13 @@ export function ModernSessionHeader({
});
});
return (
- <div className="border-b px-4 pt-1 pb-1.5 font-mono">
+ <div
+ className={cn(
+ "border-b px-4 pt-1 pb-1.5 font-mono",
+ dividerTone === "orange" &&
+ "border-orange-200/50 dark:border-orange-900/50",
+ )}
+ >
<SingleLineOverflowList
spacing="comfortable"
items={pills}
diff --git a/web/src/features/sessions/SessionPages.tsx b/web/src/features/sessions/SessionPages.tsx
index 3c03d40ece..0c548b1356 100644
--- a/web/src/features/sessions/SessionPages.tsx
+++ b/web/src/features/sessions/SessionPages.tsx
@@ -117,6 +117,7 @@ import { SessionVirtualizedRow } from "@/src/features/sessions/SessionVirtualize
import { createSessionDetailStore } from "@/src/features/sessions/sessionDetailStore";
import { ModernSession } from "@/src/features/sessions/ModernSession";
import { ConnectedModernSessionBodyTimeline } from "@/src/features/sessions/components/ConnectedModernSessionBodyTimeline/ConnectedModernSessionBodyTimeline";
+import { SessionRedesignBanner } from "@/src/features/sessions/SessionRedesignBanner";
import { HeaderActionMenuRow } from "@/src/components/HeaderActionMenuRow";
import { ModernSessionHeaderActionsController } from "@/src/features/sessions/ModernSessionHeaderActionsController";
import { ConnectedSessionAddToDropdownMenuController } from "@/src/features/sessions/ConnectedSessionAddToDropdownMenuController";
@@ -1175,6 +1176,12 @@ const LoadedSessionEventsPage: React.FC<{
projectId,
},
);
+ const [isRedesignBannerDismissed, setIsRedesignBannerDismissed] =
+ useLocalStorage("sessionRedesignBannerDismissed", false);
+ const showRedesignBanner =
+ isModernSessionEnabled &&
+ isSessionTimelineEnabled &&
+ !isRedesignBannerDismissed;
const isMobile = useIsMobile();
const openAnnotateRef = useRef<(payload: SessionAnnotatePayload) => void>(
() => {},
@@ -2075,6 +2082,11 @@ const LoadedSessionEventsPage: React.FC<{
: "flex h-full flex-col overflow-auto"
}
>
+ {showRedesignBanner ? (
+ <SessionRedesignBanner
+ onDismiss={() => setIsRedesignBannerDismissed(true)}
+ />
+ ) : null}
{!isModernSessionEnabled && hasSessionControls ? (
<SessionControlsBar
isMobile={isMobile && !isModernSessionEnabled}
@@ -2203,6 +2215,7 @@ const LoadedSessionEventsPage: React.FC<{
</div>
) : (
<ModernSession
+ headerDividerTone={showRedesignBanner ? "orange" : "default"}
isTimelineEnabled={isSessionTimelineEnabled}
session={session}
tracesState={
diff --git a/web/src/features/sessions/SessionRedesignBanner.stories.tsx b/web/src/features/sessions/SessionRedesignBanner.stories.tsx
new file mode 100644
index 0000000000..439e38acd6
--- /dev/null
+++ b/web/src/features/sessions/SessionRedesignBanner.stories.tsx
@@ -0,0 +1,72 @@
+import { PostHog } from "posthog-js";
+import { PostHogProvider } from "posthog-js/react";
+import { expect, fn } from "storybook/test";
+import preview from "@/.storybook/preview";
+import { SessionRedesignBanner } from "@/src/features/sessions/SessionRedesignBanner";
+
+const capture = fn<PostHog["capture"]>();
+const client = new PostHog();
+client.capture = capture;
+
+const meta = preview.meta({
+ component: SessionRedesignBanner,
+ args: { onDismiss: fn() },
+ decorators: [
+ (Story) => (
+ <PostHogProvider client={client}>
+ <Story />
+ </PostHogProvider>
+ ),
+ ],
+ beforeEach: () => {
+ capture.mockClear();
+ },
+});
+
+export const Default = meta.story({});
+
+export const TestLinkClicks = meta.story({
+ name: "(Test) Link clicks",
+ play: async ({ canvas, userEvent }) => {
+ const learnMore = canvas.getByRole("link", { name: "Learn more" });
+ await expect(learnMore).toHaveAttribute(
+ "href",
+ "https://langfuse.com/changelog/2026-10-13-redesigned-session-view",
+ );
+ await userEvent.click(learnMore);
+ await expect(capture).toHaveBeenCalledWith(
+ "session_detail:announcement_learn_more_click",
+ undefined,
+ undefined,
+ );
+
+ const feedback = canvas.getByRole("link", { name: "Give feedback" });
+ await expect(feedback).toHaveAttribute(
+ "href",
+ "https://github.com/orgs/langfuse/discussions/18687",
+ );
+ await userEvent.click(feedback);
+ await expect(capture).toHaveBeenCalledWith(
+ "session_detail:announcement_feedback_click",
+ undefined,
+ undefined,
+ );
+ },
+});
+
+export const TestDismissal = meta.story({
+ name: "(Test) Dismissal",
+ play: async ({ args, canvas, userEvent }) => {
+ await userEvent.click(
+ canvas.getByRole("button", {
+ name: "Dismiss redesigned sessions view banner",
+ }),
+ );
+ await expect(args.onDismiss).toHaveBeenCalledOnce();
+ await expect(capture).toHaveBeenCalledWith(
+ "session_detail:announcement_dismiss",
+ undefined,
+ undefined,
+ );
+ },
+});
diff --git a/web/src/features/sessions/SessionRedesignBanner.tsx b/web/src/features/sessions/SessionRedesignBanner.tsx
new file mode 100644
index 0000000000..cb4627b626
--- /dev/null
+++ b/web/src/features/sessions/SessionRedesignBanner.tsx
@@ -0,0 +1,49 @@
+import { ArrowUpRight, X } from "lucide-react";
+import { Button } from "@/src/components/ui/button";
+import { usePostHogClientCapture } from "@/src/features/posthog-analytics";
+
+export function SessionRedesignBanner({
+ onDismiss,
+}: {
+ onDismiss: () => void;
+}) {
+ const capture = usePostHogClientCapture();
+ return (
+ <div className="relative flex shrink-0 items-center justify-center gap-2 border-b border-orange-200/50 bg-orange-50/60 px-10 py-1 text-sm text-orange-800 dark:border-orange-900/50 dark:bg-orange-950/30 dark:text-orange-200">
+ <span className="text-foreground">We redesigned the session view.</span>
+ <a
+ href="https://langfuse.com/changelog/2026-10-13-redesigned-session-view"
+ onClick={() => capture("session_detail:announcement_learn_more_click")}
+ target="_blank"
+ rel="noopener noreferrer"
+ className="inline-flex items-center hover:shadow-[0_1px_currentColor]"
+ >
+ Learn more
+ <ArrowUpRight className="icon-sm" aria-hidden="true" />
+ </a>
+ <a
+ href="https://github.com/orgs/langfuse/discussions/18687"
+ onClick={() => capture("session_detail:announcement_feedback_click")}
+ target="_blank"
+ rel="noopener noreferrer"
+ className="inline-flex items-center hover:shadow-[0_1px_currentColor]"
+ >
+ Give feedback
+ <ArrowUpRight className="icon-sm" aria-hidden="true" />
+ </a>
+ <div className="absolute right-2 flex items-center">
+ <Button
+ variant="ghost"
+ size="icon-xs"
+ aria-label="Dismiss redesigned sessions view banner"
+ onClick={() => {
+ capture("session_detail:announcement_dismiss");
+ onDismiss();
+ }}
+ >
+ <X className="icon-base" />
+ </Button>
+ </div>
+ </div>
+ );
+}