From 2390bf8917e148e70c843d52661777948a96d855 Mon Sep 17 00:00:00 2001
From: dvloper-serena <spancu@dvloper.io>
Date: Fri, 29 Aug 2025 22:41:37 +0300
Subject: [PATCH] Add workflow failure tips (#2794)

Co-authored-by: ellipsis-dev[bot] <65095814+ellipsis-dev[bot]@users.noreply.github.com>
Co-authored-by: Shuchang Zheng <shu@skyvern.com>
Co-authored-by: Shuchang Zheng <wintonzheng0325@gmail.com>
---
 .../src/routes/workflows/WorkflowRun.tsx      | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/skyvern-frontend/src/routes/workflows/WorkflowRun.tsx b/skyvern-frontend/src/routes/workflows/WorkflowRun.tsx
index 42d1efb2..ceceaf72 100644
--- a/skyvern-frontend/src/routes/workflows/WorkflowRun.tsx
+++ b/skyvern-frontend/src/routes/workflows/WorkflowRun.tsx
@@ -117,6 +117,26 @@ function WorkflowRun() {
     </h1>
   );
 
+  const failureTips: { match: (reason: string) => boolean; tip: string }[] = [
+    {
+      match: (reason) => reason.includes("Invalid master password"),
+      tip: "Tip: If inputting the master password via Docker Compose or in any container environment, make sure to double any dollar signs and do not surround it with quotes.",
+    },
+    // Add more tips as needed
+  ];
+
+  const failureReason = workflowRun?.failure_reason;
+
+  const matchedTips = failureReason
+    ? failureTips
+        .filter(({ match }) => match(failureReason))
+        .map(({ tip }, index) => (
+          <div key={index} className="text-sm italic text-red-700">
+            {tip}
+          </div>
+        ))
+    : null;
+
   const workflowFailureReason = workflowRun?.failure_reason ? (
     <div
       className="space-y-2 rounded-md border border-red-600 p-4"
@@ -126,6 +146,7 @@ function WorkflowRun() {
     >
       <div className="font-bold">Workflow Failure Reason</div>
       <div className="text-sm">{workflowRun.failure_reason}</div>
+      {matchedTips}
     </div>
   ) : null;