🚀 LaunchMap – Visualize Your ROS 2 Launch Files

LaunchMap is a Visual Studio Code extension that lets you visualize the structure of ROS 2 launch files as interactive graphs directly inside VSCode.

Whether you are debugging a complex launch.py, exploring a new package, or onboarding to a robotics stack, LaunchMap helps you see what is really happening in your launch files.

LaunchMap Demo

✨ Features

Visualizes ROS 2 launch files as interactive graphs
Supports core launch constructs like:
- Node(...)
- IncludeLaunchDescription(...)
- GroupAction(...)
- DeclareLaunchArgument(...)
- LaunchConfiguration(...)
Traces argument usage and include relationships
Opens the graph in a new tab within VSCode
Displays a warning banner for unsupported or skipped components

📦 Installation

Install from the Visual Studio Code Marketplace, or use the CLI:

code --install-extension KodoRobotics.launchmap

▶️ How to Use

Open a .launch.py file in VSCode.
Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P).
Run: LaunchMap: Visualize Launch File
The graph will open in a new editor tab.

🛠 Supported Constructs

Construct	Status
`Node(...)`	✅ Supported
`IncludeLaunchDescription(...)`	✅ Supported
`GroupAction(...)`	✅ Supported
`DeclareLaunchArgument(...)`	✅ Supported
`LaunchConfiguration(...)`	✅ Supported
`SetParameter(...)`	⚠️ Not yet parsed
`ComposableNode(...)`	⚠️ Not yet parsed
`IfCondition(...)`	⚠️ Not yet parsed

A banner at the top of the graph view shows which components were skipped.

🐛 Known Limitations

Some advanced constructs like ComposableNode are skipped.
Launch files are parsed statically (not executed).
Layout may be suboptimal for large or deeply nested graphs.

📜 License

🤝 Contributing

Contributions are welcome! Please open an issue, suggest a feature, or submit a pull request.

LaunchMap

Kodo Robotics