From 2f59cd0c7351f9c738bff4b49fe7e5baf3fb719b Mon Sep 17 00:00:00 2001
From: "blink-so[bot]" <211532188+blink-so[bot]@users.noreply.github.com>
Date: Wed, 18 Jun 2025 19:34:39 +0500
Subject: [PATCH] fix: improve JetBrains error message to mention Toolbox
 requirement (#18294)

Co-authored-by: blink-so[bot] <211532188+blink-so[bot]@users.noreply.github.com>
Co-authored-by: kylecarbs <7122116+kylecarbs@users.noreply.github.com>
---
 site/src/modules/apps/useAppLink.ts | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/site/src/modules/apps/useAppLink.ts b/site/src/modules/apps/useAppLink.ts
index efaab474e6..aafd048a7e 100644
--- a/site/src/modules/apps/useAppLink.ts
+++ b/site/src/modules/apps/useAppLink.ts
@@ -50,7 +50,19 @@ export const useAppLink = (
 			// an error message will be displayed.
 			const openAppExternallyFailedTimeout = 500;
 			const openAppExternallyFailed = setTimeout(() => {
-				displayError(`${label} must be installed first.`);
+				// Check if this is a JetBrains IDE app
+				const isJetBrainsApp =
+					app.url &&
+					(app.url.startsWith("jetbrains-gateway:") ||
+						app.url.startsWith("jetbrains:"));
+
+				if (isJetBrainsApp) {
+					displayError(
+						`To use ${label}, you need to have JetBrains Toolbox installed.`,
+					);
+				} else {
+					displayError(`${label} must be installed first.`);
+				}
 			}, openAppExternallyFailedTimeout);
 			window.addEventListener("blur", () => {
 				clearTimeout(openAppExternallyFailed);