From 8734063afdd51ed39976763c2e2dc288358f180b Mon Sep 17 00:00:00 2001
From: Leo <omarleopaz@hotmail.com>
Date: Fri, 6 Feb 2026 17:08:02 -0800
Subject: [PATCH 01/20] feat(marketing): add Outlit SDK with consent-gated
 tracking

---
 apps/marketing/package.json                   |  1 +
 apps/marketing/src/app/providers.tsx          | 25 +++++++++++++------
 .../CookieConsent/CookieConsent.tsx           |  3 +++
 apps/marketing/src/env.ts                     |  2 ++
 apps/marketing/src/lib/outlit/index.ts        | 21 ++++++++++++++++
 bun.lock                                      |  5 ++++
 6 files changed, 49 insertions(+), 8 deletions(-)
 create mode 100644 apps/marketing/src/lib/outlit/index.ts

diff --git a/apps/marketing/package.json b/apps/marketing/package.json
index a5687af3c24..d688cd99ada 100644
--- a/apps/marketing/package.json
+++ b/apps/marketing/package.json
@@ -11,6 +11,7 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"dependencies": {
+		"@outlit/browser": "^1.2.0",
 		"@react-three/drei": "^10.7.6",
 		"@react-three/fiber": "^9.4.0",
 		"@sentry/nextjs": "^10.36.0",
diff --git a/apps/marketing/src/app/providers.tsx b/apps/marketing/src/app/providers.tsx
index 5160fa321bf..cee84191792 100644
--- a/apps/marketing/src/app/providers.tsx
+++ b/apps/marketing/src/app/providers.tsx
@@ -1,22 +1,31 @@
 "use client";
 
+import { OutlitProvider } from "@outlit/browser/react";
 import { THEME_STORAGE_KEY } from "@superset/shared/constants";
 import { ThemeProvider } from "next-themes";
 import posthog from "posthog-js";
 import { PostHogProvider } from "posthog-js/react";
 
+import { env } from "@/env";
+
 export function Providers({ children }: { children: React.ReactNode }) {
 	return (
 		<PostHogProvider client={posthog}>
-			<ThemeProvider
-				attribute="class"
-				defaultTheme="dark"
-				forcedTheme="dark"
-				storageKey={THEME_STORAGE_KEY}
-				disableTransitionOnChange
+			<OutlitProvider
+				publicKey={env.NEXT_PUBLIC_OUTLIT_KEY ?? ""}
+				trackPageviews
+				autoTrack={false}
 			>
-				{children}
-			</ThemeProvider>
+				<ThemeProvider
+					attribute="class"
+					defaultTheme="dark"
+					forcedTheme="dark"
+					storageKey={THEME_STORAGE_KEY}
+					disableTransitionOnChange
+				>
+					{children}
+				</ThemeProvider>
+			</OutlitProvider>
 		</PostHogProvider>
 	);
 }
diff --git a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
index ca8100adced..e17e9fe00f7 100644
--- a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
+++ b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
@@ -1,5 +1,6 @@
 "use client";
 
+import { useOutlit } from "@outlit/browser/react";
 import { Button } from "@superset/ui/button";
 import { AnimatePresence, motion } from "framer-motion";
 import Link from "next/link";
@@ -9,6 +10,7 @@ import { useEffect, useState } from "react";
 import { ANALYTICS_CONSENT_KEY } from "@/lib/constants";
 
 export function CookieConsent() {
+	const { enableTracking } = useOutlit();
 	const [showBanner, setShowBanner] = useState(false);
 
 	useEffect(() => {
@@ -21,6 +23,7 @@ export function CookieConsent() {
 	const handleAccept = () => {
 		localStorage.setItem(ANALYTICS_CONSENT_KEY, "accepted");
 		setShowBanner(false);
+		enableTracking();
 	};
 
 	const handleOptOut = () => {
diff --git a/apps/marketing/src/env.ts b/apps/marketing/src/env.ts
index 3d7dc7948de..aea10c322f3 100644
--- a/apps/marketing/src/env.ts
+++ b/apps/marketing/src/env.ts
@@ -30,6 +30,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_SENTRY_ENVIRONMENT: z
 			.enum(["development", "preview", "production"])
 			.optional(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
 	},
 	experimental__runtimeEnv: {
 		NODE_ENV: process.env.NODE_ENV,
@@ -40,6 +41,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_SENTRY_DSN_MARKETING:
 			process.env.NEXT_PUBLIC_SENTRY_DSN_MARKETING,
 		NEXT_PUBLIC_SENTRY_ENVIRONMENT: process.env.NEXT_PUBLIC_SENTRY_ENVIRONMENT,
+		NEXT_PUBLIC_OUTLIT_KEY: process.env.NEXT_PUBLIC_OUTLIT_KEY,
 	},
 	skipValidation: !!process.env.SKIP_ENV_VALIDATION,
 });
diff --git a/apps/marketing/src/lib/outlit/index.ts b/apps/marketing/src/lib/outlit/index.ts
new file mode 100644
index 00000000000..80d98a29f8d
--- /dev/null
+++ b/apps/marketing/src/lib/outlit/index.ts
@@ -0,0 +1,21 @@
+import { Outlit } from "@outlit/browser";
+
+import { env } from "@/env";
+
+let outlit: Outlit | null = null;
+
+export function getOutlit(): Outlit | null {
+	if (!env.NEXT_PUBLIC_OUTLIT_KEY) return null;
+
+	if (!outlit) {
+		outlit = new Outlit({
+			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
+			trackPageviews: true,
+			trackForms: true,
+			autoTrack: false,
+		});
+	}
+	return outlit;
+}
+
+export { outlit };
diff --git a/bun.lock b/bun.lock
index 381ec757235..85598b0ab1e 100644
--- a/bun.lock
+++ b/bun.lock
@@ -318,6 +318,7 @@
       "name": "@superset/marketing",
       "version": "0.1.0",
       "dependencies": {
+        "@outlit/browser": "^1.2.0",
         "@react-three/drei": "^10.7.6",
         "@react-three/fiber": "^9.4.0",
         "@sentry/nextjs": "^10.36.0",
@@ -1517,6 +1518,10 @@
 
     "@orama/orama": ["@orama/orama@3.1.18", "", {}, "sha512-a61ljmRVVyG5MC/698C8/FfFDw5a8LOIvyOLW5fztgUXqUpc1jOfQzOitSCbge657OgXXThmY3Tk8fpiDb4UcA=="],
 
+    "@outlit/browser": ["@outlit/browser@1.2.0", "", { "dependencies": { "@outlit/core": "1.1.0" }, "peerDependencies": { "react": ">=17.0.0", "vue": ">=3.0.0" }, "optionalPeers": ["react", "vue"] }, "sha512-h2c/9Qmzw7tVygPln3o8XVEVA/0E9XWOhbh2mNWPjmCmv0VbREP4IoU8dG4flWYNKcGo2aVPsdIXTiEVqSlkzg=="],
+
+    "@outlit/core": ["@outlit/core@1.1.0", "", {}, "sha512-TNM9cIdunfcF0TLwCzSJ7sZWmDhUF8oYt4Q1KgW5Fm+4KGsfjDUbGDq9svrml1cmPrAXTZdiYwIYdRAG9327/g=="],
+
     "@pierre/diffs": ["@pierre/diffs@1.0.10", "", { "dependencies": { "@shikijs/core": "^3.0.0", "@shikijs/engine-javascript": "^3.0.0", "@shikijs/transformers": "^3.0.0", "diff": "8.0.3", "hast-util-to-html": "9.0.5", "lru_map": "0.4.1", "shiki": "^3.0.0" }, "peerDependencies": { "react": "^18.3.1 || ^19.0.0", "react-dom": "^18.3.1 || ^19.0.0" } }, "sha512-ahkpfS30NfaB+PBxnf0/Mc20ySBRTQmM28a7Ojpd0UZixmTyhGhJfBFjvmhX8dSzR22lB3h3OIMMxpB4yYTIOQ=="],
 
     "@pkgjs/parseargs": ["@pkgjs/parseargs@0.11.0", "", {}, "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg=="],

From 3c7f013ae53686201463bd24aff18538810d903f Mon Sep 17 00:00:00 2001
From: Leo <omarleopaz@hotmail.com>
Date: Fri, 6 Feb 2026 17:12:23 -0800
Subject: [PATCH 02/20] refactor(marketing): centralize analytics track calls

---
 .../src/app/components/CTAButtons/HeaderCTA.tsx       |  6 +++---
 .../app/components/DownloadButton/DownloadButton.tsx  | 10 +++++-----
 apps/marketing/src/lib/analytics/index.ts             | 11 +++++++++++
 3 files changed, 19 insertions(+), 8 deletions(-)
 create mode 100644 apps/marketing/src/lib/analytics/index.ts

diff --git a/apps/marketing/src/app/components/CTAButtons/HeaderCTA.tsx b/apps/marketing/src/app/components/CTAButtons/HeaderCTA.tsx
index c56ab7a3e1f..95876019dad 100644
--- a/apps/marketing/src/app/components/CTAButtons/HeaderCTA.tsx
+++ b/apps/marketing/src/app/components/CTAButtons/HeaderCTA.tsx
@@ -2,10 +2,10 @@
 
 import { DOWNLOAD_URL_MAC_ARM64 } from "@superset/shared/constants";
 import { Download } from "lucide-react";
-import posthog from "posthog-js";
 import { useEffect, useRef, useState } from "react";
 import { createPortal } from "react-dom";
 import { HiMiniClock } from "react-icons/hi2";
+import { track } from "@/lib/analytics";
 import { usePlatform } from "../../hooks/useOS";
 import { DownloadButton } from "../DownloadButton";
 import { WaitlistModal } from "../WaitlistModal";
@@ -65,7 +65,7 @@ export function HeaderCTA({ isLoggedIn, dashboardUrl }: HeaderCTAProps) {
 				<a
 					href={DOWNLOAD_URL_MAC_ARM64}
 					className="px-4 py-2 text-sm font-normal bg-foreground text-background hover:bg-foreground/90 transition-colors flex items-center justify-center gap-2"
-					onClick={() => posthog.capture("download_clicked")}
+					onClick={() => track("download_clicked")}
 				>
 					Download for macOS
 					<Download className="size-4" aria-hidden="true" />
@@ -75,7 +75,7 @@ export function HeaderCTA({ isLoggedIn, dashboardUrl }: HeaderCTAProps) {
 					type="button"
 					className="px-4 py-2 text-sm font-normal bg-foreground text-background hover:bg-foreground/90 transition-colors flex items-center justify-center gap-2"
 					onClick={() => {
-						posthog.capture("waitlist_clicked");
+						track("waitlist_clicked");
 						setIsWaitlistOpen(true);
 					}}
 				>
diff --git a/apps/marketing/src/app/components/DownloadButton/DownloadButton.tsx b/apps/marketing/src/app/components/DownloadButton/DownloadButton.tsx
index 0b4a95cb689..ab70b0621d0 100644
--- a/apps/marketing/src/app/components/DownloadButton/DownloadButton.tsx
+++ b/apps/marketing/src/app/components/DownloadButton/DownloadButton.tsx
@@ -1,8 +1,8 @@
 "use client";
 
 import { COMPANY, DOWNLOAD_URL_MAC_ARM64 } from "@superset/shared/constants";
-import posthog from "posthog-js";
 import { HiMiniArrowDownTray, HiMiniClock } from "react-icons/hi2";
+import { track } from "@/lib/analytics";
 import { usePlatform } from "../../hooks/useOS";
 import { type DropdownSection, PlatformDropdown } from "../PlatformDropdown";
 
@@ -64,7 +64,7 @@ export function DownloadButton({
 						description: "APPLE SILICON",
 						icon: appleIcon,
 						onClick: () => {
-							posthog.capture("download_clicked");
+							track("download_clicked");
 							window.open(DOWNLOAD_URL_MAC_ARM64, "_blank");
 						},
 						variant: "primary",
@@ -79,7 +79,7 @@ export function DownloadButton({
 						label: "Join waitlist for Windows & Linux",
 						icon: <HiMiniClock className="size-4" />,
 						onClick: () => {
-							posthog.capture("waitlist_clicked");
+							track("waitlist_clicked");
 							onJoinWaitlist?.();
 						},
 					},
@@ -111,7 +111,7 @@ export function DownloadButton({
 				type="button"
 				className={buttonClasses}
 				onClick={() => {
-					posthog.capture("download_clicked");
+					track("download_clicked");
 					window.open(DOWNLOAD_URL_MAC_ARM64, "_blank");
 				}}
 			>
@@ -127,7 +127,7 @@ export function DownloadButton({
 			type="button"
 			className={buttonClasses}
 			onClick={() => {
-				posthog.capture("waitlist_clicked");
+				track("waitlist_clicked");
 				onJoinWaitlist?.();
 			}}
 		>
diff --git a/apps/marketing/src/lib/analytics/index.ts b/apps/marketing/src/lib/analytics/index.ts
new file mode 100644
index 00000000000..c7ff01bc052
--- /dev/null
+++ b/apps/marketing/src/lib/analytics/index.ts
@@ -0,0 +1,11 @@
+import posthog from "posthog-js";
+
+import { getOutlit } from "@/lib/outlit";
+
+export function track(
+	event: string,
+	properties?: Record<string, unknown>,
+): void {
+	posthog.capture(event, properties);
+	getOutlit()?.track(event, properties);
+}

From e67ab6ad226ac77bb0f69dc3c514ee6440d8a691 Mon Sep 17 00:00:00 2001
From: Leo <omarleopaz@hotmail.com>
Date: Fri, 6 Feb 2026 17:14:30 -0800
Subject: [PATCH 03/20] feat(docs): add Outlit SDK for cross-domain pageview
 tracking

---
 apps/docs/package.json          |  1 +
 apps/docs/src/app/layout.tsx    | 15 +++++++++------
 apps/docs/src/app/providers.tsx | 19 +++++++++++++++++++
 apps/docs/src/env.ts            |  2 ++
 bun.lock                        |  1 +
 5 files changed, 32 insertions(+), 6 deletions(-)
 create mode 100644 apps/docs/src/app/providers.tsx

diff --git a/apps/docs/package.json b/apps/docs/package.json
index ab9a6032164..bbc3ccd15f5 100644
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -11,6 +11,7 @@
 		"postinstall": "fumadocs-mdx"
 	},
 	"dependencies": {
+		"@outlit/browser": "^1.2.0",
 		"@radix-ui/react-collapsible": "^1.1.12",
 		"@radix-ui/react-scroll-area": "^1.2.10",
 		"@sentry/nextjs": "^10.36.0",
diff --git a/apps/docs/src/app/layout.tsx b/apps/docs/src/app/layout.tsx
index ed4f3b8ddf2..330ab4a4539 100644
--- a/apps/docs/src/app/layout.tsx
+++ b/apps/docs/src/app/layout.tsx
@@ -5,6 +5,7 @@ import { COMPANY } from "@superset/shared/constants";
 import { Inter } from "next/font/google";
 import { NavigationBar } from "@/app/components/NavigationBar";
 import { NavbarProvider } from "@/app/components/NavigationBar/components/NavigationMobile";
+import { OutlitProviderWrapper } from "@/app/providers";
 
 const inter = Inter({
 	subsets: ["latin"],
@@ -67,12 +68,14 @@ export default function Layout({ children }: LayoutProps<"/">) {
 			suppressHydrationWarning
 		>
 			<body className="flex flex-col min-h-screen overscroll-none">
-				<RootProvider>
-					<NavbarProvider>
-						<NavigationBar />
-						{children}
-					</NavbarProvider>
-				</RootProvider>
+				<OutlitProviderWrapper>
+					<RootProvider>
+						<NavbarProvider>
+							<NavigationBar />
+							{children}
+						</NavbarProvider>
+					</RootProvider>
+				</OutlitProviderWrapper>
 			</body>
 		</html>
 	);
diff --git a/apps/docs/src/app/providers.tsx b/apps/docs/src/app/providers.tsx
new file mode 100644
index 00000000000..12c7be35681
--- /dev/null
+++ b/apps/docs/src/app/providers.tsx
@@ -0,0 +1,19 @@
+"use client";
+
+import { OutlitProvider } from "@outlit/browser/react";
+
+import { env } from "@/env";
+
+export function OutlitProviderWrapper({
+	children,
+}: {
+	children: React.ReactNode;
+}) {
+	if (!env.NEXT_PUBLIC_OUTLIT_KEY) return <>{children}</>;
+
+	return (
+		<OutlitProvider publicKey={env.NEXT_PUBLIC_OUTLIT_KEY} trackPageviews>
+			{children}
+		</OutlitProvider>
+	);
+}
diff --git a/apps/docs/src/env.ts b/apps/docs/src/env.ts
index 8d77771cccd..d972eb3072c 100644
--- a/apps/docs/src/env.ts
+++ b/apps/docs/src/env.ts
@@ -21,6 +21,7 @@ export const env = createEnv({
 
 	client: {
 		NEXT_PUBLIC_MARKETING_URL: z.string().url().optional(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
 		NEXT_PUBLIC_POSTHOG_KEY: z.string().optional(),
 		NEXT_PUBLIC_POSTHOG_HOST: z.string().url().optional(),
 		NEXT_PUBLIC_SENTRY_DSN_DOCS: z.string().optional(),
@@ -32,6 +33,7 @@ export const env = createEnv({
 	experimental__runtimeEnv: {
 		NODE_ENV: process.env.NODE_ENV,
 		NEXT_PUBLIC_MARKETING_URL: process.env.NEXT_PUBLIC_MARKETING_URL,
+		NEXT_PUBLIC_OUTLIT_KEY: process.env.NEXT_PUBLIC_OUTLIT_KEY,
 		NEXT_PUBLIC_POSTHOG_KEY: process.env.NEXT_PUBLIC_POSTHOG_KEY,
 		NEXT_PUBLIC_POSTHOG_HOST: process.env.NEXT_PUBLIC_POSTHOG_HOST,
 		NEXT_PUBLIC_SENTRY_DSN_DOCS: process.env.NEXT_PUBLIC_SENTRY_DSN_DOCS,
diff --git a/bun.lock b/bun.lock
index 85598b0ab1e..c5c79501db6 100644
--- a/bun.lock
+++ b/bun.lock
@@ -282,6 +282,7 @@
       "name": "@superset/docs",
       "version": "0.0.0",
       "dependencies": {
+        "@outlit/browser": "^1.2.0",
         "@radix-ui/react-collapsible": "^1.1.12",
         "@radix-ui/react-scroll-area": "^1.2.10",
         "@sentry/nextjs": "^10.36.0",

From 51626ebf539219a251c8b19e1b00515196e2b480 Mon Sep 17 00:00:00 2001
From: Leo <omarleopaz@hotmail.com>
Date: Fri, 6 Feb 2026 17:15:57 -0800
Subject: [PATCH 04/20] feat(web): add Outlit SDK with authenticated user
 identity

---
 apps/web/package.json          |  1 +
 apps/web/src/app/providers.tsx | 40 +++++++++++++++++++++++-----------
 apps/web/src/env.ts            |  2 ++
 bun.lock                       |  1 +
 4 files changed, 31 insertions(+), 13 deletions(-)

diff --git a/apps/web/package.json b/apps/web/package.json
index 215b9018723..aa0bcd0e79f 100644
--- a/apps/web/package.json
+++ b/apps/web/package.json
@@ -11,6 +11,7 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"dependencies": {
+		"@outlit/browser": "^1.2.0",
 		"@sentry/nextjs": "^10.36.0",
 		"@superset/auth": "workspace:*",
 		"@superset/db": "workspace:*",
diff --git a/apps/web/src/app/providers.tsx b/apps/web/src/app/providers.tsx
index 5b0348e1382..9a8b461428c 100644
--- a/apps/web/src/app/providers.tsx
+++ b/apps/web/src/app/providers.tsx
@@ -1,5 +1,7 @@
 "use client";
 
+import { OutlitProvider } from "@outlit/browser/react";
+import { authClient } from "@superset/auth/client";
 import { THEME_STORAGE_KEY } from "@superset/shared/constants";
 import { ReactQueryDevtools } from "@tanstack/react-query-devtools";
 import { ThemeProvider } from "next-themes";
@@ -7,25 +9,37 @@ import posthog from "posthog-js";
 import { PostHogProvider } from "posthog-js/react";
 
 import { PostHogUserIdentifier } from "@/components/PostHogUserIdentifier";
+import { env } from "@/env";
 
 import { TRPCReactProvider } from "../trpc/react";
 
 export function Providers({ children }: { children: React.ReactNode }) {
+	const { data: session } = authClient.useSession();
+	const user = session?.user;
+
 	return (
 		<PostHogProvider client={posthog}>
-			<TRPCReactProvider>
-				<ThemeProvider
-					attribute="class"
-					defaultTheme="dark"
-					forcedTheme="dark"
-					storageKey={THEME_STORAGE_KEY}
-					disableTransitionOnChange
-				>
-					<PostHogUserIdentifier />
-					{children}
-					<ReactQueryDevtools initialIsOpen={false} />
-				</ThemeProvider>
-			</TRPCReactProvider>
+			<OutlitProvider
+				publicKey={env.NEXT_PUBLIC_OUTLIT_KEY ?? ""}
+				trackPageviews
+				user={
+					user ? { email: user.email, userId: user.id, name: user.name } : null
+				}
+			>
+				<TRPCReactProvider>
+					<ThemeProvider
+						attribute="class"
+						defaultTheme="dark"
+						forcedTheme="dark"
+						storageKey={THEME_STORAGE_KEY}
+						disableTransitionOnChange
+					>
+						<PostHogUserIdentifier />
+						{children}
+						<ReactQueryDevtools initialIsOpen={false} />
+					</ThemeProvider>
+				</TRPCReactProvider>
+			</OutlitProvider>
 		</PostHogProvider>
 	);
 }
diff --git a/apps/web/src/env.ts b/apps/web/src/env.ts
index 532154fe5b1..cd2c98944c0 100644
--- a/apps/web/src/env.ts
+++ b/apps/web/src/env.ts
@@ -36,6 +36,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_SENTRY_ENVIRONMENT: z
 			.enum(["development", "preview", "production"])
 			.optional(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
 	},
 
 	experimental__runtimeEnv: {
@@ -48,6 +49,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_POSTHOG_HOST: process.env.NEXT_PUBLIC_POSTHOG_HOST,
 		NEXT_PUBLIC_SENTRY_DSN_WEB: process.env.NEXT_PUBLIC_SENTRY_DSN_WEB,
 		NEXT_PUBLIC_SENTRY_ENVIRONMENT: process.env.NEXT_PUBLIC_SENTRY_ENVIRONMENT,
+		NEXT_PUBLIC_OUTLIT_KEY: process.env.NEXT_PUBLIC_OUTLIT_KEY,
 	},
 
 	skipValidation: !!process.env.SKIP_ENV_VALIDATION,
diff --git a/bun.lock b/bun.lock
index c5c79501db6..46f0ea81b4e 100644
--- a/bun.lock
+++ b/bun.lock
@@ -484,6 +484,7 @@
       "name": "@superset/web",
       "version": "0.1.0",
       "dependencies": {
+        "@outlit/browser": "^1.2.0",
         "@sentry/nextjs": "^10.36.0",
         "@superset/auth": "workspace:*",
         "@superset/db": "workspace:*",

From 1deca92f264322962fdbad5d432ce646da158f58 Mon Sep 17 00:00:00 2001
From: Leo <omarleopaz@hotmail.com>
Date: Fri, 6 Feb 2026 17:19:21 -0800
Subject: [PATCH 05/20] feat(desktop): add Outlit SDK to renderer with
 analytics wrapper and consent

---
 apps/desktop/package.json                     |  1 +
 .../renderer/components/Paywall/Paywall.tsx   | 10 +++---
 .../PostHogUserIdentifier.tsx                 |  4 +--
 .../TelemetrySync/TelemetrySync.tsx           |  6 ++++
 apps/desktop/src/renderer/env.renderer.ts     |  4 +++
 apps/desktop/src/renderer/index.tsx           |  4 +++
 .../src/renderer/lib/analytics/index.ts       | 10 ++++++
 apps/desktop/src/renderer/lib/outlit/index.ts | 19 ++++++++++
 .../PostHogProvider/PostHogProvider.tsx       |  3 +-
 apps/desktop/src/renderer/routes/-layout.tsx  | 36 +++++++++++++------
 .../src/renderer/routes/sign-in/page.tsx      |  4 +--
 bun.lock                                      |  1 +
 12 files changed, 81 insertions(+), 21 deletions(-)
 create mode 100644 apps/desktop/src/renderer/lib/analytics/index.ts
 create mode 100644 apps/desktop/src/renderer/lib/outlit/index.ts

diff --git a/apps/desktop/package.json b/apps/desktop/package.json
index c349cf1ee4e..89bf9e0b584 100644
--- a/apps/desktop/package.json
+++ b/apps/desktop/package.json
@@ -45,6 +45,7 @@
 		"@headless-tree/react": "^1.6.3",
 		"@hookform/resolvers": "^5.2.2",
 		"@monaco-editor/react": "^4.7.0",
+		"@outlit/browser": "^1.2.0",
 		"@pierre/diffs": "^1.0.10",
 		"@radix-ui/react-dialog": "^1.1.15",
 		"@radix-ui/react-label": "^2.1.8",
diff --git a/apps/desktop/src/renderer/components/Paywall/Paywall.tsx b/apps/desktop/src/renderer/components/Paywall/Paywall.tsx
index 945b3151d43..3aba9b61e77 100644
--- a/apps/desktop/src/renderer/components/Paywall/Paywall.tsx
+++ b/apps/desktop/src/renderer/components/Paywall/Paywall.tsx
@@ -2,7 +2,7 @@ import { Button } from "@superset/ui/button";
 import { Dialog, DialogContent } from "@superset/ui/dialog";
 import { useNavigate } from "@tanstack/react-router";
 import { useEffect, useRef, useState } from "react";
-import { posthog } from "../../lib/posthog";
+import { track } from "renderer/lib/analytics";
 import { FeaturePreview } from "./components/FeaturePreview";
 import { FeatureSidebar } from "./components/FeatureSidebar";
 import type { GatedFeature } from "./constants";
@@ -51,7 +51,7 @@ export const Paywall = () => {
 			featuresViewedRef.current = new Set([initialFeatureId]);
 
 			const feature = PRO_FEATURES.find((f) => f.id === initialFeatureId);
-			posthog.capture("paywall_opened", {
+			track("paywall_opened", {
 				trigger_source: paywallOptions.feature,
 				feature_id: initialFeatureId,
 				feature_title: feature?.title,
@@ -72,7 +72,7 @@ export const Paywall = () => {
 	const handleSelectFeature = (featureId: string) => {
 		if (featureId !== selectedFeatureId) {
 			const feature = PRO_FEATURES.find((f) => f.id === featureId);
-			posthog.capture("paywall_feature_clicked", {
+			track("paywall_feature_clicked", {
 				trigger_source: triggerSource,
 				feature_id: featureId,
 				feature_title: feature?.title,
@@ -88,7 +88,7 @@ export const Paywall = () => {
 			const timeSpent = openTimeRef.current
 				? Date.now() - openTimeRef.current
 				: 0;
-			posthog.capture("paywall_cancelled", {
+			track("paywall_cancelled", {
 				trigger_source: triggerSource,
 				feature_id: selectedFeatureId,
 				features_viewed_count: featuresViewedRef.current.size,
@@ -109,7 +109,7 @@ export const Paywall = () => {
 		const timeSpent = openTimeRef.current
 			? Date.now() - openTimeRef.current
 			: 0;
-		posthog.capture("paywall_upgrade_clicked", {
+		track("paywall_upgrade_clicked", {
 			trigger_source: triggerSource,
 			feature_id: selectedFeatureId,
 			feature_title: selectedFeature.title,
diff --git a/apps/desktop/src/renderer/components/PostHogUserIdentifier/PostHogUserIdentifier.tsx b/apps/desktop/src/renderer/components/PostHogUserIdentifier/PostHogUserIdentifier.tsx
index a050a86115f..0e9cfb0e149 100644
--- a/apps/desktop/src/renderer/components/PostHogUserIdentifier/PostHogUserIdentifier.tsx
+++ b/apps/desktop/src/renderer/components/PostHogUserIdentifier/PostHogUserIdentifier.tsx
@@ -1,7 +1,7 @@
 import { useEffect } from "react";
+import { track } from "renderer/lib/analytics";
 import { authClient } from "renderer/lib/auth-client";
 import { electronTrpc } from "renderer/lib/electron-trpc";
-
 import { posthog } from "../../lib/posthog";
 
 const AUTH_COMPLETED_KEY = "superset_auth_completed";
@@ -23,7 +23,7 @@ export function PostHogUserIdentifier() {
 
 			const trackedUserId = localStorage.getItem(AUTH_COMPLETED_KEY);
 			if (trackedUserId !== user.id) {
-				posthog.capture("auth_completed");
+				track("auth_completed");
 				localStorage.setItem(AUTH_COMPLETED_KEY, user.id);
 			}
 		} else if (session !== undefined && !user) {
diff --git a/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx b/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx
index 4bbb7b27e29..58d8f2d33ef 100644
--- a/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx
+++ b/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx
@@ -1,5 +1,6 @@
 import { useEffect } from "react";
 import { electronTrpc } from "renderer/lib/electron-trpc";
+import { getOutlit } from "renderer/lib/outlit";
 import { posthog } from "renderer/lib/posthog";
 
 export function TelemetrySync() {
@@ -19,6 +20,11 @@ export function TelemetrySync() {
 					posthog.opt_out_capturing();
 				}
 			}
+
+			const outlit = getOutlit();
+			if (outlit && telemetryEnabled) {
+				outlit.enableTracking();
+			}
 		} catch (error) {
 			console.error(
 				"[telemetry-sync] Failed to update telemetry state:",
diff --git a/apps/desktop/src/renderer/env.renderer.ts b/apps/desktop/src/renderer/env.renderer.ts
index 0e41dea4a6e..52c23249a67 100644
--- a/apps/desktop/src/renderer/env.renderer.ts
+++ b/apps/desktop/src/renderer/env.renderer.ts
@@ -19,6 +19,7 @@ const envSchema = z.object({
 	NEXT_PUBLIC_WEB_URL: z.url().default("https://app.superset.sh"),
 	NEXT_PUBLIC_POSTHOG_KEY: z.string().optional(),
 	NEXT_PUBLIC_POSTHOG_HOST: z.string().default("https://us.i.posthog.com"),
+	NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
 	SENTRY_DSN_DESKTOP: z.string().optional(),
 });
 
@@ -39,6 +40,9 @@ const rawEnv = {
 	NEXT_PUBLIC_POSTHOG_HOST: import.meta.env.NEXT_PUBLIC_POSTHOG_HOST as
 		| string
 		| undefined,
+	NEXT_PUBLIC_OUTLIT_KEY: import.meta.env.NEXT_PUBLIC_OUTLIT_KEY as
+		| string
+		| undefined,
 	SENTRY_DSN_DESKTOP: import.meta.env.SENTRY_DSN_DESKTOP as string | undefined,
 };
 
diff --git a/apps/desktop/src/renderer/index.tsx b/apps/desktop/src/renderer/index.tsx
index f636d9f3341..51d08d9b78e 100644
--- a/apps/desktop/src/renderer/index.tsx
+++ b/apps/desktop/src/renderer/index.tsx
@@ -12,6 +12,7 @@ import {
 	markBootMounted,
 	reportBootError,
 } from "./lib/boot-errors";
+import { getOutlit } from "./lib/outlit";
 import { persistentHistory } from "./lib/persistent-hash-history";
 import { posthog } from "./lib/posthog";
 import { electronQueryClient } from "./providers/ElectronTRPCProvider";
@@ -35,6 +36,9 @@ const unsubscribe = router.subscribe("onResolved", (event) => {
 	posthog.capture("$pageview", {
 		$current_url: event.toLocation.pathname,
 	});
+	getOutlit()?.track("pageview", {
+		url: event.toLocation.pathname,
+	});
 });
 
 const handleDeepLink = (path: string) => {
diff --git a/apps/desktop/src/renderer/lib/analytics/index.ts b/apps/desktop/src/renderer/lib/analytics/index.ts
new file mode 100644
index 00000000000..c558b250baf
--- /dev/null
+++ b/apps/desktop/src/renderer/lib/analytics/index.ts
@@ -0,0 +1,10 @@
+import { getOutlit } from "renderer/lib/outlit";
+import { posthog } from "renderer/lib/posthog";
+
+export function track(
+	event: string,
+	properties?: Record<string, unknown>,
+): void {
+	posthog.capture(event, properties);
+	getOutlit()?.track(event, properties);
+}
diff --git a/apps/desktop/src/renderer/lib/outlit/index.ts b/apps/desktop/src/renderer/lib/outlit/index.ts
new file mode 100644
index 00000000000..2b4966d4e4b
--- /dev/null
+++ b/apps/desktop/src/renderer/lib/outlit/index.ts
@@ -0,0 +1,19 @@
+import { Outlit } from "@outlit/browser";
+import { env } from "renderer/env.renderer";
+
+let outlit: Outlit | null = null;
+
+export function getOutlit(): Outlit | null {
+	if (!env.NEXT_PUBLIC_OUTLIT_KEY) return null;
+
+	if (!outlit) {
+		outlit = new Outlit({
+			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
+			trackPageviews: false,
+			autoTrack: true,
+		});
+	}
+	return outlit;
+}
+
+export { outlit };
diff --git a/apps/desktop/src/renderer/providers/PostHogProvider/PostHogProvider.tsx b/apps/desktop/src/renderer/providers/PostHogProvider/PostHogProvider.tsx
index 985421d5e7c..29a2dcaecce 100644
--- a/apps/desktop/src/renderer/providers/PostHogProvider/PostHogProvider.tsx
+++ b/apps/desktop/src/renderer/providers/PostHogProvider/PostHogProvider.tsx
@@ -1,6 +1,7 @@
 import { PostHogProvider as PHProvider } from "posthog-js/react";
 import type React from "react";
 import { useEffect, useState } from "react";
+import { track } from "renderer/lib/analytics";
 import { initPostHog, posthog } from "renderer/lib/posthog";
 
 interface PostHogProviderProps {
@@ -13,7 +14,7 @@ export function PostHogProvider({ children }: PostHogProviderProps) {
 	useEffect(() => {
 		try {
 			initPostHog();
-			posthog.capture("desktop_opened");
+			track("desktop_opened");
 		} catch (error) {
 			console.error("[posthog] Failed to initialize:", error);
 		} finally {
diff --git a/apps/desktop/src/renderer/routes/-layout.tsx b/apps/desktop/src/renderer/routes/-layout.tsx
index 630b49d7722..0245e28a641 100644
--- a/apps/desktop/src/renderer/routes/-layout.tsx
+++ b/apps/desktop/src/renderer/routes/-layout.tsx
@@ -1,27 +1,41 @@
+import { OutlitProvider } from "@outlit/browser/react";
 import { Alerter } from "@superset/ui/atoms/Alert";
 import type { ReactNode } from "react";
 import { PostHogUserIdentifier } from "renderer/components/PostHogUserIdentifier";
 import { TelemetrySync } from "renderer/components/TelemetrySync";
 import { ThemedToaster } from "renderer/components/ThemedToaster";
+import { env } from "renderer/env.renderer";
+import { authClient } from "renderer/lib/auth-client";
 import { AuthProvider } from "renderer/providers/AuthProvider";
 import { ElectronTRPCProvider } from "renderer/providers/ElectronTRPCProvider";
 import { MonacoProvider } from "renderer/providers/MonacoProvider";
 import { PostHogProvider } from "renderer/providers/PostHogProvider";
 
 export function RootLayout({ children }: { children: ReactNode }) {
+	const { data: session } = authClient.useSession();
+	const user = session?.user;
+
 	return (
 		<PostHogProvider>
-			<ElectronTRPCProvider>
-				<PostHogUserIdentifier />
-				<TelemetrySync />
-				<AuthProvider>
-					<MonacoProvider>
-						{children}
-						<ThemedToaster />
-						<Alerter />
-					</MonacoProvider>
-				</AuthProvider>
-			</ElectronTRPCProvider>
+			<OutlitProvider
+				publicKey={env.NEXT_PUBLIC_OUTLIT_KEY ?? ""}
+				trackPageviews={false}
+				user={
+					user ? { email: user.email, userId: user.id, name: user.name } : null
+				}
+			>
+				<ElectronTRPCProvider>
+					<PostHogUserIdentifier />
+					<TelemetrySync />
+					<AuthProvider>
+						<MonacoProvider>
+							{children}
+							<ThemedToaster />
+							<Alerter />
+						</MonacoProvider>
+					</AuthProvider>
+				</ElectronTRPCProvider>
+			</OutlitProvider>
 		</PostHogProvider>
 	);
 }
diff --git a/apps/desktop/src/renderer/routes/sign-in/page.tsx b/apps/desktop/src/renderer/routes/sign-in/page.tsx
index b1679314e82..2a3fe8193ed 100644
--- a/apps/desktop/src/renderer/routes/sign-in/page.tsx
+++ b/apps/desktop/src/renderer/routes/sign-in/page.tsx
@@ -5,9 +5,9 @@ import { createFileRoute, Navigate } from "@tanstack/react-router";
 import { FaGithub } from "react-icons/fa";
 import { FcGoogle } from "react-icons/fc";
 import { env } from "renderer/env.renderer";
+import { track } from "renderer/lib/analytics";
 import { authClient } from "renderer/lib/auth-client";
 import { electronTrpc } from "renderer/lib/electron-trpc";
-import { posthog } from "renderer/lib/posthog";
 import { SupersetLogo } from "./components/SupersetLogo";
 
 export const Route = createFileRoute("/sign-in/")({
@@ -38,7 +38,7 @@ function SignInPage() {
 	}
 
 	const signIn = (provider: AuthProvider) => {
-		posthog.capture("auth_started", { provider });
+		track("auth_started", { provider });
 		signInMutation.mutate({ provider });
 	};
 
diff --git a/bun.lock b/bun.lock
index 46f0ea81b4e..66c04a94391 100644
--- a/bun.lock
+++ b/bun.lock
@@ -117,6 +117,7 @@
         "@headless-tree/react": "^1.6.3",
         "@hookform/resolvers": "^5.2.2",
         "@monaco-editor/react": "^4.7.0",
+        "@outlit/browser": "^1.2.0",
         "@pierre/diffs": "^1.0.10",
         "@radix-ui/react-dialog": "^1.1.15",
         "@radix-ui/react-label": "^2.1.8",

From d4aac0fa6e8c14babb271fbb867059d586786ba0 Mon Sep 17 00:00:00 2001
From: Leo <omarleopaz@hotmail.com>
Date: Fri, 6 Feb 2026 17:24:17 -0800
Subject: [PATCH 06/20] feat(desktop): add @outlit/node to main process with
 user.activate on project_opened

---
 apps/desktop/package.json                    |  1 +
 apps/desktop/src/main/env.main.ts            |  4 ++++
 apps/desktop/src/main/index.ts               |  3 +++
 apps/desktop/src/main/lib/analytics/index.ts | 22 ++++++++++++++++++++
 apps/desktop/src/main/lib/outlit/index.ts    | 22 ++++++++++++++++++++
 bun.lock                                     |  3 +++
 6 files changed, 55 insertions(+)
 create mode 100644 apps/desktop/src/main/lib/outlit/index.ts

diff --git a/apps/desktop/package.json b/apps/desktop/package.json
index 89bf9e0b584..d75b67856dc 100644
--- a/apps/desktop/package.json
+++ b/apps/desktop/package.json
@@ -46,6 +46,7 @@
 		"@hookform/resolvers": "^5.2.2",
 		"@monaco-editor/react": "^4.7.0",
 		"@outlit/browser": "^1.2.0",
+		"@outlit/node": "^1.1.0",
 		"@pierre/diffs": "^1.0.10",
 		"@radix-ui/react-dialog": "^1.1.15",
 		"@radix-ui/react-label": "^2.1.8",
diff --git a/apps/desktop/src/main/env.main.ts b/apps/desktop/src/main/env.main.ts
index e954c2ad214..06c573ffc69 100644
--- a/apps/desktop/src/main/env.main.ts
+++ b/apps/desktop/src/main/env.main.ts
@@ -20,6 +20,8 @@ export const env = createEnv({
 		NEXT_PUBLIC_POSTHOG_KEY: z.string().optional(),
 		NEXT_PUBLIC_POSTHOG_HOST: z.string().default("https://us.i.posthog.com"),
 		SENTRY_DSN_DESKTOP: z.string().optional(),
+		STREAMS_URL: z.url().default("https://superset-stream.fly.dev"),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
 	},
 
 	runtimeEnv: {
@@ -33,6 +35,8 @@ export const env = createEnv({
 		NEXT_PUBLIC_POSTHOG_KEY: process.env.NEXT_PUBLIC_POSTHOG_KEY,
 		NEXT_PUBLIC_POSTHOG_HOST: process.env.NEXT_PUBLIC_POSTHOG_HOST,
 		SENTRY_DSN_DESKTOP: process.env.SENTRY_DSN_DESKTOP,
+		STREAMS_URL: process.env.STREAMS_URL,
+		NEXT_PUBLIC_OUTLIT_KEY: process.env.NEXT_PUBLIC_OUTLIT_KEY,
 	},
 	emptyStringAsUndefined: true,
 	// Only allow skipping validation in development (never in production)
diff --git a/apps/desktop/src/main/index.ts b/apps/desktop/src/main/index.ts
index 691fce75dd8..59e85e4af26 100644
--- a/apps/desktop/src/main/index.ts
+++ b/apps/desktop/src/main/index.ts
@@ -13,6 +13,7 @@ import { setupAgentHooks } from "./lib/agent-setup";
 import { initAppState } from "./lib/app-state";
 import { setupAutoUpdater } from "./lib/auto-updater";
 import { localDb } from "./lib/local-db";
+import { outlit } from "./lib/outlit";
 import { ensureProjectIconsDir, getProjectIconPath } from "./lib/project-icons";
 import { initSentry } from "./lib/sentry";
 import { reconcileDaemonSessions } from "./lib/terminal";
@@ -139,7 +140,9 @@ app.on("before-quit", async (event) => {
 		}
 	}
 
+	// Quit confirmed or no confirmation needed - flush analytics and exit
 	isQuitting = true;
+	await outlit.shutdown();
 	disposeTray();
 	app.exit(0);
 });
diff --git a/apps/desktop/src/main/lib/analytics/index.ts b/apps/desktop/src/main/lib/analytics/index.ts
index a81044fee55..3c6a071f150 100644
--- a/apps/desktop/src/main/lib/analytics/index.ts
+++ b/apps/desktop/src/main/lib/analytics/index.ts
@@ -1,5 +1,6 @@
 import { app } from "electron";
 import { env } from "main/env.main";
+import { getOutlit } from "main/lib/outlit";
 import { PostHog } from "posthog-node";
 import { DEFAULT_TELEMETRY_ENABLED } from "shared/constants";
 
@@ -49,4 +50,25 @@ export function track(
 			desktop_version: app.getVersion(),
 		},
 	});
+
+	// Outlit tracking
+	try {
+		const outlit = getOutlit();
+		if (outlit) {
+			outlit.track({
+				eventName: event,
+				userId,
+				properties: properties as
+					| Record<string, string | number | boolean | null>
+					| undefined,
+			});
+
+			// Fire user.activate() on project_opened (activation moment)
+			if (event === "project_opened") {
+				outlit.user.activate({ userId });
+			}
+		}
+	} catch (error) {
+		console.error("[analytics/outlit] Failed to track:", error);
+	}
 }
diff --git a/apps/desktop/src/main/lib/outlit/index.ts b/apps/desktop/src/main/lib/outlit/index.ts
new file mode 100644
index 00000000000..75fbb3ee7b6
--- /dev/null
+++ b/apps/desktop/src/main/lib/outlit/index.ts
@@ -0,0 +1,22 @@
+import { Outlit } from "@outlit/node";
+import { env } from "main/env.main";
+
+let outlit: Outlit | null = null;
+
+export function getOutlit(): Outlit | null {
+	if (!env.NEXT_PUBLIC_OUTLIT_KEY) return null;
+
+	if (!outlit) {
+		outlit = new Outlit({
+			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
+		});
+	}
+	return outlit;
+}
+
+export async function shutdownOutlit(): Promise<void> {
+	if (outlit) {
+		await outlit.shutdown();
+		outlit = null;
+	}
+}
diff --git a/bun.lock b/bun.lock
index 66c04a94391..f228fc49cd1 100644
--- a/bun.lock
+++ b/bun.lock
@@ -118,6 +118,7 @@
         "@hookform/resolvers": "^5.2.2",
         "@monaco-editor/react": "^4.7.0",
         "@outlit/browser": "^1.2.0",
+        "@outlit/node": "^1.1.0",
         "@pierre/diffs": "^1.0.10",
         "@radix-ui/react-dialog": "^1.1.15",
         "@radix-ui/react-label": "^2.1.8",
@@ -1525,6 +1526,8 @@
 
     "@outlit/core": ["@outlit/core@1.1.0", "", {}, "sha512-TNM9cIdunfcF0TLwCzSJ7sZWmDhUF8oYt4Q1KgW5Fm+4KGsfjDUbGDq9svrml1cmPrAXTZdiYwIYdRAG9327/g=="],
 
+    "@outlit/node": ["@outlit/node@1.1.0", "", { "dependencies": { "@outlit/core": "1.1.0" } }, "sha512-iIw4P+NK6/gXXOqTzZpK6Hlf4mBdoPUYOWwfSbxIbFI6gCXiFO83eOfMTfmTnnEncX2KpZ34XlyfarRxuLcm4Q=="],
+
     "@pierre/diffs": ["@pierre/diffs@1.0.10", "", { "dependencies": { "@shikijs/core": "^3.0.0", "@shikijs/engine-javascript": "^3.0.0", "@shikijs/transformers": "^3.0.0", "diff": "8.0.3", "hast-util-to-html": "9.0.5", "lru_map": "0.4.1", "shiki": "^3.0.0" }, "peerDependencies": { "react": "^18.3.1 || ^19.0.0", "react-dom": "^18.3.1 || ^19.0.0" } }, "sha512-ahkpfS30NfaB+PBxnf0/Mc20ySBRTQmM28a7Ojpd0UZixmTyhGhJfBFjvmhX8dSzR22lB3h3OIMMxpB4yYTIOQ=="],
 
     "@pkgjs/parseargs": ["@pkgjs/parseargs@0.11.0", "", {}, "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg=="],

From e3b14b41435fb85778482760ee709d2e44203028 Mon Sep 17 00:00:00 2001
From: Leo <omarleopaz@hotmail.com>
Date: Fri, 6 Feb 2026 17:30:44 -0800
Subject: [PATCH 07/20] chore: add NEXT_PUBLIC_OUTLIT_KEY env config and fix
 type errors

- Add NEXT_PUBLIC_OUTLIT_KEY to .env.example
- Add Outlit key to Vite define blocks (main + renderer)
- Fix UserIdentity type: move name to traits object
- Fix analytics wrapper type: cast properties for Outlit SDK
---
 .env.example                                     | 5 +++++
 apps/desktop/electron.vite.config.ts             | 6 ++++++
 apps/desktop/src/renderer/lib/analytics/index.ts | 5 ++++-
 apps/desktop/src/renderer/routes/-layout.tsx     | 8 +++++++-
 apps/marketing/src/lib/analytics/index.ts        | 5 ++++-
 apps/web/src/app/providers.tsx                   | 8 +++++++-
 6 files changed, 33 insertions(+), 4 deletions(-)

diff --git a/.env.example b/.env.example
index a2c17071d80..405c5a05171 100644
--- a/.env.example
+++ b/.env.example
@@ -60,6 +60,11 @@ NEXT_PUBLIC_POSTHOG_KEY=
 POSTHOG_API_KEY=
 POSTHOG_PROJECT_ID=
 
+# -----------------------------------------------------------------------------
+# Outlit Analytics
+# -----------------------------------------------------------------------------
+NEXT_PUBLIC_OUTLIT_KEY=
+
 # -----------------------------------------------------------------------------
 # Freestyle
 # -----------------------------------------------------------------------------
diff --git a/apps/desktop/electron.vite.config.ts b/apps/desktop/electron.vite.config.ts
index 2dd2d0045fc..76b379f3f41 100644
--- a/apps/desktop/electron.vite.config.ts
+++ b/apps/desktop/electron.vite.config.ts
@@ -87,6 +87,9 @@ export default defineConfig({
 			"process.env.SUPERSET_WORKSPACE_NAME": defineEnv(
 				process.env.SUPERSET_WORKSPACE_NAME,
 			),
+			"process.env.NEXT_PUBLIC_OUTLIT_KEY": defineEnv(
+				process.env.NEXT_PUBLIC_OUTLIT_KEY,
+			),
 		},
 
 		build: {
@@ -184,6 +187,9 @@ export default defineConfig({
 			"process.env.SUPERSET_WORKSPACE_NAME": defineEnv(
 				process.env.SUPERSET_WORKSPACE_NAME,
 			),
+			"import.meta.env.NEXT_PUBLIC_OUTLIT_KEY": defineEnv(
+				process.env.NEXT_PUBLIC_OUTLIT_KEY,
+			),
 		},
 
 		server: {
diff --git a/apps/desktop/src/renderer/lib/analytics/index.ts b/apps/desktop/src/renderer/lib/analytics/index.ts
index c558b250baf..f0a620d452e 100644
--- a/apps/desktop/src/renderer/lib/analytics/index.ts
+++ b/apps/desktop/src/renderer/lib/analytics/index.ts
@@ -6,5 +6,8 @@ export function track(
 	properties?: Record<string, unknown>,
 ): void {
 	posthog.capture(event, properties);
-	getOutlit()?.track(event, properties);
+	getOutlit()?.track(
+		event,
+		properties as Record<string, string | number | boolean | null> | undefined,
+	);
 }
diff --git a/apps/desktop/src/renderer/routes/-layout.tsx b/apps/desktop/src/renderer/routes/-layout.tsx
index 0245e28a641..fdc97dcdb20 100644
--- a/apps/desktop/src/renderer/routes/-layout.tsx
+++ b/apps/desktop/src/renderer/routes/-layout.tsx
@@ -21,7 +21,13 @@ export function RootLayout({ children }: { children: ReactNode }) {
 				publicKey={env.NEXT_PUBLIC_OUTLIT_KEY ?? ""}
 				trackPageviews={false}
 				user={
-					user ? { email: user.email, userId: user.id, name: user.name } : null
+					user
+						? {
+								email: user.email,
+								userId: user.id,
+								traits: { name: user.name },
+							}
+						: null
 				}
 			>
 				<ElectronTRPCProvider>
diff --git a/apps/marketing/src/lib/analytics/index.ts b/apps/marketing/src/lib/analytics/index.ts
index c7ff01bc052..98e769d8a37 100644
--- a/apps/marketing/src/lib/analytics/index.ts
+++ b/apps/marketing/src/lib/analytics/index.ts
@@ -7,5 +7,8 @@ export function track(
 	properties?: Record<string, unknown>,
 ): void {
 	posthog.capture(event, properties);
-	getOutlit()?.track(event, properties);
+	getOutlit()?.track(
+		event,
+		properties as Record<string, string | number | boolean | null> | undefined,
+	);
 }
diff --git a/apps/web/src/app/providers.tsx b/apps/web/src/app/providers.tsx
index 9a8b461428c..7846d0d99fd 100644
--- a/apps/web/src/app/providers.tsx
+++ b/apps/web/src/app/providers.tsx
@@ -23,7 +23,13 @@ export function Providers({ children }: { children: React.ReactNode }) {
 				publicKey={env.NEXT_PUBLIC_OUTLIT_KEY ?? ""}
 				trackPageviews
 				user={
-					user ? { email: user.email, userId: user.id, name: user.name } : null
+					user
+						? {
+								email: user.email,
+								userId: user.id,
+								traits: { name: user.name },
+							}
+						: null
 				}
 			>
 				<TRPCReactProvider>

From 1fc0ff4e247e7e8269e53dc3707c7c91e3bb6859 Mon Sep 17 00:00:00 2001
From: Leo <omarleopaz@hotmail.com>
Date: Sat, 7 Feb 2026 01:34:56 -0800
Subject: [PATCH 08/20] feat: bump @outlit/browser to 1.4.0 with client prop,
 add OutlitProvider wrappers, and wire up consent controls

- Bump @outlit/browser from ^1.2.0 to ^1.4.0 across all apps
- Add OutlitProvider wrapper for desktop (passes singleton via client prop for shared instance + user identity)
- Add OutlitProvider wrapper for web (handles authenticated user identity)
- Wire up disableTracking() in desktop TelemetrySync and marketing CookieConsent
- Restore original comment in desktop main process
---
 apps/desktop/package.json                     |  2 +-
 apps/desktop/src/main/index.ts                |  3 +-
 .../TelemetrySync/TelemetrySync.tsx           | 28 ++++++---------
 .../src/renderer/lib/analytics/index.ts       |  4 ++-
 apps/desktop/src/renderer/lib/outlit/index.ts |  2 --
 .../OutlitProvider/OutlitProvider.tsx         | 35 +++++++++++++++++++
 .../providers/OutlitProvider/index.ts         |  1 +
 apps/desktop/src/renderer/routes/-layout.tsx  | 21 ++---------
 apps/docs/package.json                        |  2 +-
 apps/marketing/package.json                   |  2 +-
 .../CookieConsent/CookieConsent.tsx           |  3 +-
 apps/marketing/src/lib/analytics/index.ts     |  4 ++-
 apps/marketing/src/lib/outlit/index.ts        |  2 --
 apps/web/package.json                         |  2 +-
 apps/web/src/app/providers.tsx                | 21 ++---------
 .../OutlitProvider/OutlitProvider.tsx         | 34 ++++++++++++++++++
 .../src/components/OutlitProvider/index.ts    |  1 +
 bun.lock                                      | 10 +++---
 18 files changed, 104 insertions(+), 73 deletions(-)
 create mode 100644 apps/desktop/src/renderer/providers/OutlitProvider/OutlitProvider.tsx
 create mode 100644 apps/desktop/src/renderer/providers/OutlitProvider/index.ts
 create mode 100644 apps/web/src/components/OutlitProvider/OutlitProvider.tsx
 create mode 100644 apps/web/src/components/OutlitProvider/index.ts

diff --git a/apps/desktop/package.json b/apps/desktop/package.json
index d75b67856dc..05ee9a4e677 100644
--- a/apps/desktop/package.json
+++ b/apps/desktop/package.json
@@ -45,7 +45,7 @@
 		"@headless-tree/react": "^1.6.3",
 		"@hookform/resolvers": "^5.2.2",
 		"@monaco-editor/react": "^4.7.0",
-		"@outlit/browser": "^1.2.0",
+		"@outlit/browser": "^1.4.0",
 		"@outlit/node": "^1.1.0",
 		"@pierre/diffs": "^1.0.10",
 		"@radix-ui/react-dialog": "^1.1.15",
diff --git a/apps/desktop/src/main/index.ts b/apps/desktop/src/main/index.ts
index 59e85e4af26..5b62e38630d 100644
--- a/apps/desktop/src/main/index.ts
+++ b/apps/desktop/src/main/index.ts
@@ -140,7 +140,8 @@ app.on("before-quit", async (event) => {
 		}
 	}
 
-	// Quit confirmed or no confirmation needed - flush analytics and exit
+	// Quit confirmed or no confirmation needed - exit immediately
+	// Let OS clean up child processes, tray, etc.
 	isQuitting = true;
 	await outlit.shutdown();
 	disposeTray();
diff --git a/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx b/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx
index 58d8f2d33ef..e3310ad5e46 100644
--- a/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx
+++ b/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx
@@ -10,26 +10,18 @@ export function TelemetrySync() {
 	useEffect(() => {
 		if (telemetryEnabled === undefined) return;
 
-		try {
-			if (telemetryEnabled) {
-				if (typeof posthog?.opt_in_capturing === "function") {
-					posthog.opt_in_capturing();
-				}
-			} else {
-				if (typeof posthog?.opt_out_capturing === "function") {
-					posthog.opt_out_capturing();
-				}
-			}
+		const outlit = getOutlit();
 
-			const outlit = getOutlit();
-			if (outlit && telemetryEnabled) {
-				outlit.enableTracking();
+		if (telemetryEnabled) {
+			if (typeof posthog?.opt_in_capturing === "function") {
+				posthog.opt_in_capturing();
+			}
+			outlit?.enableTracking();
+		} else {
+			if (typeof posthog?.opt_out_capturing === "function") {
+				posthog.opt_out_capturing();
 			}
-		} catch (error) {
-			console.error(
-				"[telemetry-sync] Failed to update telemetry state:",
-				error,
-			);
+			outlit?.disableTracking();
 		}
 	}, [telemetryEnabled]);
 
diff --git a/apps/desktop/src/renderer/lib/analytics/index.ts b/apps/desktop/src/renderer/lib/analytics/index.ts
index f0a620d452e..b8ee48cfb28 100644
--- a/apps/desktop/src/renderer/lib/analytics/index.ts
+++ b/apps/desktop/src/renderer/lib/analytics/index.ts
@@ -8,6 +8,8 @@ export function track(
 	posthog.capture(event, properties);
 	getOutlit()?.track(
 		event,
-		properties as Record<string, string | number | boolean | null> | undefined,
+		properties as
+			| Record<string, string | number | boolean | null>
+			| undefined,
 	);
 }
diff --git a/apps/desktop/src/renderer/lib/outlit/index.ts b/apps/desktop/src/renderer/lib/outlit/index.ts
index 2b4966d4e4b..0596061c805 100644
--- a/apps/desktop/src/renderer/lib/outlit/index.ts
+++ b/apps/desktop/src/renderer/lib/outlit/index.ts
@@ -15,5 +15,3 @@ export function getOutlit(): Outlit | null {
 	}
 	return outlit;
 }
-
-export { outlit };
diff --git a/apps/desktop/src/renderer/providers/OutlitProvider/OutlitProvider.tsx b/apps/desktop/src/renderer/providers/OutlitProvider/OutlitProvider.tsx
new file mode 100644
index 00000000000..53fa3766700
--- /dev/null
+++ b/apps/desktop/src/renderer/providers/OutlitProvider/OutlitProvider.tsx
@@ -0,0 +1,35 @@
+import { OutlitProvider as OutlitBrowserProvider } from "@outlit/browser/react";
+import type React from "react";
+import { authClient } from "renderer/lib/auth-client";
+import { getOutlit } from "renderer/lib/outlit";
+
+interface OutlitProviderProps {
+	children: React.ReactNode;
+}
+
+export function OutlitProvider({ children }: OutlitProviderProps) {
+	const { data: session } = authClient.useSession();
+	const user = session?.user;
+	const client = getOutlit();
+
+	if (!client) {
+		return <>{children}</>;
+	}
+
+	return (
+		<OutlitBrowserProvider
+			client={client}
+			user={
+				user
+					? {
+							email: user.email,
+							userId: user.id,
+							traits: { name: user.name },
+						}
+					: null
+			}
+		>
+			{children}
+		</OutlitBrowserProvider>
+	);
+}
diff --git a/apps/desktop/src/renderer/providers/OutlitProvider/index.ts b/apps/desktop/src/renderer/providers/OutlitProvider/index.ts
new file mode 100644
index 00000000000..aabfc36b4b5
--- /dev/null
+++ b/apps/desktop/src/renderer/providers/OutlitProvider/index.ts
@@ -0,0 +1 @@
+export { OutlitProvider } from "./OutlitProvider";
diff --git a/apps/desktop/src/renderer/routes/-layout.tsx b/apps/desktop/src/renderer/routes/-layout.tsx
index fdc97dcdb20..fda9e4b844a 100644
--- a/apps/desktop/src/renderer/routes/-layout.tsx
+++ b/apps/desktop/src/renderer/routes/-layout.tsx
@@ -1,35 +1,18 @@
-import { OutlitProvider } from "@outlit/browser/react";
 import { Alerter } from "@superset/ui/atoms/Alert";
 import type { ReactNode } from "react";
 import { PostHogUserIdentifier } from "renderer/components/PostHogUserIdentifier";
 import { TelemetrySync } from "renderer/components/TelemetrySync";
 import { ThemedToaster } from "renderer/components/ThemedToaster";
-import { env } from "renderer/env.renderer";
-import { authClient } from "renderer/lib/auth-client";
 import { AuthProvider } from "renderer/providers/AuthProvider";
 import { ElectronTRPCProvider } from "renderer/providers/ElectronTRPCProvider";
 import { MonacoProvider } from "renderer/providers/MonacoProvider";
+import { OutlitProvider } from "renderer/providers/OutlitProvider";
 import { PostHogProvider } from "renderer/providers/PostHogProvider";
 
 export function RootLayout({ children }: { children: ReactNode }) {
-	const { data: session } = authClient.useSession();
-	const user = session?.user;
-
 	return (
 		<PostHogProvider>
-			<OutlitProvider
-				publicKey={env.NEXT_PUBLIC_OUTLIT_KEY ?? ""}
-				trackPageviews={false}
-				user={
-					user
-						? {
-								email: user.email,
-								userId: user.id,
-								traits: { name: user.name },
-							}
-						: null
-				}
-			>
+			<OutlitProvider>
 				<ElectronTRPCProvider>
 					<PostHogUserIdentifier />
 					<TelemetrySync />
diff --git a/apps/docs/package.json b/apps/docs/package.json
index bbc3ccd15f5..723f754afc7 100644
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -11,7 +11,7 @@
 		"postinstall": "fumadocs-mdx"
 	},
 	"dependencies": {
-		"@outlit/browser": "^1.2.0",
+		"@outlit/browser": "^1.4.0",
 		"@radix-ui/react-collapsible": "^1.1.12",
 		"@radix-ui/react-scroll-area": "^1.2.10",
 		"@sentry/nextjs": "^10.36.0",
diff --git a/apps/marketing/package.json b/apps/marketing/package.json
index d688cd99ada..2c487c2db9e 100644
--- a/apps/marketing/package.json
+++ b/apps/marketing/package.json
@@ -11,7 +11,7 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"dependencies": {
-		"@outlit/browser": "^1.2.0",
+		"@outlit/browser": "^1.4.0",
 		"@react-three/drei": "^10.7.6",
 		"@react-three/fiber": "^9.4.0",
 		"@sentry/nextjs": "^10.36.0",
diff --git a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
index e17e9fe00f7..c958429520c 100644
--- a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
+++ b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
@@ -10,7 +10,7 @@ import { useEffect, useState } from "react";
 import { ANALYTICS_CONSENT_KEY } from "@/lib/constants";
 
 export function CookieConsent() {
-	const { enableTracking } = useOutlit();
+	const { enableTracking, disableTracking } = useOutlit();
 	const [showBanner, setShowBanner] = useState(false);
 
 	useEffect(() => {
@@ -29,6 +29,7 @@ export function CookieConsent() {
 	const handleOptOut = () => {
 		localStorage.setItem(ANALYTICS_CONSENT_KEY, "declined");
 		posthog.opt_out_capturing();
+		disableTracking();
 		setShowBanner(false);
 	};
 
diff --git a/apps/marketing/src/lib/analytics/index.ts b/apps/marketing/src/lib/analytics/index.ts
index 98e769d8a37..c7c4651ac21 100644
--- a/apps/marketing/src/lib/analytics/index.ts
+++ b/apps/marketing/src/lib/analytics/index.ts
@@ -9,6 +9,8 @@ export function track(
 	posthog.capture(event, properties);
 	getOutlit()?.track(
 		event,
-		properties as Record<string, string | number | boolean | null> | undefined,
+		properties as
+			| Record<string, string | number | boolean | null>
+			| undefined,
 	);
 }
diff --git a/apps/marketing/src/lib/outlit/index.ts b/apps/marketing/src/lib/outlit/index.ts
index 80d98a29f8d..e56f7b2b613 100644
--- a/apps/marketing/src/lib/outlit/index.ts
+++ b/apps/marketing/src/lib/outlit/index.ts
@@ -17,5 +17,3 @@ export function getOutlit(): Outlit | null {
 	}
 	return outlit;
 }
-
-export { outlit };
diff --git a/apps/web/package.json b/apps/web/package.json
index aa0bcd0e79f..c4c7af6d1a8 100644
--- a/apps/web/package.json
+++ b/apps/web/package.json
@@ -11,7 +11,7 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"dependencies": {
-		"@outlit/browser": "^1.2.0",
+		"@outlit/browser": "^1.4.0",
 		"@sentry/nextjs": "^10.36.0",
 		"@superset/auth": "workspace:*",
 		"@superset/db": "workspace:*",
diff --git a/apps/web/src/app/providers.tsx b/apps/web/src/app/providers.tsx
index 7846d0d99fd..e06af68f0e5 100644
--- a/apps/web/src/app/providers.tsx
+++ b/apps/web/src/app/providers.tsx
@@ -1,37 +1,20 @@
 "use client";
 
-import { OutlitProvider } from "@outlit/browser/react";
-import { authClient } from "@superset/auth/client";
 import { THEME_STORAGE_KEY } from "@superset/shared/constants";
 import { ReactQueryDevtools } from "@tanstack/react-query-devtools";
 import { ThemeProvider } from "next-themes";
 import posthog from "posthog-js";
 import { PostHogProvider } from "posthog-js/react";
 
+import { OutlitProvider } from "@/components/OutlitProvider";
 import { PostHogUserIdentifier } from "@/components/PostHogUserIdentifier";
-import { env } from "@/env";
 
 import { TRPCReactProvider } from "../trpc/react";
 
 export function Providers({ children }: { children: React.ReactNode }) {
-	const { data: session } = authClient.useSession();
-	const user = session?.user;
-
 	return (
 		<PostHogProvider client={posthog}>
-			<OutlitProvider
-				publicKey={env.NEXT_PUBLIC_OUTLIT_KEY ?? ""}
-				trackPageviews
-				user={
-					user
-						? {
-								email: user.email,
-								userId: user.id,
-								traits: { name: user.name },
-							}
-						: null
-				}
-			>
+			<OutlitProvider>
 				<TRPCReactProvider>
 					<ThemeProvider
 						attribute="class"
diff --git a/apps/web/src/components/OutlitProvider/OutlitProvider.tsx b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
new file mode 100644
index 00000000000..5163fdbf8f7
--- /dev/null
+++ b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
@@ -0,0 +1,34 @@
+"use client";
+
+import { OutlitProvider as OutlitBrowserProvider } from "@outlit/browser/react";
+import { authClient } from "@superset/auth/client";
+import type React from "react";
+
+import { env } from "@/env";
+
+interface OutlitProviderProps {
+	children: React.ReactNode;
+}
+
+export function OutlitProvider({ children }: OutlitProviderProps) {
+	const { data: session } = authClient.useSession();
+	const user = session?.user;
+
+	return (
+		<OutlitBrowserProvider
+			publicKey={env.NEXT_PUBLIC_OUTLIT_KEY ?? ""}
+			trackPageviews
+			user={
+				user
+					? {
+							email: user.email,
+							userId: user.id,
+							traits: { name: user.name },
+						}
+					: null
+			}
+		>
+			{children}
+		</OutlitBrowserProvider>
+	);
+}
diff --git a/apps/web/src/components/OutlitProvider/index.ts b/apps/web/src/components/OutlitProvider/index.ts
new file mode 100644
index 00000000000..aabfc36b4b5
--- /dev/null
+++ b/apps/web/src/components/OutlitProvider/index.ts
@@ -0,0 +1 @@
+export { OutlitProvider } from "./OutlitProvider";
diff --git a/bun.lock b/bun.lock
index f228fc49cd1..f9f8c1e4238 100644
--- a/bun.lock
+++ b/bun.lock
@@ -117,7 +117,7 @@
         "@headless-tree/react": "^1.6.3",
         "@hookform/resolvers": "^5.2.2",
         "@monaco-editor/react": "^4.7.0",
-        "@outlit/browser": "^1.2.0",
+        "@outlit/browser": "^1.4.0",
         "@outlit/node": "^1.1.0",
         "@pierre/diffs": "^1.0.10",
         "@radix-ui/react-dialog": "^1.1.15",
@@ -284,7 +284,7 @@
       "name": "@superset/docs",
       "version": "0.0.0",
       "dependencies": {
-        "@outlit/browser": "^1.2.0",
+        "@outlit/browser": "^1.4.0",
         "@radix-ui/react-collapsible": "^1.1.12",
         "@radix-ui/react-scroll-area": "^1.2.10",
         "@sentry/nextjs": "^10.36.0",
@@ -321,7 +321,7 @@
       "name": "@superset/marketing",
       "version": "0.1.0",
       "dependencies": {
-        "@outlit/browser": "^1.2.0",
+        "@outlit/browser": "^1.4.0",
         "@react-three/drei": "^10.7.6",
         "@react-three/fiber": "^9.4.0",
         "@sentry/nextjs": "^10.36.0",
@@ -486,7 +486,7 @@
       "name": "@superset/web",
       "version": "0.1.0",
       "dependencies": {
-        "@outlit/browser": "^1.2.0",
+        "@outlit/browser": "^1.4.0",
         "@sentry/nextjs": "^10.36.0",
         "@superset/auth": "workspace:*",
         "@superset/db": "workspace:*",
@@ -1522,7 +1522,7 @@
 
     "@orama/orama": ["@orama/orama@3.1.18", "", {}, "sha512-a61ljmRVVyG5MC/698C8/FfFDw5a8LOIvyOLW5fztgUXqUpc1jOfQzOitSCbge657OgXXThmY3Tk8fpiDb4UcA=="],
 
-    "@outlit/browser": ["@outlit/browser@1.2.0", "", { "dependencies": { "@outlit/core": "1.1.0" }, "peerDependencies": { "react": ">=17.0.0", "vue": ">=3.0.0" }, "optionalPeers": ["react", "vue"] }, "sha512-h2c/9Qmzw7tVygPln3o8XVEVA/0E9XWOhbh2mNWPjmCmv0VbREP4IoU8dG4flWYNKcGo2aVPsdIXTiEVqSlkzg=="],
+    "@outlit/browser": ["@outlit/browser@1.4.0", "", { "dependencies": { "@outlit/core": "1.1.0" }, "peerDependencies": { "react": ">=17.0.0", "vue": ">=3.0.0" }, "optionalPeers": ["react", "vue"] }, "sha512-CIcMrRWkeVa42uof33ugoQw6RGkDRtwUxUxF0Ih6hFLhgJU3I/d+fYC+bZHmzh3WMUSPQhjulRrA3cY9GouqPg=="],
 
     "@outlit/core": ["@outlit/core@1.1.0", "", {}, "sha512-TNM9cIdunfcF0TLwCzSJ7sZWmDhUF8oYt4Q1KgW5Fm+4KGsfjDUbGDq9svrml1cmPrAXTZdiYwIYdRAG9327/g=="],
 

From 36a682e01c949fb91a6735ce173a61147f058c03 Mon Sep 17 00:00:00 2001
From: Kiet Ho <hoakiet98@gmail.com>
Date: Mon, 9 Feb 2026 23:10:59 -0800
Subject: [PATCH 09/20] fix: resolve Outlit SDK integration bugs across
 marketing, web, and desktop

- Use single Outlit instance in marketing (pass singleton as client to
  provider) so consent opt-out actually disables tracking
- Ungate desktop main-process Outlit tracking from PostHog availability
- Guard against empty publicKey in web/marketing (skip init when missing)
- Add posthog.opt_in_capturing() to CookieConsent handleAccept for symmetry
- Replace unsafe type casts with toOutlitProperties filter in all track wrappers
---
 apps/desktop/src/main/lib/analytics/index.ts  | 46 +++++++++++++------
 .../src/renderer/lib/analytics/index.ts       | 25 +++++++---
 apps/marketing/src/app/providers.tsx          | 24 ++++++----
 .../CookieConsent/CookieConsent.tsx           |  1 +
 apps/marketing/src/lib/analytics/index.ts     | 25 +++++++---
 .../OutlitProvider/OutlitProvider.tsx         |  6 ++-
 6 files changed, 91 insertions(+), 36 deletions(-)

diff --git a/apps/desktop/src/main/lib/analytics/index.ts b/apps/desktop/src/main/lib/analytics/index.ts
index 3c6a071f150..a9cbf57f76d 100644
--- a/apps/desktop/src/main/lib/analytics/index.ts
+++ b/apps/desktop/src/main/lib/analytics/index.ts
@@ -30,6 +30,24 @@ export function setUserId(id: string | null): void {
 	userId = id;
 }
 
+function toOutlitProperties(
+	properties?: Record<string, unknown>,
+): Record<string, string | number | boolean | null> | undefined {
+	if (!properties) return undefined;
+	const result: Record<string, string | number | boolean | null> = {};
+	for (const [key, value] of Object.entries(properties)) {
+		if (
+			value === null ||
+			typeof value === "string" ||
+			typeof value === "number" ||
+			typeof value === "boolean"
+		) {
+			result[key] = value;
+		}
+	}
+	return result;
+}
+
 export function track(
 	event: string,
 	properties?: Record<string, unknown>,
@@ -38,18 +56,18 @@ export function track(
 	if (!isTelemetryEnabled()) return;
 
 	const client = getClient();
-	if (!client) return;
-
-	client.capture({
-		distinctId: userId,
-		event,
-		properties: {
-			...properties,
-			app_name: "desktop",
-			platform: process.platform,
-			desktop_version: app.getVersion(),
-		},
-	});
+	if (client) {
+		client.capture({
+			distinctId: userId,
+			event,
+			properties: {
+				...properties,
+				app_name: "desktop",
+				platform: process.platform,
+				desktop_version: app.getVersion(),
+			},
+		});
+	}
 
 	// Outlit tracking
 	try {
@@ -58,9 +76,7 @@ export function track(
 			outlit.track({
 				eventName: event,
 				userId,
-				properties: properties as
-					| Record<string, string | number | boolean | null>
-					| undefined,
+				properties: toOutlitProperties(properties),
 			});
 
 			// Fire user.activate() on project_opened (activation moment)
diff --git a/apps/desktop/src/renderer/lib/analytics/index.ts b/apps/desktop/src/renderer/lib/analytics/index.ts
index b8ee48cfb28..b57f982c0ce 100644
--- a/apps/desktop/src/renderer/lib/analytics/index.ts
+++ b/apps/desktop/src/renderer/lib/analytics/index.ts
@@ -1,15 +1,28 @@
 import { getOutlit } from "renderer/lib/outlit";
 import { posthog } from "renderer/lib/posthog";
 
+function toOutlitProperties(
+	properties?: Record<string, unknown>,
+): Record<string, string | number | boolean | null> | undefined {
+	if (!properties) return undefined;
+	const result: Record<string, string | number | boolean | null> = {};
+	for (const [key, value] of Object.entries(properties)) {
+		if (
+			value === null ||
+			typeof value === "string" ||
+			typeof value === "number" ||
+			typeof value === "boolean"
+		) {
+			result[key] = value;
+		}
+	}
+	return result;
+}
+
 export function track(
 	event: string,
 	properties?: Record<string, unknown>,
 ): void {
 	posthog.capture(event, properties);
-	getOutlit()?.track(
-		event,
-		properties as
-			| Record<string, string | number | boolean | null>
-			| undefined,
-	);
+	getOutlit()?.track(event, toOutlitProperties(properties));
 }
diff --git a/apps/marketing/src/app/providers.tsx b/apps/marketing/src/app/providers.tsx
index cee84191792..b1a5c465547 100644
--- a/apps/marketing/src/app/providers.tsx
+++ b/apps/marketing/src/app/providers.tsx
@@ -1,21 +1,29 @@
 "use client";
 
-import { OutlitProvider } from "@outlit/browser/react";
+import { OutlitProvider as OutlitBrowserProvider } from "@outlit/browser/react";
 import { THEME_STORAGE_KEY } from "@superset/shared/constants";
 import { ThemeProvider } from "next-themes";
 import posthog from "posthog-js";
 import { PostHogProvider } from "posthog-js/react";
 
-import { env } from "@/env";
+import { getOutlit } from "@/lib/outlit";
+
+function OutlitWrapper({ children }: { children: React.ReactNode }) {
+	const client = getOutlit();
+
+	if (!client) {
+		return <>{children}</>;
+	}
+
+	return (
+		<OutlitBrowserProvider client={client}>{children}</OutlitBrowserProvider>
+	);
+}
 
 export function Providers({ children }: { children: React.ReactNode }) {
 	return (
 		<PostHogProvider client={posthog}>
-			<OutlitProvider
-				publicKey={env.NEXT_PUBLIC_OUTLIT_KEY ?? ""}
-				trackPageviews
-				autoTrack={false}
-			>
+			<OutlitWrapper>
 				<ThemeProvider
 					attribute="class"
 					defaultTheme="dark"
@@ -25,7 +33,7 @@ export function Providers({ children }: { children: React.ReactNode }) {
 				>
 					{children}
 				</ThemeProvider>
-			</OutlitProvider>
+			</OutlitWrapper>
 		</PostHogProvider>
 	);
 }
diff --git a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
index c958429520c..8b37ecddce7 100644
--- a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
+++ b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
@@ -23,6 +23,7 @@ export function CookieConsent() {
 	const handleAccept = () => {
 		localStorage.setItem(ANALYTICS_CONSENT_KEY, "accepted");
 		setShowBanner(false);
+		posthog.opt_in_capturing();
 		enableTracking();
 	};
 
diff --git a/apps/marketing/src/lib/analytics/index.ts b/apps/marketing/src/lib/analytics/index.ts
index c7c4651ac21..34b54c719ef 100644
--- a/apps/marketing/src/lib/analytics/index.ts
+++ b/apps/marketing/src/lib/analytics/index.ts
@@ -2,15 +2,28 @@ import posthog from "posthog-js";
 
 import { getOutlit } from "@/lib/outlit";
 
+function toOutlitProperties(
+	properties?: Record<string, unknown>,
+): Record<string, string | number | boolean | null> | undefined {
+	if (!properties) return undefined;
+	const result: Record<string, string | number | boolean | null> = {};
+	for (const [key, value] of Object.entries(properties)) {
+		if (
+			value === null ||
+			typeof value === "string" ||
+			typeof value === "number" ||
+			typeof value === "boolean"
+		) {
+			result[key] = value;
+		}
+	}
+	return result;
+}
+
 export function track(
 	event: string,
 	properties?: Record<string, unknown>,
 ): void {
 	posthog.capture(event, properties);
-	getOutlit()?.track(
-		event,
-		properties as
-			| Record<string, string | number | boolean | null>
-			| undefined,
-	);
+	getOutlit()?.track(event, toOutlitProperties(properties));
 }
diff --git a/apps/web/src/components/OutlitProvider/OutlitProvider.tsx b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
index 5163fdbf8f7..9d310fad1a4 100644
--- a/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
+++ b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
@@ -14,9 +14,13 @@ export function OutlitProvider({ children }: OutlitProviderProps) {
 	const { data: session } = authClient.useSession();
 	const user = session?.user;
 
+	if (!env.NEXT_PUBLIC_OUTLIT_KEY) {
+		return <>{children}</>;
+	}
+
 	return (
 		<OutlitBrowserProvider
-			publicKey={env.NEXT_PUBLIC_OUTLIT_KEY ?? ""}
+			publicKey={env.NEXT_PUBLIC_OUTLIT_KEY}
 			trackPageviews
 			user={
 				user

From b049fd789a983f8507c20b688dc9807ab72a68c5 Mon Sep 17 00:00:00 2001
From: Satya Patel <satyapatel111@gmail.com>
Date: Tue, 10 Feb 2026 13:23:13 -0800
Subject: [PATCH 10/20] refactor: clean up Outlit SDK integration

- Make NEXT_PUBLIC_OUTLIT_KEY required in all env.ts files (matches POSTHOG_KEY pattern)
- Replace lazy singleton getOutlit() with module-level exports across all apps
- Fix CookieConsent crash by replacing useOutlit() hook with direct module import
- Fix desktop renderer autoTrack: true conflicting with manual pageview tracking
- Deduplicate toOutlitProperties into apps/desktop/src/shared/analytics.ts
- Standardize web and docs to use client prop instead of inline publicKey
- Remove all unnecessary null guards and optional chaining
---
 apps/desktop/src/main/lib/analytics/index.ts  | 40 +++++--------------
 apps/desktop/src/main/lib/outlit/index.ts     | 22 ++--------
 .../TelemetrySync/TelemetrySync.tsx           |  8 ++--
 apps/desktop/src/renderer/env.renderer.ts     |  2 +-
 apps/desktop/src/renderer/index.tsx           |  4 +-
 .../src/renderer/lib/analytics/index.ts       | 23 ++---------
 apps/desktop/src/renderer/lib/outlit/index.ts | 19 +++------
 .../OutlitProvider/OutlitProvider.tsx         |  9 +----
 apps/desktop/src/shared/analytics.ts          | 17 ++++++++
 apps/docs/src/app/providers.tsx               | 10 +----
 apps/docs/src/env.ts                          |  2 +-
 apps/docs/src/lib/outlit/index.ts             |  8 ++++
 apps/marketing/src/app/providers.tsx          | 18 ++-------
 .../CookieConsent/CookieConsent.tsx           |  7 ++--
 apps/marketing/src/env.ts                     |  2 +-
 apps/marketing/src/lib/analytics/index.ts     |  4 +-
 apps/marketing/src/lib/outlit/index.ts        | 20 +++-------
 .../OutlitProvider/OutlitProvider.tsx         |  9 +----
 apps/web/src/env.ts                           |  2 +-
 apps/web/src/lib/outlit/index.ts              |  8 ++++
 20 files changed, 82 insertions(+), 152 deletions(-)
 create mode 100644 apps/desktop/src/shared/analytics.ts
 create mode 100644 apps/docs/src/lib/outlit/index.ts
 create mode 100644 apps/web/src/lib/outlit/index.ts

diff --git a/apps/desktop/src/main/lib/analytics/index.ts b/apps/desktop/src/main/lib/analytics/index.ts
index a9cbf57f76d..49aa684ad49 100644
--- a/apps/desktop/src/main/lib/analytics/index.ts
+++ b/apps/desktop/src/main/lib/analytics/index.ts
@@ -1,7 +1,8 @@
 import { app } from "electron";
 import { env } from "main/env.main";
-import { getOutlit } from "main/lib/outlit";
+import { outlit } from "main/lib/outlit";
 import { PostHog } from "posthog-node";
+import { toOutlitProperties } from "shared/analytics";
 import { DEFAULT_TELEMETRY_ENABLED } from "shared/constants";
 
 export let posthog: PostHog | null = null;
@@ -30,24 +31,6 @@ export function setUserId(id: string | null): void {
 	userId = id;
 }
 
-function toOutlitProperties(
-	properties?: Record<string, unknown>,
-): Record<string, string | number | boolean | null> | undefined {
-	if (!properties) return undefined;
-	const result: Record<string, string | number | boolean | null> = {};
-	for (const [key, value] of Object.entries(properties)) {
-		if (
-			value === null ||
-			typeof value === "string" ||
-			typeof value === "number" ||
-			typeof value === "boolean"
-		) {
-			result[key] = value;
-		}
-	}
-	return result;
-}
-
 export function track(
 	event: string,
 	properties?: Record<string, unknown>,
@@ -71,18 +54,15 @@ export function track(
 
 	// Outlit tracking
 	try {
-		const outlit = getOutlit();
-		if (outlit) {
-			outlit.track({
-				eventName: event,
-				userId,
-				properties: toOutlitProperties(properties),
-			});
+		outlit.track({
+			eventName: event,
+			userId,
+			properties: toOutlitProperties(properties),
+		});
 
-			// Fire user.activate() on project_opened (activation moment)
-			if (event === "project_opened") {
-				outlit.user.activate({ userId });
-			}
+		// Fire user.activate() on project_opened (activation moment)
+		if (event === "project_opened") {
+			outlit.user.activate({ userId });
 		}
 	} catch (error) {
 		console.error("[analytics/outlit] Failed to track:", error);
diff --git a/apps/desktop/src/main/lib/outlit/index.ts b/apps/desktop/src/main/lib/outlit/index.ts
index 75fbb3ee7b6..2868cece0d3 100644
--- a/apps/desktop/src/main/lib/outlit/index.ts
+++ b/apps/desktop/src/main/lib/outlit/index.ts
@@ -1,22 +1,6 @@
 import { Outlit } from "@outlit/node";
 import { env } from "main/env.main";
 
-let outlit: Outlit | null = null;
-
-export function getOutlit(): Outlit | null {
-	if (!env.NEXT_PUBLIC_OUTLIT_KEY) return null;
-
-	if (!outlit) {
-		outlit = new Outlit({
-			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
-		});
-	}
-	return outlit;
-}
-
-export async function shutdownOutlit(): Promise<void> {
-	if (outlit) {
-		await outlit.shutdown();
-		outlit = null;
-	}
-}
+export const outlit = new Outlit({
+	publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
+});
diff --git a/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx b/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx
index e3310ad5e46..83cdf6b8bdd 100644
--- a/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx
+++ b/apps/desktop/src/renderer/components/TelemetrySync/TelemetrySync.tsx
@@ -1,6 +1,6 @@
 import { useEffect } from "react";
 import { electronTrpc } from "renderer/lib/electron-trpc";
-import { getOutlit } from "renderer/lib/outlit";
+import { outlit } from "renderer/lib/outlit";
 import { posthog } from "renderer/lib/posthog";
 
 export function TelemetrySync() {
@@ -10,18 +10,16 @@ export function TelemetrySync() {
 	useEffect(() => {
 		if (telemetryEnabled === undefined) return;
 
-		const outlit = getOutlit();
-
 		if (telemetryEnabled) {
 			if (typeof posthog?.opt_in_capturing === "function") {
 				posthog.opt_in_capturing();
 			}
-			outlit?.enableTracking();
+			outlit.enableTracking();
 		} else {
 			if (typeof posthog?.opt_out_capturing === "function") {
 				posthog.opt_out_capturing();
 			}
-			outlit?.disableTracking();
+			outlit.disableTracking();
 		}
 	}, [telemetryEnabled]);
 
diff --git a/apps/desktop/src/renderer/env.renderer.ts b/apps/desktop/src/renderer/env.renderer.ts
index 52c23249a67..548afa77cfa 100644
--- a/apps/desktop/src/renderer/env.renderer.ts
+++ b/apps/desktop/src/renderer/env.renderer.ts
@@ -19,7 +19,7 @@ const envSchema = z.object({
 	NEXT_PUBLIC_WEB_URL: z.url().default("https://app.superset.sh"),
 	NEXT_PUBLIC_POSTHOG_KEY: z.string().optional(),
 	NEXT_PUBLIC_POSTHOG_HOST: z.string().default("https://us.i.posthog.com"),
-	NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
+	NEXT_PUBLIC_OUTLIT_KEY: z.string(),
 	SENTRY_DSN_DESKTOP: z.string().optional(),
 });
 
diff --git a/apps/desktop/src/renderer/index.tsx b/apps/desktop/src/renderer/index.tsx
index 51d08d9b78e..8d0b08ac1a4 100644
--- a/apps/desktop/src/renderer/index.tsx
+++ b/apps/desktop/src/renderer/index.tsx
@@ -12,7 +12,7 @@ import {
 	markBootMounted,
 	reportBootError,
 } from "./lib/boot-errors";
-import { getOutlit } from "./lib/outlit";
+import { outlit } from "./lib/outlit";
 import { persistentHistory } from "./lib/persistent-hash-history";
 import { posthog } from "./lib/posthog";
 import { electronQueryClient } from "./providers/ElectronTRPCProvider";
@@ -36,7 +36,7 @@ const unsubscribe = router.subscribe("onResolved", (event) => {
 	posthog.capture("$pageview", {
 		$current_url: event.toLocation.pathname,
 	});
-	getOutlit()?.track("pageview", {
+	outlit.track("pageview", {
 		url: event.toLocation.pathname,
 	});
 });
diff --git a/apps/desktop/src/renderer/lib/analytics/index.ts b/apps/desktop/src/renderer/lib/analytics/index.ts
index b57f982c0ce..bad28040dd6 100644
--- a/apps/desktop/src/renderer/lib/analytics/index.ts
+++ b/apps/desktop/src/renderer/lib/analytics/index.ts
@@ -1,28 +1,11 @@
-import { getOutlit } from "renderer/lib/outlit";
+import { outlit } from "renderer/lib/outlit";
 import { posthog } from "renderer/lib/posthog";
-
-function toOutlitProperties(
-	properties?: Record<string, unknown>,
-): Record<string, string | number | boolean | null> | undefined {
-	if (!properties) return undefined;
-	const result: Record<string, string | number | boolean | null> = {};
-	for (const [key, value] of Object.entries(properties)) {
-		if (
-			value === null ||
-			typeof value === "string" ||
-			typeof value === "number" ||
-			typeof value === "boolean"
-		) {
-			result[key] = value;
-		}
-	}
-	return result;
-}
+import { toOutlitProperties } from "shared/analytics";
 
 export function track(
 	event: string,
 	properties?: Record<string, unknown>,
 ): void {
 	posthog.capture(event, properties);
-	getOutlit()?.track(event, toOutlitProperties(properties));
+	outlit.track(event, toOutlitProperties(properties));
 }
diff --git a/apps/desktop/src/renderer/lib/outlit/index.ts b/apps/desktop/src/renderer/lib/outlit/index.ts
index 0596061c805..855e1eebbc1 100644
--- a/apps/desktop/src/renderer/lib/outlit/index.ts
+++ b/apps/desktop/src/renderer/lib/outlit/index.ts
@@ -1,17 +1,8 @@
 import { Outlit } from "@outlit/browser";
 import { env } from "renderer/env.renderer";
 
-let outlit: Outlit | null = null;
-
-export function getOutlit(): Outlit | null {
-	if (!env.NEXT_PUBLIC_OUTLIT_KEY) return null;
-
-	if (!outlit) {
-		outlit = new Outlit({
-			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
-			trackPageviews: false,
-			autoTrack: true,
-		});
-	}
-	return outlit;
-}
+export const outlit = new Outlit({
+	publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
+	trackPageviews: false,
+	autoTrack: false,
+});
diff --git a/apps/desktop/src/renderer/providers/OutlitProvider/OutlitProvider.tsx b/apps/desktop/src/renderer/providers/OutlitProvider/OutlitProvider.tsx
index 53fa3766700..dfbdd2251ff 100644
--- a/apps/desktop/src/renderer/providers/OutlitProvider/OutlitProvider.tsx
+++ b/apps/desktop/src/renderer/providers/OutlitProvider/OutlitProvider.tsx
@@ -1,7 +1,7 @@
 import { OutlitProvider as OutlitBrowserProvider } from "@outlit/browser/react";
 import type React from "react";
 import { authClient } from "renderer/lib/auth-client";
-import { getOutlit } from "renderer/lib/outlit";
+import { outlit } from "renderer/lib/outlit";
 
 interface OutlitProviderProps {
 	children: React.ReactNode;
@@ -10,15 +10,10 @@ interface OutlitProviderProps {
 export function OutlitProvider({ children }: OutlitProviderProps) {
 	const { data: session } = authClient.useSession();
 	const user = session?.user;
-	const client = getOutlit();
-
-	if (!client) {
-		return <>{children}</>;
-	}
 
 	return (
 		<OutlitBrowserProvider
-			client={client}
+			client={outlit}
 			user={
 				user
 					? {
diff --git a/apps/desktop/src/shared/analytics.ts b/apps/desktop/src/shared/analytics.ts
new file mode 100644
index 00000000000..41b4eb941be
--- /dev/null
+++ b/apps/desktop/src/shared/analytics.ts
@@ -0,0 +1,17 @@
+export function toOutlitProperties(
+	properties?: Record<string, unknown>,
+): Record<string, string | number | boolean | null> | undefined {
+	if (!properties) return undefined;
+	const result: Record<string, string | number | boolean | null> = {};
+	for (const [key, value] of Object.entries(properties)) {
+		if (
+			value === null ||
+			typeof value === "string" ||
+			typeof value === "number" ||
+			typeof value === "boolean"
+		) {
+			result[key] = value;
+		}
+	}
+	return result;
+}
diff --git a/apps/docs/src/app/providers.tsx b/apps/docs/src/app/providers.tsx
index 12c7be35681..96ea65b88e2 100644
--- a/apps/docs/src/app/providers.tsx
+++ b/apps/docs/src/app/providers.tsx
@@ -2,18 +2,12 @@
 
 import { OutlitProvider } from "@outlit/browser/react";
 
-import { env } from "@/env";
+import { outlit } from "@/lib/outlit";
 
 export function OutlitProviderWrapper({
 	children,
 }: {
 	children: React.ReactNode;
 }) {
-	if (!env.NEXT_PUBLIC_OUTLIT_KEY) return <>{children}</>;
-
-	return (
-		<OutlitProvider publicKey={env.NEXT_PUBLIC_OUTLIT_KEY} trackPageviews>
-			{children}
-		</OutlitProvider>
-	);
+	return <OutlitProvider client={outlit}>{children}</OutlitProvider>;
 }
diff --git a/apps/docs/src/env.ts b/apps/docs/src/env.ts
index d972eb3072c..2ee1b8cdb06 100644
--- a/apps/docs/src/env.ts
+++ b/apps/docs/src/env.ts
@@ -21,7 +21,7 @@ export const env = createEnv({
 
 	client: {
 		NEXT_PUBLIC_MARKETING_URL: z.string().url().optional(),
-		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
 		NEXT_PUBLIC_POSTHOG_KEY: z.string().optional(),
 		NEXT_PUBLIC_POSTHOG_HOST: z.string().url().optional(),
 		NEXT_PUBLIC_SENTRY_DSN_DOCS: z.string().optional(),
diff --git a/apps/docs/src/lib/outlit/index.ts b/apps/docs/src/lib/outlit/index.ts
new file mode 100644
index 00000000000..774ca30249b
--- /dev/null
+++ b/apps/docs/src/lib/outlit/index.ts
@@ -0,0 +1,8 @@
+import { Outlit } from "@outlit/browser";
+
+import { env } from "@/env";
+
+export const outlit = new Outlit({
+	publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
+	trackPageviews: true,
+});
diff --git a/apps/marketing/src/app/providers.tsx b/apps/marketing/src/app/providers.tsx
index b1a5c465547..f35d04b1fae 100644
--- a/apps/marketing/src/app/providers.tsx
+++ b/apps/marketing/src/app/providers.tsx
@@ -6,24 +6,12 @@ import { ThemeProvider } from "next-themes";
 import posthog from "posthog-js";
 import { PostHogProvider } from "posthog-js/react";
 
-import { getOutlit } from "@/lib/outlit";
-
-function OutlitWrapper({ children }: { children: React.ReactNode }) {
-	const client = getOutlit();
-
-	if (!client) {
-		return <>{children}</>;
-	}
-
-	return (
-		<OutlitBrowserProvider client={client}>{children}</OutlitBrowserProvider>
-	);
-}
+import { outlit } from "@/lib/outlit";
 
 export function Providers({ children }: { children: React.ReactNode }) {
 	return (
 		<PostHogProvider client={posthog}>
-			<OutlitWrapper>
+			<OutlitBrowserProvider client={outlit}>
 				<ThemeProvider
 					attribute="class"
 					defaultTheme="dark"
@@ -33,7 +21,7 @@ export function Providers({ children }: { children: React.ReactNode }) {
 				>
 					{children}
 				</ThemeProvider>
-			</OutlitWrapper>
+			</OutlitBrowserProvider>
 		</PostHogProvider>
 	);
 }
diff --git a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
index 8b37ecddce7..c45eda45c67 100644
--- a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
+++ b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
@@ -1,6 +1,5 @@
 "use client";
 
-import { useOutlit } from "@outlit/browser/react";
 import { Button } from "@superset/ui/button";
 import { AnimatePresence, motion } from "framer-motion";
 import Link from "next/link";
@@ -8,9 +7,9 @@ import posthog from "posthog-js";
 import { useEffect, useState } from "react";
 
 import { ANALYTICS_CONSENT_KEY } from "@/lib/constants";
+import { outlit } from "@/lib/outlit";
 
 export function CookieConsent() {
-	const { enableTracking, disableTracking } = useOutlit();
 	const [showBanner, setShowBanner] = useState(false);
 
 	useEffect(() => {
@@ -24,13 +23,13 @@ export function CookieConsent() {
 		localStorage.setItem(ANALYTICS_CONSENT_KEY, "accepted");
 		setShowBanner(false);
 		posthog.opt_in_capturing();
-		enableTracking();
+		outlit.enableTracking();
 	};
 
 	const handleOptOut = () => {
 		localStorage.setItem(ANALYTICS_CONSENT_KEY, "declined");
 		posthog.opt_out_capturing();
-		disableTracking();
+		outlit.disableTracking();
 		setShowBanner(false);
 	};
 
diff --git a/apps/marketing/src/env.ts b/apps/marketing/src/env.ts
index aea10c322f3..fa40cf82f57 100644
--- a/apps/marketing/src/env.ts
+++ b/apps/marketing/src/env.ts
@@ -30,7 +30,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_SENTRY_ENVIRONMENT: z
 			.enum(["development", "preview", "production"])
 			.optional(),
-		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
 	},
 	experimental__runtimeEnv: {
 		NODE_ENV: process.env.NODE_ENV,
diff --git a/apps/marketing/src/lib/analytics/index.ts b/apps/marketing/src/lib/analytics/index.ts
index 34b54c719ef..940e95e765b 100644
--- a/apps/marketing/src/lib/analytics/index.ts
+++ b/apps/marketing/src/lib/analytics/index.ts
@@ -1,6 +1,6 @@
 import posthog from "posthog-js";
 
-import { getOutlit } from "@/lib/outlit";
+import { outlit } from "@/lib/outlit";
 
 function toOutlitProperties(
 	properties?: Record<string, unknown>,
@@ -25,5 +25,5 @@ export function track(
 	properties?: Record<string, unknown>,
 ): void {
 	posthog.capture(event, properties);
-	getOutlit()?.track(event, toOutlitProperties(properties));
+	outlit.track(event, toOutlitProperties(properties));
 }
diff --git a/apps/marketing/src/lib/outlit/index.ts b/apps/marketing/src/lib/outlit/index.ts
index e56f7b2b613..f6a1867a268 100644
--- a/apps/marketing/src/lib/outlit/index.ts
+++ b/apps/marketing/src/lib/outlit/index.ts
@@ -2,18 +2,8 @@ import { Outlit } from "@outlit/browser";
 
 import { env } from "@/env";
 
-let outlit: Outlit | null = null;
-
-export function getOutlit(): Outlit | null {
-	if (!env.NEXT_PUBLIC_OUTLIT_KEY) return null;
-
-	if (!outlit) {
-		outlit = new Outlit({
-			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
-			trackPageviews: true,
-			trackForms: true,
-			autoTrack: false,
-		});
-	}
-	return outlit;
-}
+export const outlit = new Outlit({
+	publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
+	trackPageviews: true,
+	trackForms: true,
+});
diff --git a/apps/web/src/components/OutlitProvider/OutlitProvider.tsx b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
index 9d310fad1a4..94c3819cfce 100644
--- a/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
+++ b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
@@ -4,7 +4,7 @@ import { OutlitProvider as OutlitBrowserProvider } from "@outlit/browser/react";
 import { authClient } from "@superset/auth/client";
 import type React from "react";
 
-import { env } from "@/env";
+import { outlit } from "@/lib/outlit";
 
 interface OutlitProviderProps {
 	children: React.ReactNode;
@@ -14,14 +14,9 @@ export function OutlitProvider({ children }: OutlitProviderProps) {
 	const { data: session } = authClient.useSession();
 	const user = session?.user;
 
-	if (!env.NEXT_PUBLIC_OUTLIT_KEY) {
-		return <>{children}</>;
-	}
-
 	return (
 		<OutlitBrowserProvider
-			publicKey={env.NEXT_PUBLIC_OUTLIT_KEY}
-			trackPageviews
+			client={outlit}
 			user={
 				user
 					? {
diff --git a/apps/web/src/env.ts b/apps/web/src/env.ts
index cd2c98944c0..f502acf671a 100644
--- a/apps/web/src/env.ts
+++ b/apps/web/src/env.ts
@@ -36,7 +36,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_SENTRY_ENVIRONMENT: z
 			.enum(["development", "preview", "production"])
 			.optional(),
-		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
 	},
 
 	experimental__runtimeEnv: {
diff --git a/apps/web/src/lib/outlit/index.ts b/apps/web/src/lib/outlit/index.ts
new file mode 100644
index 00000000000..774ca30249b
--- /dev/null
+++ b/apps/web/src/lib/outlit/index.ts
@@ -0,0 +1,8 @@
+import { Outlit } from "@outlit/browser";
+
+import { env } from "@/env";
+
+export const outlit = new Outlit({
+	publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
+	trackPageviews: true,
+});

From 1b06971cae3b02ba434247f40e178db7378697c5 Mon Sep 17 00:00:00 2001
From: Satya Patel <satyapatel111@gmail.com>
Date: Tue, 10 Feb 2026 13:25:32 -0800
Subject: [PATCH 11/20] refactor(desktop): remove unnecessary try/catch around
 outlit tracking

Analytics SDKs handle errors internally. No other outlit call site in the
codebase wraps calls in try/catch.
---
 apps/desktop/src/main/lib/analytics/index.ts | 21 ++++++++------------
 1 file changed, 8 insertions(+), 13 deletions(-)

diff --git a/apps/desktop/src/main/lib/analytics/index.ts b/apps/desktop/src/main/lib/analytics/index.ts
index 49aa684ad49..6c40960eb8e 100644
--- a/apps/desktop/src/main/lib/analytics/index.ts
+++ b/apps/desktop/src/main/lib/analytics/index.ts
@@ -52,19 +52,14 @@ export function track(
 		});
 	}
 
-	// Outlit tracking
-	try {
-		outlit.track({
-			eventName: event,
-			userId,
-			properties: toOutlitProperties(properties),
-		});
+	outlit.track({
+		eventName: event,
+		userId,
+		properties: toOutlitProperties(properties),
+	});
 
-		// Fire user.activate() on project_opened (activation moment)
-		if (event === "project_opened") {
-			outlit.user.activate({ userId });
-		}
-	} catch (error) {
-		console.error("[analytics/outlit] Failed to track:", error);
+	// Fire user.activate() on project_opened (activation moment)
+	if (event === "project_opened") {
+		outlit.user.activate({ userId });
 	}
 }

From 636216011ee3b9729de9f59842cd76ea42783dc5 Mon Sep 17 00:00:00 2001
From: Satya Patel <satyapatel111@gmail.com>
Date: Tue, 10 Feb 2026 13:35:20 -0800
Subject: [PATCH 12/20] ci: add NEXT_PUBLIC_OUTLIT_KEY to deploy workflows

Pass the Outlit key to web, marketing, and docs in both preview and
production deployments via GitHub Secrets.
---
 .github/workflows/deploy-preview.yml    | 6 ++++++
 .github/workflows/deploy-production.yml | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/.github/workflows/deploy-preview.yml b/.github/workflows/deploy-preview.yml
index 1746167a565..78ddf26baf2 100644
--- a/.github/workflows/deploy-preview.yml
+++ b/.github/workflows/deploy-preview.yml
@@ -367,6 +367,7 @@ jobs:
           NEXT_PUBLIC_COOKIE_DOMAIN: ${{ secrets.NEXT_PUBLIC_COOKIE_DOMAIN }}
           NEXT_PUBLIC_POSTHOG_KEY: ${{ secrets.NEXT_PUBLIC_POSTHOG_KEY }}
           NEXT_PUBLIC_POSTHOG_HOST: ${{ secrets.NEXT_PUBLIC_POSTHOG_HOST }}
+          NEXT_PUBLIC_OUTLIT_KEY: ${{ secrets.NEXT_PUBLIC_OUTLIT_KEY }}
           NEXT_PUBLIC_SENTRY_DSN_WEB: ${{ secrets.NEXT_PUBLIC_SENTRY_DSN_WEB }}
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
           NEXT_PUBLIC_SENTRY_ENVIRONMENT: ${{ vars.NEXT_PUBLIC_SENTRY_ENVIRONMENT }}
@@ -394,6 +395,7 @@ jobs:
             --env NEXT_PUBLIC_COOKIE_DOMAIN=$NEXT_PUBLIC_COOKIE_DOMAIN \
             --env NEXT_PUBLIC_POSTHOG_KEY=$NEXT_PUBLIC_POSTHOG_KEY \
             --env NEXT_PUBLIC_POSTHOG_HOST=$NEXT_PUBLIC_POSTHOG_HOST \
+            --env NEXT_PUBLIC_OUTLIT_KEY=$NEXT_PUBLIC_OUTLIT_KEY \
             --env NEXT_PUBLIC_SENTRY_DSN_WEB=$NEXT_PUBLIC_SENTRY_DSN_WEB \
             --env NEXT_PUBLIC_SENTRY_ENVIRONMENT=$NEXT_PUBLIC_SENTRY_ENVIRONMENT \
             --env KV_REST_API_URL=$KV_REST_API_URL \
@@ -462,6 +464,7 @@ jobs:
           NEXT_PUBLIC_COOKIE_DOMAIN: ${{ secrets.NEXT_PUBLIC_COOKIE_DOMAIN }}
           NEXT_PUBLIC_POSTHOG_KEY: ${{ secrets.NEXT_PUBLIC_POSTHOG_KEY }}
           NEXT_PUBLIC_POSTHOG_HOST: ${{ secrets.NEXT_PUBLIC_POSTHOG_HOST }}
+          NEXT_PUBLIC_OUTLIT_KEY: ${{ secrets.NEXT_PUBLIC_OUTLIT_KEY }}
           NEXT_PUBLIC_SENTRY_DSN_MARKETING: ${{ secrets.NEXT_PUBLIC_SENTRY_DSN_MARKETING }}
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
           NEXT_PUBLIC_SENTRY_ENVIRONMENT: ${{ vars.NEXT_PUBLIC_SENTRY_ENVIRONMENT }}
@@ -486,6 +489,7 @@ jobs:
             --env NEXT_PUBLIC_COOKIE_DOMAIN=$NEXT_PUBLIC_COOKIE_DOMAIN \
             --env NEXT_PUBLIC_POSTHOG_KEY=$NEXT_PUBLIC_POSTHOG_KEY \
             --env NEXT_PUBLIC_POSTHOG_HOST=$NEXT_PUBLIC_POSTHOG_HOST \
+            --env NEXT_PUBLIC_OUTLIT_KEY=$NEXT_PUBLIC_OUTLIT_KEY \
             --env NEXT_PUBLIC_SENTRY_DSN_MARKETING=$NEXT_PUBLIC_SENTRY_DSN_MARKETING \
             --env NEXT_PUBLIC_SENTRY_ENVIRONMENT=$NEXT_PUBLIC_SENTRY_ENVIRONMENT \
             --env KV_REST_API_URL=$KV_REST_API_URL \
@@ -662,6 +666,7 @@ jobs:
           NEXT_PUBLIC_MARKETING_URL: https://${{ env.MARKETING_ALIAS }}
           NEXT_PUBLIC_POSTHOG_KEY: ${{ secrets.NEXT_PUBLIC_POSTHOG_KEY }}
           NEXT_PUBLIC_POSTHOG_HOST: ${{ secrets.NEXT_PUBLIC_POSTHOG_HOST }}
+          NEXT_PUBLIC_OUTLIT_KEY: ${{ secrets.NEXT_PUBLIC_OUTLIT_KEY }}
           NEXT_PUBLIC_SENTRY_DSN_DOCS: ${{ secrets.NEXT_PUBLIC_SENTRY_DSN_DOCS }}
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
           NEXT_PUBLIC_SENTRY_ENVIRONMENT: ${{ vars.NEXT_PUBLIC_SENTRY_ENVIRONMENT }}
@@ -671,6 +676,7 @@ jobs:
           VERCEL_URL=$(vercel deploy --prebuilt --token=$VERCEL_TOKEN \
             --env NEXT_PUBLIC_POSTHOG_KEY=$NEXT_PUBLIC_POSTHOG_KEY \
             --env NEXT_PUBLIC_POSTHOG_HOST=$NEXT_PUBLIC_POSTHOG_HOST \
+            --env NEXT_PUBLIC_OUTLIT_KEY=$NEXT_PUBLIC_OUTLIT_KEY \
             --env NEXT_PUBLIC_SENTRY_DSN_DOCS=$NEXT_PUBLIC_SENTRY_DSN_DOCS \
             --env NEXT_PUBLIC_SENTRY_ENVIRONMENT=$NEXT_PUBLIC_SENTRY_ENVIRONMENT)
           vercel alias $VERCEL_URL ${{ env.DOCS_ALIAS }} --scope=$VERCEL_ORG_ID --token=$VERCEL_TOKEN
diff --git a/.github/workflows/deploy-production.yml b/.github/workflows/deploy-production.yml
index 687269d4cc9..ec4c54dd0fb 100644
--- a/.github/workflows/deploy-production.yml
+++ b/.github/workflows/deploy-production.yml
@@ -199,6 +199,7 @@ jobs:
           NEXT_PUBLIC_COOKIE_DOMAIN: ${{ secrets.NEXT_PUBLIC_COOKIE_DOMAIN }}
           NEXT_PUBLIC_POSTHOG_KEY: ${{ secrets.NEXT_PUBLIC_POSTHOG_KEY }}
           NEXT_PUBLIC_POSTHOG_HOST: ${{ secrets.NEXT_PUBLIC_POSTHOG_HOST }}
+          NEXT_PUBLIC_OUTLIT_KEY: ${{ secrets.NEXT_PUBLIC_OUTLIT_KEY }}
           NEXT_PUBLIC_SENTRY_DSN_WEB: ${{ secrets.NEXT_PUBLIC_SENTRY_DSN_WEB }}
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
           NEXT_PUBLIC_SENTRY_ENVIRONMENT: ${{ vars.NEXT_PUBLIC_SENTRY_ENVIRONMENT }}
@@ -226,6 +227,7 @@ jobs:
             --env NEXT_PUBLIC_COOKIE_DOMAIN=$NEXT_PUBLIC_COOKIE_DOMAIN \
             --env NEXT_PUBLIC_POSTHOG_KEY=$NEXT_PUBLIC_POSTHOG_KEY \
             --env NEXT_PUBLIC_POSTHOG_HOST=$NEXT_PUBLIC_POSTHOG_HOST \
+            --env NEXT_PUBLIC_OUTLIT_KEY=$NEXT_PUBLIC_OUTLIT_KEY \
             --env NEXT_PUBLIC_SENTRY_DSN_WEB=$NEXT_PUBLIC_SENTRY_DSN_WEB \
             --env NEXT_PUBLIC_SENTRY_ENVIRONMENT=$NEXT_PUBLIC_SENTRY_ENVIRONMENT \
             --env KV_REST_API_URL=$KV_REST_API_URL \
@@ -278,6 +280,7 @@ jobs:
           NEXT_PUBLIC_COOKIE_DOMAIN: ${{ secrets.NEXT_PUBLIC_COOKIE_DOMAIN }}
           NEXT_PUBLIC_POSTHOG_KEY: ${{ secrets.NEXT_PUBLIC_POSTHOG_KEY }}
           NEXT_PUBLIC_POSTHOG_HOST: ${{ secrets.NEXT_PUBLIC_POSTHOG_HOST }}
+          NEXT_PUBLIC_OUTLIT_KEY: ${{ secrets.NEXT_PUBLIC_OUTLIT_KEY }}
           NEXT_PUBLIC_SENTRY_DSN_MARKETING: ${{ secrets.NEXT_PUBLIC_SENTRY_DSN_MARKETING }}
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
           NEXT_PUBLIC_SENTRY_ENVIRONMENT: ${{ vars.NEXT_PUBLIC_SENTRY_ENVIRONMENT }}
@@ -302,6 +305,7 @@ jobs:
             --env NEXT_PUBLIC_COOKIE_DOMAIN=$NEXT_PUBLIC_COOKIE_DOMAIN \
             --env NEXT_PUBLIC_POSTHOG_KEY=$NEXT_PUBLIC_POSTHOG_KEY \
             --env NEXT_PUBLIC_POSTHOG_HOST=$NEXT_PUBLIC_POSTHOG_HOST \
+            --env NEXT_PUBLIC_OUTLIT_KEY=$NEXT_PUBLIC_OUTLIT_KEY \
             --env NEXT_PUBLIC_SENTRY_DSN_MARKETING=$NEXT_PUBLIC_SENTRY_DSN_MARKETING \
             --env NEXT_PUBLIC_SENTRY_ENVIRONMENT=$NEXT_PUBLIC_SENTRY_ENVIRONMENT \
             --env KV_REST_API_URL=$KV_REST_API_URL \
@@ -488,6 +492,7 @@ jobs:
           NEXT_PUBLIC_MARKETING_URL: ${{ secrets.NEXT_PUBLIC_MARKETING_URL }}
           NEXT_PUBLIC_POSTHOG_KEY: ${{ secrets.NEXT_PUBLIC_POSTHOG_KEY }}
           NEXT_PUBLIC_POSTHOG_HOST: ${{ secrets.NEXT_PUBLIC_POSTHOG_HOST }}
+          NEXT_PUBLIC_OUTLIT_KEY: ${{ secrets.NEXT_PUBLIC_OUTLIT_KEY }}
           NEXT_PUBLIC_SENTRY_DSN_DOCS: ${{ secrets.NEXT_PUBLIC_SENTRY_DSN_DOCS }}
           SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
           NEXT_PUBLIC_SENTRY_ENVIRONMENT: ${{ vars.NEXT_PUBLIC_SENTRY_ENVIRONMENT }}
@@ -497,5 +502,6 @@ jobs:
           vercel deploy --prod --prebuilt --token=$VERCEL_TOKEN \
             --env NEXT_PUBLIC_POSTHOG_KEY=$NEXT_PUBLIC_POSTHOG_KEY \
             --env NEXT_PUBLIC_POSTHOG_HOST=$NEXT_PUBLIC_POSTHOG_HOST \
+            --env NEXT_PUBLIC_OUTLIT_KEY=$NEXT_PUBLIC_OUTLIT_KEY \
             --env NEXT_PUBLIC_SENTRY_DSN_DOCS=$NEXT_PUBLIC_SENTRY_DSN_DOCS \
             --env NEXT_PUBLIC_SENTRY_ENVIRONMENT=$NEXT_PUBLIC_SENTRY_ENVIRONMENT

From 3b9d80e48b04adcf3837d07b2c4d243f31ceaacc Mon Sep 17 00:00:00 2001
From: Satya Patel <satyapatel111@gmail.com>
Date: Tue, 10 Feb 2026 14:37:52 -0800
Subject: [PATCH 13/20] fix: use lazy getOutlit() in Next.js apps to avoid SSR
 window crash

Outlit constructor calls enableTracking() which accesses `window`.
Module-level instantiation crashes during Next.js prerendering (SSR).
Use lazy singleton for web, marketing, and docs; desktop (Electron)
keeps module-level since it always has window.
---
 apps/docs/src/app/providers.tsx                 |  4 ++--
 apps/docs/src/lib/outlit/index.ts               | 15 +++++++++++----
 apps/marketing/src/app/providers.tsx            |  4 ++--
 .../components/CookieConsent/CookieConsent.tsx  |  6 +++---
 apps/marketing/src/lib/analytics/index.ts       |  4 ++--
 apps/marketing/src/lib/outlit/index.ts          | 17 ++++++++++++-----
 .../OutlitProvider/OutlitProvider.tsx           |  4 ++--
 apps/web/src/lib/outlit/index.ts                | 15 +++++++++++----
 8 files changed, 45 insertions(+), 24 deletions(-)

diff --git a/apps/docs/src/app/providers.tsx b/apps/docs/src/app/providers.tsx
index 96ea65b88e2..adc64c5f997 100644
--- a/apps/docs/src/app/providers.tsx
+++ b/apps/docs/src/app/providers.tsx
@@ -2,12 +2,12 @@
 
 import { OutlitProvider } from "@outlit/browser/react";
 
-import { outlit } from "@/lib/outlit";
+import { getOutlit } from "@/lib/outlit";
 
 export function OutlitProviderWrapper({
 	children,
 }: {
 	children: React.ReactNode;
 }) {
-	return <OutlitProvider client={outlit}>{children}</OutlitProvider>;
+	return <OutlitProvider client={getOutlit()}>{children}</OutlitProvider>;
 }
diff --git a/apps/docs/src/lib/outlit/index.ts b/apps/docs/src/lib/outlit/index.ts
index 774ca30249b..d2d7a15e060 100644
--- a/apps/docs/src/lib/outlit/index.ts
+++ b/apps/docs/src/lib/outlit/index.ts
@@ -2,7 +2,14 @@ import { Outlit } from "@outlit/browser";
 
 import { env } from "@/env";
 
-export const outlit = new Outlit({
-	publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
-	trackPageviews: true,
-});
+let instance: Outlit | undefined;
+
+export function getOutlit(): Outlit {
+	if (!instance) {
+		instance = new Outlit({
+			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
+			trackPageviews: true,
+		});
+	}
+	return instance;
+}
diff --git a/apps/marketing/src/app/providers.tsx b/apps/marketing/src/app/providers.tsx
index f35d04b1fae..fef6bfeae17 100644
--- a/apps/marketing/src/app/providers.tsx
+++ b/apps/marketing/src/app/providers.tsx
@@ -6,12 +6,12 @@ import { ThemeProvider } from "next-themes";
 import posthog from "posthog-js";
 import { PostHogProvider } from "posthog-js/react";
 
-import { outlit } from "@/lib/outlit";
+import { getOutlit } from "@/lib/outlit";
 
 export function Providers({ children }: { children: React.ReactNode }) {
 	return (
 		<PostHogProvider client={posthog}>
-			<OutlitBrowserProvider client={outlit}>
+			<OutlitBrowserProvider client={getOutlit()}>
 				<ThemeProvider
 					attribute="class"
 					defaultTheme="dark"
diff --git a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
index c45eda45c67..cf4c894ff42 100644
--- a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
+++ b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
@@ -7,7 +7,7 @@ import posthog from "posthog-js";
 import { useEffect, useState } from "react";
 
 import { ANALYTICS_CONSENT_KEY } from "@/lib/constants";
-import { outlit } from "@/lib/outlit";
+import { getOutlit } from "@/lib/outlit";
 
 export function CookieConsent() {
 	const [showBanner, setShowBanner] = useState(false);
@@ -23,13 +23,13 @@ export function CookieConsent() {
 		localStorage.setItem(ANALYTICS_CONSENT_KEY, "accepted");
 		setShowBanner(false);
 		posthog.opt_in_capturing();
-		outlit.enableTracking();
+		getOutlit().enableTracking();
 	};
 
 	const handleOptOut = () => {
 		localStorage.setItem(ANALYTICS_CONSENT_KEY, "declined");
 		posthog.opt_out_capturing();
-		outlit.disableTracking();
+		getOutlit().disableTracking();
 		setShowBanner(false);
 	};
 
diff --git a/apps/marketing/src/lib/analytics/index.ts b/apps/marketing/src/lib/analytics/index.ts
index 940e95e765b..47a5e8a754e 100644
--- a/apps/marketing/src/lib/analytics/index.ts
+++ b/apps/marketing/src/lib/analytics/index.ts
@@ -1,6 +1,6 @@
 import posthog from "posthog-js";
 
-import { outlit } from "@/lib/outlit";
+import { getOutlit } from "@/lib/outlit";
 
 function toOutlitProperties(
 	properties?: Record<string, unknown>,
@@ -25,5 +25,5 @@ export function track(
 	properties?: Record<string, unknown>,
 ): void {
 	posthog.capture(event, properties);
-	outlit.track(event, toOutlitProperties(properties));
+	getOutlit().track(event, toOutlitProperties(properties));
 }
diff --git a/apps/marketing/src/lib/outlit/index.ts b/apps/marketing/src/lib/outlit/index.ts
index f6a1867a268..d27b7a24b07 100644
--- a/apps/marketing/src/lib/outlit/index.ts
+++ b/apps/marketing/src/lib/outlit/index.ts
@@ -2,8 +2,15 @@ import { Outlit } from "@outlit/browser";
 
 import { env } from "@/env";
 
-export const outlit = new Outlit({
-	publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
-	trackPageviews: true,
-	trackForms: true,
-});
+let instance: Outlit | undefined;
+
+export function getOutlit(): Outlit {
+	if (!instance) {
+		instance = new Outlit({
+			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
+			trackPageviews: true,
+			trackForms: true,
+		});
+	}
+	return instance;
+}
diff --git a/apps/web/src/components/OutlitProvider/OutlitProvider.tsx b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
index 94c3819cfce..7c7e138c34c 100644
--- a/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
+++ b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
@@ -4,7 +4,7 @@ import { OutlitProvider as OutlitBrowserProvider } from "@outlit/browser/react";
 import { authClient } from "@superset/auth/client";
 import type React from "react";
 
-import { outlit } from "@/lib/outlit";
+import { getOutlit } from "@/lib/outlit";
 
 interface OutlitProviderProps {
 	children: React.ReactNode;
@@ -16,7 +16,7 @@ export function OutlitProvider({ children }: OutlitProviderProps) {
 
 	return (
 		<OutlitBrowserProvider
-			client={outlit}
+			client={getOutlit()}
 			user={
 				user
 					? {
diff --git a/apps/web/src/lib/outlit/index.ts b/apps/web/src/lib/outlit/index.ts
index 774ca30249b..d2d7a15e060 100644
--- a/apps/web/src/lib/outlit/index.ts
+++ b/apps/web/src/lib/outlit/index.ts
@@ -2,7 +2,14 @@ import { Outlit } from "@outlit/browser";
 
 import { env } from "@/env";
 
-export const outlit = new Outlit({
-	publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
-	trackPageviews: true,
-});
+let instance: Outlit | undefined;
+
+export function getOutlit(): Outlit {
+	if (!instance) {
+		instance = new Outlit({
+			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
+			trackPageviews: true,
+		});
+	}
+	return instance;
+}

From f65082b9f56032aa01a77d3bffa18c5ba27b8182 Mon Sep 17 00:00:00 2001
From: Satya Patel <satyapatel111@gmail.com>
Date: Tue, 10 Feb 2026 14:47:40 -0800
Subject: [PATCH 14/20] fix: use publicKey prop in Next.js providers for SSR
 compatibility

Outlit constructor accesses `window`, so passing a pre-built client
to providers crashes during Next.js SSR/prerendering. Switch web,
marketing, and docs providers to use the publicKey prop (the React
SDK handles SSR internally). Keep getOutlit() only for client-side
code paths (analytics track, CookieConsent via useOutlit hook).

Remove unused web and docs outlit modules.
---
 apps/docs/src/app/providers.tsx                   |  8 ++++++--
 apps/docs/src/lib/outlit/index.ts                 | 15 ---------------
 apps/marketing/src/app/providers.tsx              |  8 ++++++--
 .../components/CookieConsent/CookieConsent.tsx    |  7 ++++---
 .../components/OutlitProvider/OutlitProvider.tsx  |  5 +++--
 apps/web/src/lib/outlit/index.ts                  | 15 ---------------
 6 files changed, 19 insertions(+), 39 deletions(-)
 delete mode 100644 apps/docs/src/lib/outlit/index.ts
 delete mode 100644 apps/web/src/lib/outlit/index.ts

diff --git a/apps/docs/src/app/providers.tsx b/apps/docs/src/app/providers.tsx
index adc64c5f997..f1f28d66150 100644
--- a/apps/docs/src/app/providers.tsx
+++ b/apps/docs/src/app/providers.tsx
@@ -2,12 +2,16 @@
 
 import { OutlitProvider } from "@outlit/browser/react";
 
-import { getOutlit } from "@/lib/outlit";
+import { env } from "@/env";
 
 export function OutlitProviderWrapper({
 	children,
 }: {
 	children: React.ReactNode;
 }) {
-	return <OutlitProvider client={getOutlit()}>{children}</OutlitProvider>;
+	return (
+		<OutlitProvider publicKey={env.NEXT_PUBLIC_OUTLIT_KEY} trackPageviews>
+			{children}
+		</OutlitProvider>
+	);
 }
diff --git a/apps/docs/src/lib/outlit/index.ts b/apps/docs/src/lib/outlit/index.ts
deleted file mode 100644
index d2d7a15e060..00000000000
--- a/apps/docs/src/lib/outlit/index.ts
+++ /dev/null
@@ -1,15 +0,0 @@
-import { Outlit } from "@outlit/browser";
-
-import { env } from "@/env";
-
-let instance: Outlit | undefined;
-
-export function getOutlit(): Outlit {
-	if (!instance) {
-		instance = new Outlit({
-			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
-			trackPageviews: true,
-		});
-	}
-	return instance;
-}
diff --git a/apps/marketing/src/app/providers.tsx b/apps/marketing/src/app/providers.tsx
index fef6bfeae17..47d735dc3c6 100644
--- a/apps/marketing/src/app/providers.tsx
+++ b/apps/marketing/src/app/providers.tsx
@@ -6,12 +6,16 @@ import { ThemeProvider } from "next-themes";
 import posthog from "posthog-js";
 import { PostHogProvider } from "posthog-js/react";
 
-import { getOutlit } from "@/lib/outlit";
+import { env } from "@/env";
 
 export function Providers({ children }: { children: React.ReactNode }) {
 	return (
 		<PostHogProvider client={posthog}>
-			<OutlitBrowserProvider client={getOutlit()}>
+			<OutlitBrowserProvider
+				publicKey={env.NEXT_PUBLIC_OUTLIT_KEY}
+				trackPageviews
+				trackForms
+			>
 				<ThemeProvider
 					attribute="class"
 					defaultTheme="dark"
diff --git a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
index cf4c894ff42..8b37ecddce7 100644
--- a/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
+++ b/apps/marketing/src/components/CookieConsent/CookieConsent.tsx
@@ -1,5 +1,6 @@
 "use client";
 
+import { useOutlit } from "@outlit/browser/react";
 import { Button } from "@superset/ui/button";
 import { AnimatePresence, motion } from "framer-motion";
 import Link from "next/link";
@@ -7,9 +8,9 @@ import posthog from "posthog-js";
 import { useEffect, useState } from "react";
 
 import { ANALYTICS_CONSENT_KEY } from "@/lib/constants";
-import { getOutlit } from "@/lib/outlit";
 
 export function CookieConsent() {
+	const { enableTracking, disableTracking } = useOutlit();
 	const [showBanner, setShowBanner] = useState(false);
 
 	useEffect(() => {
@@ -23,13 +24,13 @@ export function CookieConsent() {
 		localStorage.setItem(ANALYTICS_CONSENT_KEY, "accepted");
 		setShowBanner(false);
 		posthog.opt_in_capturing();
-		getOutlit().enableTracking();
+		enableTracking();
 	};
 
 	const handleOptOut = () => {
 		localStorage.setItem(ANALYTICS_CONSENT_KEY, "declined");
 		posthog.opt_out_capturing();
-		getOutlit().disableTracking();
+		disableTracking();
 		setShowBanner(false);
 	};
 
diff --git a/apps/web/src/components/OutlitProvider/OutlitProvider.tsx b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
index 7c7e138c34c..dbf6c637510 100644
--- a/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
+++ b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
@@ -4,7 +4,7 @@ import { OutlitProvider as OutlitBrowserProvider } from "@outlit/browser/react";
 import { authClient } from "@superset/auth/client";
 import type React from "react";
 
-import { getOutlit } from "@/lib/outlit";
+import { env } from "@/env";
 
 interface OutlitProviderProps {
 	children: React.ReactNode;
@@ -16,7 +16,8 @@ export function OutlitProvider({ children }: OutlitProviderProps) {
 
 	return (
 		<OutlitBrowserProvider
-			client={getOutlit()}
+			publicKey={env.NEXT_PUBLIC_OUTLIT_KEY}
+			trackPageviews
 			user={
 				user
 					? {
diff --git a/apps/web/src/lib/outlit/index.ts b/apps/web/src/lib/outlit/index.ts
deleted file mode 100644
index d2d7a15e060..00000000000
--- a/apps/web/src/lib/outlit/index.ts
+++ /dev/null
@@ -1,15 +0,0 @@
-import { Outlit } from "@outlit/browser";
-
-import { env } from "@/env";
-
-let instance: Outlit | undefined;
-
-export function getOutlit(): Outlit {
-	if (!instance) {
-		instance = new Outlit({
-			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
-			trackPageviews: true,
-		});
-	}
-	return instance;
-}

From 1cc40773e200d4525968a7e37dc3df45184730dc Mon Sep 17 00:00:00 2001
From: Leo <omarleopaz@hotmail.com>
Date: Wed, 18 Feb 2026 22:02:36 -0800
Subject: [PATCH 15/20] fix: make NEXT_PUBLIC_OUTLIT_KEY optional to match
 existing env patterns (#1578)

Analytics keys (PostHog, Sentry) are already optional in env schemas
since CI runs builds/tests without secrets. This follows the same
pattern for the Outlit key.
---
 apps/desktop/src/main/env.main.ts         | 2 +-
 apps/desktop/src/renderer/env.renderer.ts | 2 +-
 apps/docs/src/env.ts                      | 2 +-
 apps/marketing/src/env.ts                 | 2 +-
 apps/web/src/env.ts                       | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/apps/desktop/src/main/env.main.ts b/apps/desktop/src/main/env.main.ts
index 06c573ffc69..13310a79748 100644
--- a/apps/desktop/src/main/env.main.ts
+++ b/apps/desktop/src/main/env.main.ts
@@ -21,7 +21,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_POSTHOG_HOST: z.string().default("https://us.i.posthog.com"),
 		SENTRY_DSN_DESKTOP: z.string().optional(),
 		STREAMS_URL: z.url().default("https://superset-stream.fly.dev"),
-		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
 	},
 
 	runtimeEnv: {
diff --git a/apps/desktop/src/renderer/env.renderer.ts b/apps/desktop/src/renderer/env.renderer.ts
index 548afa77cfa..52c23249a67 100644
--- a/apps/desktop/src/renderer/env.renderer.ts
+++ b/apps/desktop/src/renderer/env.renderer.ts
@@ -19,7 +19,7 @@ const envSchema = z.object({
 	NEXT_PUBLIC_WEB_URL: z.url().default("https://app.superset.sh"),
 	NEXT_PUBLIC_POSTHOG_KEY: z.string().optional(),
 	NEXT_PUBLIC_POSTHOG_HOST: z.string().default("https://us.i.posthog.com"),
-	NEXT_PUBLIC_OUTLIT_KEY: z.string(),
+	NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
 	SENTRY_DSN_DESKTOP: z.string().optional(),
 });
 
diff --git a/apps/docs/src/env.ts b/apps/docs/src/env.ts
index 2ee1b8cdb06..d972eb3072c 100644
--- a/apps/docs/src/env.ts
+++ b/apps/docs/src/env.ts
@@ -21,7 +21,7 @@ export const env = createEnv({
 
 	client: {
 		NEXT_PUBLIC_MARKETING_URL: z.string().url().optional(),
-		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
 		NEXT_PUBLIC_POSTHOG_KEY: z.string().optional(),
 		NEXT_PUBLIC_POSTHOG_HOST: z.string().url().optional(),
 		NEXT_PUBLIC_SENTRY_DSN_DOCS: z.string().optional(),
diff --git a/apps/marketing/src/env.ts b/apps/marketing/src/env.ts
index fa40cf82f57..aea10c322f3 100644
--- a/apps/marketing/src/env.ts
+++ b/apps/marketing/src/env.ts
@@ -30,7 +30,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_SENTRY_ENVIRONMENT: z
 			.enum(["development", "preview", "production"])
 			.optional(),
-		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
 	},
 	experimental__runtimeEnv: {
 		NODE_ENV: process.env.NODE_ENV,
diff --git a/apps/web/src/env.ts b/apps/web/src/env.ts
index f502acf671a..cd2c98944c0 100644
--- a/apps/web/src/env.ts
+++ b/apps/web/src/env.ts
@@ -36,7 +36,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_SENTRY_ENVIRONMENT: z
 			.enum(["development", "preview", "production"])
 			.optional(),
-		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
 	},
 
 	experimental__runtimeEnv: {

From c9fab414ffb420521889c7a1a3c5b741431263e6 Mon Sep 17 00:00:00 2001
From: Satya Patel <satyapatel111@gmail.com>
Date: Mon, 2 Mar 2026 17:23:27 -0800
Subject: [PATCH 16/20] fix: make NEXT_PUBLIC_OUTLIT_KEY required across all
 apps

---
 apps/desktop/src/main/env.main.ts                         | 2 +-
 apps/desktop/src/renderer/env.renderer.ts                 | 2 +-
 apps/docs/src/env.ts                                      | 2 +-
 apps/marketing/src/env.ts                                 | 2 +-
 apps/web/src/components/OutlitProvider/OutlitProvider.tsx | 1 -
 apps/web/src/env.ts                                       | 2 +-
 6 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/apps/desktop/src/main/env.main.ts b/apps/desktop/src/main/env.main.ts
index 81a3bb355fb..0665cd1a1bd 100644
--- a/apps/desktop/src/main/env.main.ts
+++ b/apps/desktop/src/main/env.main.ts
@@ -24,7 +24,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_POSTHOG_HOST: z.string().default("https://us.i.posthog.com"),
 		SENTRY_DSN_DESKTOP: z.string().optional(),
 		STREAMS_URL: z.url().default("https://superset-stream.fly.dev"),
-		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
 	},
 
 	runtimeEnv: {
diff --git a/apps/desktop/src/renderer/env.renderer.ts b/apps/desktop/src/renderer/env.renderer.ts
index eb30a6b4bb1..8c38108f8e7 100644
--- a/apps/desktop/src/renderer/env.renderer.ts
+++ b/apps/desktop/src/renderer/env.renderer.ts
@@ -22,7 +22,7 @@ const envSchema = z.object({
 		.default("https://api.superset.sh/api/electric"),
 	NEXT_PUBLIC_POSTHOG_KEY: z.string().optional(),
 	NEXT_PUBLIC_POSTHOG_HOST: z.string().default("https://us.i.posthog.com"),
-	NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
+	NEXT_PUBLIC_OUTLIT_KEY: z.string(),
 	SENTRY_DSN_DESKTOP: z.string().optional(),
 });
 
diff --git a/apps/docs/src/env.ts b/apps/docs/src/env.ts
index 82aaab14ead..594d8c54822 100644
--- a/apps/docs/src/env.ts
+++ b/apps/docs/src/env.ts
@@ -16,7 +16,7 @@ export const env = createEnv({
 
 	client: {
 		NEXT_PUBLIC_MARKETING_URL: z.string().url().optional(),
-		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
 		NEXT_PUBLIC_POSTHOG_KEY: z.string().optional(),
 		NEXT_PUBLIC_POSTHOG_HOST: z.string().url().optional(),
 		NEXT_PUBLIC_SENTRY_DSN_DOCS: z.string().optional(),
diff --git a/apps/marketing/src/env.ts b/apps/marketing/src/env.ts
index b62462a5014..37fb9b27aa1 100644
--- a/apps/marketing/src/env.ts
+++ b/apps/marketing/src/env.ts
@@ -31,7 +31,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_SENTRY_ENVIRONMENT: z
 			.enum(["development", "preview", "production"])
 			.optional(),
-		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
 	},
 	experimental__runtimeEnv: {
 		NODE_ENV: process.env.NODE_ENV,
diff --git a/apps/web/src/components/OutlitProvider/OutlitProvider.tsx b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
index dbf6c637510..f8f43db564b 100644
--- a/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
+++ b/apps/web/src/components/OutlitProvider/OutlitProvider.tsx
@@ -13,7 +13,6 @@ interface OutlitProviderProps {
 export function OutlitProvider({ children }: OutlitProviderProps) {
 	const { data: session } = authClient.useSession();
 	const user = session?.user;
-
 	return (
 		<OutlitBrowserProvider
 			publicKey={env.NEXT_PUBLIC_OUTLIT_KEY}
diff --git a/apps/web/src/env.ts b/apps/web/src/env.ts
index b7f7dd45a6b..f360430bb19 100644
--- a/apps/web/src/env.ts
+++ b/apps/web/src/env.ts
@@ -37,7 +37,7 @@ export const env = createEnv({
 		NEXT_PUBLIC_SENTRY_ENVIRONMENT: z
 			.enum(["development", "preview", "production"])
 			.optional(),
-		NEXT_PUBLIC_OUTLIT_KEY: z.string().optional(),
+		NEXT_PUBLIC_OUTLIT_KEY: z.string(),
 	},
 
 	experimental__runtimeEnv: {

From 4e6dd2c942f2d2c921699ff673a03b0ac32390fc Mon Sep 17 00:00:00 2001
From: Satya Patel <satyapatel111@gmail.com>
Date: Mon, 2 Mar 2026 17:34:25 -0800
Subject: [PATCH 17/20] ci: add NEXT_PUBLIC_OUTLIT_KEY to CI and desktop build
 workflows

---
 .github/workflows/build-desktop.yml | 2 ++
 .github/workflows/ci.yml            | 4 ++++
 2 files changed, 6 insertions(+)

diff --git a/.github/workflows/build-desktop.yml b/.github/workflows/build-desktop.yml
index f62b6de29f4..9f1d7d400bb 100644
--- a/.github/workflows/build-desktop.yml
+++ b/.github/workflows/build-desktop.yml
@@ -86,6 +86,7 @@ jobs:
         env:
           NEXT_PUBLIC_POSTHOG_KEY: ${{ secrets.NEXT_PUBLIC_POSTHOG_KEY }}
           NEXT_PUBLIC_POSTHOG_HOST: ${{ secrets.NEXT_PUBLIC_POSTHOG_HOST }}
+          NEXT_PUBLIC_OUTLIT_KEY: ${{ secrets.NEXT_PUBLIC_OUTLIT_KEY }}
           GOOGLE_CLIENT_ID: ${{ secrets.GOOGLE_CLIENT_ID }}
           GH_CLIENT_ID: ${{ secrets.GH_CLIENT_ID }}
           NEXT_PUBLIC_WEB_URL: ${{ secrets.NEXT_PUBLIC_WEB_URL }}
@@ -190,6 +191,7 @@ jobs:
         env:
           NEXT_PUBLIC_POSTHOG_KEY: ${{ secrets.NEXT_PUBLIC_POSTHOG_KEY }}
           NEXT_PUBLIC_POSTHOG_HOST: ${{ secrets.NEXT_PUBLIC_POSTHOG_HOST }}
+          NEXT_PUBLIC_OUTLIT_KEY: ${{ secrets.NEXT_PUBLIC_OUTLIT_KEY }}
           GOOGLE_CLIENT_ID: ${{ secrets.GOOGLE_CLIENT_ID }}
           GH_CLIENT_ID: ${{ secrets.GH_CLIENT_ID }}
           NEXT_PUBLIC_WEB_URL: ${{ secrets.NEXT_PUBLIC_WEB_URL }}
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index b7f747b7f45..3bf16358bbf 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -77,6 +77,8 @@ jobs:
         run: bun install --frozen
 
       - name: Test
+        env:
+          NEXT_PUBLIC_OUTLIT_KEY: ${{ secrets.NEXT_PUBLIC_OUTLIT_KEY }}
         run: bun run test
 
   typecheck:
@@ -125,4 +127,6 @@ jobs:
         run: bun install --frozen
 
       - name: Build Desktop
+        env:
+          NEXT_PUBLIC_OUTLIT_KEY: ${{ secrets.NEXT_PUBLIC_OUTLIT_KEY }}
         run: bun turbo run build --filter=@superset/desktop

From 12c6b5891757d490484f177ef4cc73a7a9d20880 Mon Sep 17 00:00:00 2001
From: Satya Patel <satyapatel111@gmail.com>
Date: Mon, 2 Mar 2026 18:01:33 -0800
Subject: [PATCH 18/20] fix(marketing): share single Outlit instance so consent
 opt-out gates all tracking

---
 apps/marketing/src/app/providers.tsx   | 8 ++------
 apps/marketing/src/lib/outlit/index.ts | 9 +++++++++
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/apps/marketing/src/app/providers.tsx b/apps/marketing/src/app/providers.tsx
index 47d735dc3c6..fef6bfeae17 100644
--- a/apps/marketing/src/app/providers.tsx
+++ b/apps/marketing/src/app/providers.tsx
@@ -6,16 +6,12 @@ import { ThemeProvider } from "next-themes";
 import posthog from "posthog-js";
 import { PostHogProvider } from "posthog-js/react";
 
-import { env } from "@/env";
+import { getOutlit } from "@/lib/outlit";
 
 export function Providers({ children }: { children: React.ReactNode }) {
 	return (
 		<PostHogProvider client={posthog}>
-			<OutlitBrowserProvider
-				publicKey={env.NEXT_PUBLIC_OUTLIT_KEY}
-				trackPageviews
-				trackForms
-			>
+			<OutlitBrowserProvider client={getOutlit()}>
 				<ThemeProvider
 					attribute="class"
 					defaultTheme="dark"
diff --git a/apps/marketing/src/lib/outlit/index.ts b/apps/marketing/src/lib/outlit/index.ts
index d27b7a24b07..3b916149400 100644
--- a/apps/marketing/src/lib/outlit/index.ts
+++ b/apps/marketing/src/lib/outlit/index.ts
@@ -1,6 +1,7 @@
 import { Outlit } from "@outlit/browser";
 
 import { env } from "@/env";
+import { ANALYTICS_CONSENT_KEY } from "@/lib/constants";
 
 let instance: Outlit | undefined;
 
@@ -11,6 +12,14 @@ export function getOutlit(): Outlit {
 			trackPageviews: true,
 			trackForms: true,
 		});
+
+		// Respect prior consent choice — disable tracking if user previously opted out
+		if (
+			typeof window !== "undefined" &&
+			localStorage.getItem(ANALYTICS_CONSENT_KEY) === "declined"
+		) {
+			instance.disableTracking();
+		}
 	}
 	return instance;
 }

From b407c4b4683c13f5ba4419094fa68ddbd44673d0 Mon Sep 17 00:00:00 2001
From: Satya Patel <satyapatel111@gmail.com>
Date: Mon, 2 Mar 2026 18:38:50 -0800
Subject: [PATCH 19/20] fix(marketing): guard Outlit construction against SSR
 (window is not defined)

---
 apps/marketing/src/app/providers.tsx      | 10 ++++++++--
 apps/marketing/src/lib/analytics/index.ts |  2 +-
 apps/marketing/src/lib/outlit/index.ts    |  9 ++++-----
 3 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/apps/marketing/src/app/providers.tsx b/apps/marketing/src/app/providers.tsx
index fef6bfeae17..a3c35454ad9 100644
--- a/apps/marketing/src/app/providers.tsx
+++ b/apps/marketing/src/app/providers.tsx
@@ -8,10 +8,16 @@ import { PostHogProvider } from "posthog-js/react";
 
 import { getOutlit } from "@/lib/outlit";
 
+function OutlitWrapper({ children }: { children: React.ReactNode }) {
+	const client = getOutlit();
+	if (!client) return <>{children}</>;
+	return <OutlitBrowserProvider client={client}>{children}</OutlitBrowserProvider>;
+}
+
 export function Providers({ children }: { children: React.ReactNode }) {
 	return (
 		<PostHogProvider client={posthog}>
-			<OutlitBrowserProvider client={getOutlit()}>
+			<OutlitWrapper>
 				<ThemeProvider
 					attribute="class"
 					defaultTheme="dark"
@@ -21,7 +27,7 @@ export function Providers({ children }: { children: React.ReactNode }) {
 				>
 					{children}
 				</ThemeProvider>
-			</OutlitBrowserProvider>
+			</OutlitWrapper>
 		</PostHogProvider>
 	);
 }
diff --git a/apps/marketing/src/lib/analytics/index.ts b/apps/marketing/src/lib/analytics/index.ts
index 47a5e8a754e..34b54c719ef 100644
--- a/apps/marketing/src/lib/analytics/index.ts
+++ b/apps/marketing/src/lib/analytics/index.ts
@@ -25,5 +25,5 @@ export function track(
 	properties?: Record<string, unknown>,
 ): void {
 	posthog.capture(event, properties);
-	getOutlit().track(event, toOutlitProperties(properties));
+	getOutlit()?.track(event, toOutlitProperties(properties));
 }
diff --git a/apps/marketing/src/lib/outlit/index.ts b/apps/marketing/src/lib/outlit/index.ts
index 3b916149400..232f0505338 100644
--- a/apps/marketing/src/lib/outlit/index.ts
+++ b/apps/marketing/src/lib/outlit/index.ts
@@ -5,7 +5,9 @@ import { ANALYTICS_CONSENT_KEY } from "@/lib/constants";
 
 let instance: Outlit | undefined;
 
-export function getOutlit(): Outlit {
+export function getOutlit(): Outlit | undefined {
+	if (typeof window === "undefined") return undefined;
+
 	if (!instance) {
 		instance = new Outlit({
 			publicKey: env.NEXT_PUBLIC_OUTLIT_KEY,
@@ -14,10 +16,7 @@ export function getOutlit(): Outlit {
 		});
 
 		// Respect prior consent choice — disable tracking if user previously opted out
-		if (
-			typeof window !== "undefined" &&
-			localStorage.getItem(ANALYTICS_CONSENT_KEY) === "declined"
-		) {
+		if (localStorage.getItem(ANALYTICS_CONSENT_KEY) === "declined") {
 			instance.disableTracking();
 		}
 	}

From 80bfd83e79d1bfd620a01300a65b433b79e2ae58 Mon Sep 17 00:00:00 2001
From: Satya Patel <satyapatel111@gmail.com>
Date: Mon, 2 Mar 2026 18:52:00 -0800
Subject: [PATCH 20/20] style(marketing): fix biome formatting

---
 apps/marketing/src/app/providers.tsx | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/apps/marketing/src/app/providers.tsx b/apps/marketing/src/app/providers.tsx
index a3c35454ad9..432249e31aa 100644
--- a/apps/marketing/src/app/providers.tsx
+++ b/apps/marketing/src/app/providers.tsx
@@ -11,7 +11,9 @@ import { getOutlit } from "@/lib/outlit";
 function OutlitWrapper({ children }: { children: React.ReactNode }) {
 	const client = getOutlit();
 	if (!client) return <>{children}</>;
-	return <OutlitBrowserProvider client={client}>{children}</OutlitBrowserProvider>;
+	return (
+		<OutlitBrowserProvider client={client}>{children}</OutlitBrowserProvider>
+	);
 }
 
 export function Providers({ children }: { children: React.ReactNode }) {