Skip to content

Getting Started

Open the editor at https://zxwgraphboard.netlify.app. No login is required.

The editor is a tab bar across the top plus a full-screen canvas below, with several floating panels:

Element Location Purpose
Tab bar Top Switch between independent graphs; add, rename, close tabs (see Working with Tabs)
Toolbar Top-left Mode switching, undo/redo, clipboard, save, import/export, compute, reset, help
Vertex-type menu Below toolbar (only in Add vertex mode) Pick which generator to place
Property panel Top-right (only when one vertex is selected) Edit a vertex’s type, label, and rotation
Canvas Centre Where you place and move vertices and draw edges
MiniMap / Controls Bottom-right Zoom, fit, and an overview of the whole graph

Everything you draw is automatically saved to your browser as you work (see Saving & Loading). Every tab is its own independent graph — the toolbar, canvas, and panels always act on the active tab.

The toolbar’s left cluster switches between three modes. Each mode changes what clicking on the canvas does:

The default mode. Click a vertex or edge to select it; drag a selected vertex to move it. This is the only mode in which you can move things around. Double-click a vertex body to edit its label inline.

Click anywhere on the canvas to drop a new vertex of the currently selected type. The vertex-type menu appears on the left so you can choose which generator to place (or press 1–9 to pick by index — the digits reach the first nine types; the X box and the And gate are menu-only). You cannot move vertices in this mode.

Click vertices to connect them. See Editing Graphs § Edges for the full click/shift-click/cmd-click vocabulary — this mode is the most feature-rich.

Try this to get a feel for the editor:

  1. Press V (or click the Add vertex button), then press 1 to select the Z spider.
  2. Click three times on the canvas to drop three Z spiders.
  3. Press E to enter Add edge mode.
  4. Click the first spider, then the second, then the third — each click after the first draws an edge from every pending source to the clicked target.
  5. Press S, click a spider, and set its label to $\pi/2$ in the property panel (it will render as π/2).
  6. Add an input and an output boundary (keys 5 and 6 in Add vertex mode) and wire them to the diagram so the graph has open legs.
  7. Click Compute (the calculator icon in the toolbar) to evaluate the tensor the diagram represents. See Computing Tensors.
  8. Press Ctrl+S (or ⌘S on macOS) to save.
  9. Click + in the tab bar to start a fresh diagram in a second tab — the first one stays safe in its own tab. See Working with Tabs.

Next: Working with Tabs.