From 926d6652796e6cecb4ff7d7ed91ba3b21a2297f7 Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Mon, 26 Jan 2026 10:07:10 -0800
Subject: [PATCH 1/2] fix(docs): separate local and blob asset resolution for
 quick-reference

ActionImage now uses local paths directly for PNGs while ActionVideo
uses blob storage with proper path normalization (strips static/ prefix).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 apps/docs/components/ui/action-media.tsx | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/apps/docs/components/ui/action-media.tsx b/apps/docs/components/ui/action-media.tsx
index 13c9063687..1c018757db 100644
--- a/apps/docs/components/ui/action-media.tsx
+++ b/apps/docs/components/ui/action-media.tsx
@@ -12,8 +12,19 @@ interface ActionVideoProps {
   alt: string
 }
 
+/**
+ * Normalize path for blob storage
+ * - Strips leading slash
+ * - Strips 'static/' prefix
+ */
+function normalizeBlobPath(src: string): string {
+  let path = src.startsWith('/') ? src.slice(1) : src
+  path = path.replace(/^static\//, '')
+  return path
+}
+
 export function ActionImage({ src, alt }: ActionImageProps) {
-  const resolvedSrc = getAssetUrl(src.startsWith('/') ? src.slice(1) : src)
+  const resolvedSrc = src.startsWith('/') ? src : `/${src}`
 
   return (
     <img
@@ -25,7 +36,7 @@ export function ActionImage({ src, alt }: ActionImageProps) {
 }
 
 export function ActionVideo({ src, alt }: ActionVideoProps) {
-  const resolvedSrc = getAssetUrl(src.startsWith('/') ? src.slice(1) : src)
+  const resolvedSrc = getAssetUrl(normalizeBlobPath(src))
 
   return (
     <video

From b04f8ca3442df266d1f147441b3d344aa6b43705 Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Mon, 26 Jan 2026 10:11:32 -0800
Subject: [PATCH 2/2] refactor(docs): simplify asset resolution by using
 correct paths directly

Remove path normalization logic from action-media component. Instead,
use the appropriate paths in MDX:
- PNGs: /static/quick-reference/... (local)
- MP4s: quick-reference/... (blob via getAssetUrl)
---
 apps/docs/components/ui/action-media.tsx      | 17 +--------
 .../content/docs/en/quick-reference/index.mdx | 38 +++++++++----------
 2 files changed, 21 insertions(+), 34 deletions(-)

diff --git a/apps/docs/components/ui/action-media.tsx b/apps/docs/components/ui/action-media.tsx
index 1c018757db..1f187fb906 100644
--- a/apps/docs/components/ui/action-media.tsx
+++ b/apps/docs/components/ui/action-media.tsx
@@ -12,23 +12,10 @@ interface ActionVideoProps {
   alt: string
 }
 
-/**
- * Normalize path for blob storage
- * - Strips leading slash
- * - Strips 'static/' prefix
- */
-function normalizeBlobPath(src: string): string {
-  let path = src.startsWith('/') ? src.slice(1) : src
-  path = path.replace(/^static\//, '')
-  return path
-}
-
 export function ActionImage({ src, alt }: ActionImageProps) {
-  const resolvedSrc = src.startsWith('/') ? src : `/${src}`
-
   return (
     <img
-      src={resolvedSrc}
+      src={src}
       alt={alt}
       className='inline-block w-full max-w-[200px] rounded border border-neutral-200 dark:border-neutral-700'
     />
@@ -36,7 +23,7 @@ export function ActionImage({ src, alt }: ActionImageProps) {
 }
 
 export function ActionVideo({ src, alt }: ActionVideoProps) {
-  const resolvedSrc = getAssetUrl(normalizeBlobPath(src))
+  const resolvedSrc = getAssetUrl(src)
 
   return (
     <video
diff --git a/apps/docs/content/docs/en/quick-reference/index.mdx b/apps/docs/content/docs/en/quick-reference/index.mdx
index e0996d0b18..85ca46867e 100644
--- a/apps/docs/content/docs/en/quick-reference/index.mdx
+++ b/apps/docs/content/docs/en/quick-reference/index.mdx
@@ -22,17 +22,17 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     <tr>
       <td>Create a workspace</td>
       <td>Click workspace dropdown → **New Workspace**</td>
-      <td><ActionVideo src="/static/quick-reference/create-workspace.mp4" alt="Create workspace" /></td>
+      <td><ActionVideo src="quick-reference/create-workspace.mp4" alt="Create workspace" /></td>
     </tr>
     <tr>
       <td>Switch workspaces</td>
       <td>Click workspace dropdown → Select workspace</td>
-      <td><ActionVideo src="/static/quick-reference/switch-workspace.mp4" alt="Switch workspaces" /></td>
+      <td><ActionVideo src="quick-reference/switch-workspace.mp4" alt="Switch workspaces" /></td>
     </tr>
     <tr>
       <td>Invite team members</td>
       <td>Sidebar → **Invite**</td>
-      <td><ActionVideo src="/static/quick-reference/invite.mp4" alt="Invite team members" /></td>
+      <td><ActionVideo src="quick-reference/invite.mp4" alt="Invite team members" /></td>
     </tr>
     <tr>
       <td>Rename a workspace</td>
@@ -69,7 +69,7 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     <tr>
       <td>Reorder / move workflows</td>
       <td>Drag workflow up/down or onto a folder</td>
-      <td><ActionVideo src="/static/quick-reference/reordering.mp4" alt="Reorder workflows" /></td>
+      <td><ActionVideo src="quick-reference/reordering.mp4" alt="Reorder workflows" /></td>
     </tr>
     <tr>
       <td>Import a workflow</td>
@@ -79,7 +79,7 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     <tr>
       <td>Multi-select workflows</td>
       <td>`Mod+Click` or `Shift+Click` workflows in sidebar</td>
-      <td><ActionVideo src="/static/quick-reference/multiselect.mp4" alt="Multi-select workflows" /></td>
+      <td><ActionVideo src="quick-reference/multiselect.mp4" alt="Multi-select workflows" /></td>
     </tr>
     <tr>
       <td>Open in new tab</td>
@@ -144,17 +144,17 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     <tr>
       <td>Add a block</td>
       <td>Drag from Toolbar panel, or right-click canvas → **Add Block**</td>
-      <td><ActionVideo src="/static/quick-reference/add-block.mp4" alt="Add a block" /></td>
+      <td><ActionVideo src="quick-reference/add-block.mp4" alt="Add a block" /></td>
     </tr>
     <tr>
       <td>Multi-select blocks</td>
       <td>`Mod+Click` additional blocks, or shift-drag to draw selection box</td>
-      <td><ActionVideo src="/static/quick-reference/multiselect-blocks.mp4" alt="Multi-select blocks" /></td>
+      <td><ActionVideo src="quick-reference/multiselect-blocks.mp4" alt="Multi-select blocks" /></td>
     </tr>
     <tr>
       <td>Copy blocks</td>
       <td>`Mod+C` with blocks selected</td>
-      <td rowSpan={2}><ActionVideo src="/static/quick-reference/copy-paste.mp4" alt="Copy and paste blocks" /></td>
+      <td rowSpan={2}><ActionVideo src="quick-reference/copy-paste.mp4" alt="Copy and paste blocks" /></td>
     </tr>
     <tr>
       <td>Paste blocks</td>
@@ -163,7 +163,7 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     <tr>
       <td>Duplicate blocks</td>
       <td>Right-click → **Duplicate**</td>
-      <td><ActionVideo src="/static/quick-reference/duplicate-block.mp4" alt="Duplicate blocks" /></td>
+      <td><ActionVideo src="quick-reference/duplicate-block.mp4" alt="Duplicate blocks" /></td>
     </tr>
     <tr>
       <td>Delete blocks</td>
@@ -173,7 +173,7 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     <tr>
       <td>Rename a block</td>
       <td>Click block name in header, or edit in the Editor panel</td>
-      <td><ActionVideo src="/static/quick-reference/rename-block.mp4" alt="Rename a block" /></td>
+      <td><ActionVideo src="quick-reference/rename-block.mp4" alt="Rename a block" /></td>
     </tr>
     <tr>
       <td>Enable/Disable a block</td>
@@ -183,12 +183,12 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     <tr>
       <td>Toggle handle orientation</td>
       <td>Right-click → **Toggle Handles**</td>
-      <td><ActionVideo src="/static/quick-reference/toggle-handles.mp4" alt="Toggle handle orientation" /></td>
+      <td><ActionVideo src="quick-reference/toggle-handles.mp4" alt="Toggle handle orientation" /></td>
     </tr>
     <tr>
       <td>Configure a block</td>
       <td>Select block → use Editor panel on right</td>
-      <td><ActionVideo src="/static/quick-reference/configure-block.mp4" alt="Configure a block" /></td>
+      <td><ActionVideo src="quick-reference/configure-block.mp4" alt="Configure a block" /></td>
     </tr>
   </tbody>
 </table>
@@ -203,17 +203,17 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     <tr>
       <td>Create a connection</td>
       <td>Drag from output handle to input handle</td>
-      <td><ActionVideo src="/static/quick-reference/connect-blocks.mp4" alt="Connect blocks" /></td>
+      <td><ActionVideo src="quick-reference/connect-blocks.mp4" alt="Connect blocks" /></td>
     </tr>
     <tr>
       <td>Delete a connection</td>
       <td>Click edge to select → `Delete` key</td>
-      <td><ActionVideo src="/static/quick-reference/delete-connection.mp4" alt="Delete connection" /></td>
+      <td><ActionVideo src="quick-reference/delete-connection.mp4" alt="Delete connection" /></td>
     </tr>
     <tr>
       <td>Use output in another block</td>
       <td>Drag connection tag into input field</td>
-      <td><ActionVideo src="/static/quick-reference/connection-tag.mp4" alt="Use connection tag" /></td>
+      <td><ActionVideo src="quick-reference/connection-tag.mp4" alt="Use connection tag" /></td>
     </tr>
   </tbody>
 </table>
@@ -228,7 +228,7 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     <tr>
       <td>Search toolbar</td>
       <td>`Mod+F`</td>
-      <td><ActionVideo src="/static/quick-reference/search-toolbar.mp4" alt="Search toolbar" /></td>
+      <td><ActionVideo src="quick-reference/search-toolbar.mp4" alt="Search toolbar" /></td>
     </tr>
     <tr>
       <td>Search everything</td>
@@ -243,7 +243,7 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     <tr>
       <td>Collapse/expand sidebar</td>
       <td>Click collapse button on sidebar</td>
-      <td><ActionVideo src="/static/quick-reference/collapse-sidebar.mp4" alt="Collapse sidebar" /></td>
+      <td><ActionVideo src="quick-reference/collapse-sidebar.mp4" alt="Collapse sidebar" /></td>
     </tr>
   </tbody>
 </table>
@@ -337,7 +337,7 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     </tr>
     <tr>
       <td>Copy API endpoint</td>
-      <td>Deploy tab → Copy API endpoint URL</td>
+      <td>Deploy tab → API → Copy API cURL</td>
       <td><ActionImage src="/static/quick-reference/copy-api.png" alt="Copy API endpoint" /></td>
     </tr>
   </tbody>
@@ -367,7 +367,7 @@ A quick lookup for everyday actions in the Sim workflow editor. For keyboard sho
     </tr>
     <tr>
       <td>Reference an environment variable</td>
-      <td>Use `&#123;&#123;ENV_VAR&#125;&#125;` syntax in block inputs</td>
+      <td>Use `{{ENV_VAR}}` syntax in block inputs</td>
       <td><ActionImage src="/static/quick-reference/env-variable-reference.png" alt="Reference environment variable" /></td>
     </tr>
   </tbody>