diff --git a/.woodpecker/e2e.yml b/.woodpecker/e2e.yml
index 8b07670..a9b09e9 100644
--- a/.woodpecker/e2e.yml
+++ b/.woodpecker/e2e.yml
@@ -204,6 +204,19 @@ services:
           echo "@harb/web3 linked with wagmi/viem deps"
         fi
 
+        # Overlay @harb/utils shared package from workspace
+        if [ -d "$WS/packages/utils" ]; then
+          mkdir -p /app/packages/utils
+          cp -r "$WS/packages/utils/." /app/packages/utils/
+          # Link @harb/utils into web-app node_modules
+          mkdir -p /app/web-app/node_modules/@harb
+          ln -sf /app/packages/utils /app/web-app/node_modules/@harb/utils
+          # Symlink viem into packages dir so @harb/utils can resolve it
+          mkdir -p /app/packages/utils/node_modules
+          ln -sf /app/web-app/node_modules/viem /app/packages/utils/node_modules/viem
+          echo "@harb/utils linked with viem dep"
+        fi
+
         echo "=== Starting webapp (pre-built image + source overlay) ==="
         cd /app/web-app
         # Explicitly set CI=true to disable Vue DevTools in vite.config.ts