tutorial

Lesson 3: Mastering Group Nodes: How to Encapsulate and Navigate Nested Sub-Graphs

Learn how to compress prompt sub-graphs with Group Nodes in Nodestr. Master Ctrl+G grouping, nested sub-canvas levels, and breadcrumb navigation.

By Lyra & Mercury • 4 min read

As your visual prompt architectures scale from simple 3-node chains into enterprise LLM orchestrations containing dozens of guardrails, persona anchors, and API parameters, keeping your main canvas clean and scannable becomes essential.

While Frames (Shift+F) provide flat visual boundaries on the main canvas, Group Nodes (Ctrl+G) deliver true hierarchical encapsulation. Group Nodes compress complex multi-node sub-graphs into a single compact node card, isolating detailed sub-routines while maintaining clear data pipelines via proxy conduits.

Understanding Group Node Architecture

A Group Node is a hierarchical sub-canvas container designed to collapse complex logic out of sight without severing data flow:

  • Header Title: Name your group node to reflect its sub-routine (e.g. "System Guardrails Pipeline" or "Character DNA Synthesizer").
  • Enter Group Icon: Located on the right of the group header. Clicking it zooms the canvas into the group's internal sub-canvas workspace.
  • Proxy Conduits: Inside every group, Nodestr automatically manages Group Input (left proxy) and Group Output (right proxy) nodes that pass variables in and out between parent and child levels.
  • Breadcrumb Navigation Strip: A top floating navigation bar that tracks your nesting depth (e.g. Main Canvas > System Guardrails [L1] > Safety Filter [L2]).

Step 1: Encapsulating Nodes into a Group (Ctrl+G)

Grouping nodes in Nodestr takes just one hotkey:

  1. Select the Nodes: Hold Shift and left-click all nodes in the cluster you wish to encapsulate (or click-and-drag a marquee selection box over them).
  2. Press Ctrl + G: Hit Ctrl + G on your keyboard.
  3. Encapsulation: Nodestr instantly compresses the selected nodes into a single compact Group Node card on your main canvas.
  4. Automatic Proxy Conduit Mapping: Any noodles entering or leaving the selected cluster are automatically mapped through proxy ports on the Group Node border!

Step 2: Entering the Group Sub-Canvas View

To inspect, edit, or expand the nodes contained inside a Group Node:

  1. Locate your Group Node card on the main canvas.
  2. Click the Enter Group icon on the right side of the group header (or double-click the group node card).
  3. The main canvas smoothly zooms into that group's dedicated sub-canvas workspace.
  4. Inside, you will see your original nodes connected between a Group Input proxy node on the left and a Group Output proxy node on the right.

Step 3: Nesting Nodes Across Multiple Levels (L1, L2)

Nodestr supports multi-level hierarchical nesting, allowing you to build modular sub-routines inside sub-routines:

  1. Create a Sub-Group Inside L1: While inside your L1 sub-canvas view, select a subset of nodes and press Ctrl + G.
  2. Nest Deeper: Nodestr encapsulates those nodes into a new L2 sub-group card inside L1.
  3. Enter L2 Sub-Canvas: Click the Enter Group icon on the L2 group header to drill down into the Level 2 sub-canvas view.
  4. Infinite Scalability: You can repeat this process to isolate complex logic layers while keeping each sub-canvas simple and focused!

Step 4: Navigating and Exiting Group Views via Breadcrumbs

When working inside deeply nested sub-graphs, Nodestr provides a top floating Breadcrumb Navigation Bar to keep you oriented:

  1. Inspect Your Nesting Depth: Look at the top floating breadcrumb bar (e.g. Main Canvas > Guardrails [L1] > Token Filter [L2]).
  2. Return to Parent Level (Upper Level): Click the ← Back to Parent button in the breadcrumb bar to step up one level (e.g. from L2 back up to L1).
  3. Return Directly to Main Canvas: Click Main Canvas in the breadcrumb link strip to exit all nested sub-views instantly and return to your top-level workspace!

Best Practices for Group Node Hierarchy

  • Use Groups for Sub-Routines, Frames for Layout: Use Groups (Ctrl+G) when you want to collapse 10 nodes into 1 card. Use Frames (Shift+F) when you want flat visual boundaries on a single screen.
  • Title Proxy Conduits Clearly: Name the input/output ports on your Group Input and Group Output proxy nodes so parent levels understand what variable data is being passed.

Conclusion

Group Nodes enable you to build enterprise-grade visual prompt architectures without canvas clutter. By nesting sub-routines into clean sub-canvas levels, you keep your workflows modular, readable, and easy to maintain.

Tutorial Series Navigation

← Previous Lesson: Lesson 2 Next Lesson: Lesson 4 →