diff --git a/src-tauri/scripts/run.sh b/src-tauri/scripts/run.sh
new file mode 100755
index 0000000..6b70c52
--- /dev/null
+++ b/src-tauri/scripts/run.sh
@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Disable WebKit’s DMA-BUF path to avoid GBM/Wayland errors
+export WEBKIT_DISABLE_DMABUF_RENDERER=1
+
+# (Optional) force Wayland or X11 if you ever need it:
+# export GDK_BACKEND=wayland
+# export GDK_BACKEND=x11
+
+# Launch your app
+exec cargo run "$@"
+