Skip to content

Editor Integration ​

ADP renders an "Open in Editor" button next to every file reference (exceptions, logs, events, stack traces, routes). Clicking it launches your IDE at the right file and line via a custom URL protocol.

Configuration ​

Open the Settings dialog (top-bar menu → Settings) and pick an editor in the Editor Integration section. The setting is per-browser and persists in localStorage.

Supported Editors ​

EditorURL Format
PhpStormphpstorm://open?file={file}&line={line}
IntelliJ IDEAidea://open?file={file}&line={line}
WebStormwebstorm://open?file={file}&line={line}
GoLandgoland://open?file={file}&line={line}
PyCharmpycharm://open?file={file}&line={line}
RubyMinerubymine://open?file={file}&line={line}
Riderrider://open?file={file}&line={line}
CLionclion://open?file={file}&line={line}
VS Codevscode://file/{file}:{line}
VS Code Insidersvscode-insiders://file/{file}:{line}
Cursorcursor://file/{file}:{line}
Sublime Textsubl://open?url=file://{file}&line={line}
Zedzed://file/{file}:{line}
Customuser-supplied template with {file} / {line} placeholders

Path Mapping (Docker / WSL / Remote) ​

When the application runs inside a container or remote host, file paths reported to ADP (e.g. /app/src/Foo.php) don't match what your local IDE expects (e.g. /Users/me/project/src/Foo.php). Path mapping rewrites those paths before the editor URL is built.

In the Settings dialog, under the editor selector, add Remote → Local mapping rows:

RemoteLocal
/app/Users/me/project
/var/www/home/user/site

Rules:

  • The first matching remote prefix wins.
  • Empty remote keys are ignored.
  • Duplicate remote keys are flagged in the UI; the last value wins.
  • Mappings persist in localStorage alongside the editor preset.
ComponentLocation
FileLinkAny single-file reference (logs, events, var dumps, route source)
StackTraceEach frame in exception stack traces

Clicking the file path opens the ADP File Explorer in-app; clicking the editor icon (next to the path) launches your IDE.

Planned ​

FeatureWhy
HTTP callback transportURL protocols don't work in some browsers/OSes; POST to a local editor plugin (e.g. PhpStorm http://localhost:63342/api/file/...) is more reliable
Source map supportFrontend stack traces currently point to bundled files — resolve back to original sources

Released under the MIT License.