piyaz
UI

Graph View

Visualize task dependencies and project structure as an interactive graph.

Graph View

The graph view renders your project's task graph as an interactive force-directed visualization. Tasks are nodes, edges are links, and the layout reveals clusters, bottlenecks, and orphaned work at a glance.

Screenshot coming soon.

Layout

The graph uses a D3 force simulation with:

  • Center force pulling nodes toward the viewport center.
  • Charge force pushing nodes apart to prevent overlap.
  • Link force pulling connected nodes together.

The result is a self-organizing layout where tightly connected tasks cluster together and independent work drifts apart.

Interactions

  • Click a node to select it and open the detail panel.
  • Drag nodes to reposition them. The simulation pauses while dragging and resumes on release.
  • Zoom and pan with scroll and drag on the background.

Visual Encoding

  • Node color reflects the task's derived state (draft, plannable, blocked, ready, in_progress, done).
  • Edge style distinguishes depends_on (directional arrow) from relates_to (dashed line).
  • Selected node is highlighted with an accent ring.

When to Use Graph View

Graph view is most useful for:

  • Seeing the big picture -- how tasks relate and where clusters form.
  • Spotting bottlenecks -- nodes with many incoming edges are critical.
  • Finding orphans -- disconnected nodes may be missing dependencies.
  • Verifying decomposition -- after breaking a project into tasks, the graph shows whether the dependency structure makes sense.

For day-to-day task management, the structure (list) mode in the navigator panel is typically faster. Switch to graph mode when you need spatial reasoning about the project's structure.

On this page