Implements #514. That discussion hasn't been answered yet, so treat this as the concrete version of the proposal rather than something agreed — happy to reshape it or close it if you'd rather the key looked different.

🎯 Changes

sourceAction: "ide-warp" requests __tsd/open-source?source=…, which only @tanstack/devtools-vite serves. Anything else that injects data-tsd-source — an SWC plugin under Next.js, in my case — lights the overlay up correctly but has no endpoint to answer the click, and fetch(...).catch(() => {}) hides the 404, so an inspect click is indistinguishable from a click that did nothing.

New config key, alongside sourceAction:

<TanStackDevtools
  config={{
    openSourceUrl: (source) => `/api/open-editor?at=${encodeURIComponent(source)}`,
  }}
/>

Two decisions worth flagging, both arguable:

The whole URL, not just its base. Another host generally wants another parameter shape — Next's own editor endpoint takes the position split into file, line1, column1, not the packed path:line:column. A configurable base would still leave that host with no route.

A function, not a string. Settings are persisted to local storage and take priority over config on the next load, so a string would keep serving whatever the app was configured with the first time it ran, ignoring later changes. JSON.stringify drops functions, so this key stays out of storage the way customTrigger already does. Confirmed in the browser: changed a setting in the panel to force a settings write, and openSourceUrl is absent from the 14 keys in tanstack_devtools_settings while the click still routes correctly after a reload.

Unset, the Vite endpoint is used exactly as before, BASE_URL included. Ignored under sourceAction: "copy-path", which makes no request.

Verification — pnpm test:pr equivalent green (84/84 affected tasks). Four unit tests in source-inspector.test.tsx cover the default URL, a path, an absolute URL, and the copy-path case. Exercised end to end in examples/react/basic with the Next-shaped builder above: the inspect click issued GET /__nextjs_launch-editor?file=%2Fsrc%2Findex.tsx&line1=191&column1=15 instead of __tsd/open-source.

Independent of #516 — different part of the file. Whichever lands second, I'll rebase.

✅ Checklist

• I have followed the steps in the Contributing guide.
• I have tested this code locally with pnpm test:pr.

🚀 Release Impact

• This change affects published code, and I have generated a changeset.

Summary by CodeRabbit

• New Features

  • Added an optional openSourceUrl setting to customize where source-inspector links open files.
  • Supports relative paths, absolute URLs, and custom editor or framework endpoints.
  • Retains the default Vite source-opening behavior when no custom URL is configured.

• Documentation

  • Added configuration guidance and examples for non-Vite setups, including Next.js.
  • Clarified source opening and copy-path behavior.