Skip to content

See your colcon build

A live dashboard for colcon build. Watch the dependency graph fill in, find the slow packages on the timeline, read each package's log on its own, and keep an eye on your CPU and RAM.

It reads the logs that colcon already writes. You keep building the way you do now.

sudo add-apt-repository ppa:xmfcx/colcon-dashboard
sudo apt install python3-colcon-dashboard
colcon-dashboard --start-service
pipx install colcon-dashboard
colcon-dashboard --install-service

Then open localhost:8642 and pick your workspace.

A live build of Autoware: 502 packages on 24 workers.

Colcon Dashboard

Nothing to set up per build

The dashboard reads the logs that colcon writes into log/. Every build shows up: from any terminal, with any options, also a build that started before you opened the page.

No dependencies

The server is plain Python 3.8 or newer, with only the standard library. Install it from the Ubuntu PPA or with pipx, and it starts at every login.

One address for every workspace

One server on localhost:8642 serves all your workspaces. Open it in a browser tab, or install it as an app with its own window.

Everything about your build, on one page

A long build is no longer a wall of scrolling text. You see what builds now, what waits, what failed, and why.

The dependency graph of Autoware zoomed in during a build: done packages in green, building packages in blue, ready packages with a dashed border The dependency graph of Autoware zoomed in during a build, dark theme

Dependency graph

Watch the build move through your packages

Every package is a node, placed by its dependency depth. Done packages turn green, building packages glow blue and fill up with their make progress, and the packages that start next pulse. Hover a package to light up its whole dependency chain.

More about the graph

The timeline of a finished Autoware build, sorted by duration, with the longest packages on top The timeline of a finished Autoware build, sorted by duration, dark theme

Timeline

Find the packages that hold up the build

A Gantt chart shows when each package started and how long it took. Sort it by duration, and the slow packages and the long serial chains stand out at once.

More about the timeline

A package log pane with highlighted compiler warnings, file positions, and folded install lines A package log pane with highlighted compiler warnings, dark theme

Log panes

One log per package, easy to read

Each package gets its own tab, so the output of parallel jobs never mixes. Errors and warnings stand out, hundreds of install lines fold into one, and a strip beside the scrollbar shows where the problems are. Search, copy, and scroll stay fast also in a 10 MB log.

More about the log panes

A failed build: the failed package in red in the graph, and the Failures tab with the error of each failed package A failed build, dark theme

Failures

Go straight to the error

When a package fails, its log opens by itself at the error. The Failures tab collects the error of every failed package, and the graph shows which packages can no longer build. One click asks Claude to find the cause.

What happens when a build fails

The build picker: every build and test run of the workspace, with its outcome, its duration, and the change against the previous run The build picker, dark theme

History and system

Compare builds, and keep your machine in view

Every build and test run stays one click away, with its outcome and its time against the run before. The timeline shows which packages got slower, and a failed package shows how many runs in a row it failed. A per-core heatmap and the CPU, RAM, and swap meters warn you before a big build runs out of memory.

A tour of the page

From a handful of packages to hundreds

The same page works for a small workspace and for a full Autoware build.

The tf2 stack of ros2/geometry2 during its build: 15 packages, with tf2_ros building while the packages that need it wait The tf2 stack of ros2/geometry2 during its build, dark theme

ros2/geometry2: 15 packagesThe whole graph fits on the screen. The timeline shows the chain: tf2_ros builds alone, and the packages after it wait.

The whole Autoware graph during a build: 502 packages, the finished ones in green at the left, the building front in blue, and the waiting packages at the right The whole Autoware graph during a build, dark theme

Autoware: 502 packagesYou see the whole build at once, and you zoom in to read the names. The page stays fast at this size.

Install it in a minute

sudo add-apt-repository ppa:xmfcx/colcon-dashboard
sudo apt install python3-colcon-dashboard
colcon-dashboard --start-service
pipx install colcon-dashboard
colcon-dashboard --install-service

Then open http://localhost:8642/ and pick your workspace. Your next colcon build shows up there by itself.

Ready for your next build?

Install the dashboard, run colcon build as usual, and watch it.

Get started Take the tour