Support debug/flutter adapter, update Zed dependencies

[Dixzz]

🧩 Summary

This PR integrates Dart Debug Adapter Protocol (DAP) support into zed-extensions/dart, allowing interactive debugging sessions directly within Zed via dart debug_adapter

IMPORTANT

Make sure you have: in project path .zed/debug.json

[
  {
    "label": "Debug Flutter App",
    "adapter": "Dart", // DO NOT EDIT
    "type": "flutter",
    "program": "lib/main.dart",
    "args": ["--web-port=9090"]
  }
]

Steps shown:

1. Launch Debug Flutter App task in Zed using F4 or command pallet debugger: start
2. Hit breakpoint at main.dart
3. Inspect variable frames
4. Step through code

---

📸 Screenshots

Description	Image
Debug session launched

---

All supported schema for .zed/debug.json config

{
    "adapter": {
      "type": "string",
      "enum": ["Dart"]
    },
    "type": {
      "type": "string",
      "enum": ["dart", "flutter"],
      "description": "Debug Flutter or Dart file"
    },
    "label": {
      "type": "string",
      "description": "Human-readable name for this debug configuration",
      "examples": ["Launch Dart App", "Debug Main", "Dart Console"]
    },
    "program": {
      "type": "string",
      "description": "Path to the Dart file to debug",
      "examples": ["lib/main.dart", "bin/main.dart", "test/example_test.dart"]
    },
    "args": {
      "type": "array",
      "description": "Arguments passed to the Dart program.",
      "items": {
        "type": "string"
      },
      "default": []
    },
    "device_id": {
      "type": "string",
      "examples": ["chrome", "edge", "<android-id>", "<ios-id>"]
    },
    "platform": {
      "type": "string",
      "examples": ["web", "desktop"]
    },
    "stopOnEntry": {
      "type": "boolean",
      "description": "Pause debugger on entry.",
      "default": false
    }
  }

[Dixzz]

Tested on:
Zed Preview: v0.192.3-pre
Flutter Version: Flutter 3.29.3

[aikins01]

@Dixzz I'd like to take over working on this

[dario-valles]

Any way I can help on this? I really would like to see this live! @Dixzz @aikins01 ?

[Dixzz]

@aikins01 @dario-valles
There aren't any implementation at this moment but we can work on it at our pace

1. fvm custom path for flutter SDK binaries
2. Cross platform support (windows, mac, linux) when debugger is active (currently tested on Linux)

[felipecarvalho]

Any way I can help on this? I really would like to see this live! @Dixzz @aikins01 ?

Me too, we need this feature 🎉

[caturbgs]

Is there any ETA for this PR? 👀👀

[fstof]

I tested now on Zed 0.197.3
Installed this PR extension

I can't say that it works for me.
Hitting F4 shows the debug tasks as specified in debug.json but they do nothing

Plain dart as well as flutter apps do not start up
Here is my .zed/debug.json

[
  {
    "label": "Debug Flutter App",
    "adapter": "dart",
    "type": "flutter",
    "program": "lib/main.dart",
    "args": ["--web-port=9090"]
  },
  {
    "adapter": "dart",
    "type": "dart",
    "label": "Launch Dart App",
    "program": "lib/plain.dart",
    "stopOnEntry": false
  }
]

Am I missing something?

[dcrebbin]

Any updates on this

[peet0r]

Confirmed this PR is functional on Zed 0.198.5 when the following is added to .zed/debug.json in my flutter project:

{
    "label": "Debug Flutter App",
    "adapter": "Dart",
    "type": "flutter",
    "program": "lib/main.dart",
    "args": ["--web-port=9090", "-d", "macos"]
  }

Please note the device was set to macos so update for your device[s].

How much testing to we need to undertake to get this merged?

[peet0r]

I guess I should compile a few readme improvements...I'll push those shortly.

[Dixzz]

I tested now on Zed 0.197.3 Installed this PR extension

I can't say that it works for me. Hitting F4 shows the debug tasks as specified in debug.json but they do nothing

Plain dart as well as flutter apps do not start up Here is my .zed/debug.json

[
  {
    "label": "Debug Flutter App",
    "adapter": "dart",
    "type": "flutter",
    "program": "lib/main.dart",
    "args": ["--web-port=9090"]
  },
  {
    "adapter": "dart",
    "type": "dart",
    "label": "Launch Dart App",
    "program": "lib/plain.dart",
    "stopOnEntry": false
  }
]

Am I missing something?

Please provide:

Logs of flutter doctor
Zed version used
Platform you're running on

[peet0r]

FYI @Dixzz @fstof, the change from dart -> Dart tricked me during setup. When using dart with zed --foreground the logs were silent, which was confusing

[vleeuwenmenno]

I can confirm the same issue as @fstof, I can see the debug targets but spawning them does nothing.

[
  {
    "label": "Debug Flutter App",
    "adapter": "dart",
    "type": "flutter",
    "program": "lib/main.dart",
    "args": ["--web-port=9090"]
  }
]

On 801b322 for this extension (dart) and Flutter version 3.32.8

❯ zed --version
Zed 0.198.5 – /usr/lib/zed/zed-editor

EDIT: Can confirm it does work with the correct adapter name 😅

[
  {
    "label": "Debug Flutter App",
    "adapter": "Dart",
    "type": "flutter",
    "program": "lib/main.dart",
    "args": ["--web-port=9090"]
  }
]

[Dixzz]

Thank you @vleeuwenmenno I've updated the same

[fstof]

I can also confirm the capitalisation fixed it

Thanks

[EDIT]
I think the issue is the linter / schema specifies "dart" and warns when using "Dart" on the adapter

[fstof]

One more crucial thing i think is missing here.
The ability to specify the current working directory. Like the .zed/tasks.json allows "cwd" and zed folder variables (like $ZED_WORKTREE_ROOT) I think this adapter would need the same.

[fstof]

These changes worked for me... Use it... or don't

Thank you for working on this. We all really appreciate it

[fstof]

Adding the cwd property

    "cwd": {
      "type": "string",
      "description": "Path to the working directory"
    },

[fstof]

updating the cwd to use the user configured one

        let cwd = user_config
            .get("cwd")
            .and_then(|v| v.as_str())
            .map(|s| s.to_string())
            .or_else(|| Some(worktree.root_path()));

[mark-nicepants]

I tried it, works on mac with "Dart" as adapter name, but with said lint warning.

[aesmail]

@Dixzz using macOS here, this is amazing! Can't wait for this to be merged even with a minimum feature-set. We (the community) can help and improve on it gradually.

[bubnov]

@Dixzz is there something blocking the PR? Is it awaited for QA or maybe somebody from the zed team needs to be mentioned?

[osiewicz]

LGTM.
@Dixzz is there anything you'd like to follow up with?