On this page

Open the Dependency Graph when a list of relationships is not enough: you want to see the whole chain of work that blocks an item and the work it blocks, spot the bottleneck, or check for a circular dependency before committing to a date.

The graph is built from the item's blocking relationships, so it is a natural companion to the Relationships dialog where those relationships are created.

Two views of the same relationships

The Dependency Graph and the Gantt timeline show the same underlying relationships in different ways: the graph maps an item's full blocking chain on a canvas, while the Gantt draws dependency lines between bars on the schedule. Use the graph to understand structure, and the Gantt to understand timing — and see Link Mode for how rescheduling on the Gantt can shift a dependency chain automatically.

Opening the Dependency Graph#

The graph is a feature of the item itself, so you can reach it from anywhere you can open an item's Relationships dialog:

  • the Relationships button in the item workspace header,
  • the Relationships cell in the Items Table,
  • the circular relationship indicator on board and folder cards, or
  • an item's relationships opened from the Gantt view.

Then:

  1. Open the item's Relationships dialog.
  2. In the Summary section at the top, click the purple View Graph button in the top-right corner.

The graph opens in a modal titled Dependency Graph for followed by the item's icon, number, and title.

The View Graph button only appears when relationships exist

The View Graph button is shown only when the item already has at least one relationship. If an item has no relationships, there is nothing to graph, so the button does not appear. Add a blocking relationship in the Relationships dialog first, and the button will show up.

Any user who can see the item and its relationships can open the graph. There is no separate role, permission, or plan requirement.

What the graph shows#

The graph is centered on the item you opened it from, shown with a blue border and labeled Current Item. Cards open compact by default; press E or use the footer toggle to expand them. Click any card to center on it.

From there, DevStride walks the item's blocking relationships in both directions:

  • Dependencies are the items the current item is blocked by. They are drawn in the region enclosed by an orange dashed border with an orange Dependencies label. These are the things that need to happen before the current item can move.
  • Dependents are the items the current item blocks. They are drawn in the region enclosed by a purple dashed border with a purple Dependents label. These are the things waiting on the current item.

The graph follows these chains recursively, so you see not just the items directly connected to the current one, but the full upstream and downstream tree.

Only blocking relationships appear

The Dependency Graph visualizes Blocks and Blocked by relationships only. Related to relationships are not shown. The graph includes work items and folders; other entity types are not graphed.

Reading the connector lines#

The lines connecting the cards are color-coded by status, not by dependency direction:

  • Green — Done (an item is also treated as done when every item beneath it is complete)
  • Orange — In Progress
  • Red — Not Started

This lets you see at a glance how far along the work in a chain actually is.

Colors mean different things in different places

The orange and purple dashed region borders indicate direction (orange = dependencies, purple = dependents). The connector lines between cards indicate status (green/orange/red). They are not the same color scheme, so read each one in context.

Special card indicators#

The graph flags a few situations directly on the cards:

  • Appears N times in this tree — When the same item shows up in more than one place in the dependency tree, each occurrence gets an orange dashed outline with this note, so you know it is the same piece of work.
  • Cyclic Dependency — If a chain of dependencies loops back on itself, DevStride detects the cycle and marks it with a red dashed border and a pulsing Cyclic Dependency alert instead of looping endlessly. This is a useful warning that your dependencies may need untangling.

The graph sits on a large checkered "infinite" canvas, so even big dependency trees have room to spread out.

To do this Use
Pan around Drag the canvas, or scroll / use the trackpad
Pan horizontally Hold Shift while scrolling
Zoom in and out Hold Ctrl (or Cmd) while scrolling

When you start dragging, the cursor changes to a grabbing hand so you know you are panning. When the graph first opens, it is centered on the current item at 100% zoom.

Zooming#

Zoom ranges from 5% to 200%. You have several ways to control it:

  • Click the Zoom in (+) and Zoom out (-) buttons to step through preset zoom levels.
  • Type an exact percentage (5–200) into the zoom-percentage box and press Enter.
  • Click the zoom box to reset to 100% (its tooltip reads Type a zoom percentage (5-200) or click to reset to 100%).
  • Hold Ctrl / Cmd and scroll to zoom directly on the canvas.

The zoom controls live in the button group on the right side of the footer.

The footer of the graph is divided into three areas.

Dependency and dependent stats (left)#

The left side summarizes the tree:

  • Dependencies: the number direct and total, broken down by done / in progress / not started.
  • Dependents: the number direct and total.

In DevStride terms, a dependency is something the current item is blocked by, and a dependent is something the current item blocks.

Center on (center)#

The Center on dropdown lets you jump straight to any item in the graph. It is grouped and color-coded to match the canvas:

  • Current Item (star icon) at the top
  • Dependencies (orange)
  • Dependents (purple)

Selecting an item pans to that card and briefly highlights it with a yellow flash. You can also click any card directly to center on it. If you pan the canvas manually, the dropdown shows Manual scroll to indicate the view is no longer centered on a specific item.

View controls (right)#

Alongside the zoom controls, the right side of the footer has two toggle buttons:

  • Fit all to screen / Center on current item — toggles between fitting the entire graph in view and re-centering on the current item.
  • Expand cards / Compact cards — toggles the density of the item cards between a fuller layout and a condensed one.

Keyboard shortcuts#

When the graph has focus, you can use these shortcuts:

Shortcut Action
+ (or =) Zoom in
- (or _) Zoom out
R Toggle Fit all to screen / Center on current item
E Toggle Expand / Compact cards

Shortcuts pause while you are typing

Keyboard shortcuts are ignored while your cursor is in a text input, such as the zoom-percentage box. Click elsewhere on the graph first if a shortcut does not seem to respond.

Powered by DevStride