Workspace and menus
The library lists browser projects and objects. The canvas holds the diagram. The inspector changes the current tool or selection. Drag either thin vertical divider to resize its neighboring panel; focus the divider and use the left or right arrow key for keyboard resizing.
| Menu | What it controls |
|---|---|
| File | New, open, save, templates, image/PDF export, and LaTeX source. |
| Edit | Undo, redo, title, figure style, and deletion. |
| View | Snapping, page grid, figure panel, grid spacing, and automatic/light/dark themes. |
| Tools | Select, Add Vertex, Connect Vertices, Add Loop, and Annotate → Label or Arrow. |
| Help | This guide, examples, keyboard shortcuts, version, and license information. |
Drawing and annotation tools
Select V
Click a vertex, propagator, object label, independent label, or free arrow to select it. Drag vertices and labels to reposition them. Dragging a free arrow moves both endpoints together; use the inspector to edit individual endpoints. Clicking empty space clears the selection. The Objects list provides another selection method. Arrow keys nudge a selected vertex by one unit; hold Shift for a larger step.
Add Vertex A
Choose a marker style and click the page. A vertex can show no mark, a small dot, or a larger open, filled, hatched, crosshatched, or dotted circle. Large circular markers expose an icon-radius control from 6 to 60 canvas units.
Connect Vertices C
Choose a line type and arrow behavior, then click two different vertices. The first click sets the start. Automatic arrows run from start to end for fermions. Bosons, scalars, and ghosts begin without an arrow. Use the Loop tool for a self-loop.
Add Loop L
Single vertex attaches a self-loop to one vertex. The editor points it toward the side with the most available space. Two vertices creates a matched pair of curved propagators, giving a circular loop. For fermions, the two arrows point in opposite directions.
Annotate → Label
Choose Label and click anywhere on the page to place an independent TeX label. The tool returns to Select after placement. Use independent labels for process names, equations, scale notes, or a legend. Select the label to edit its source, X/Y coordinates, or color.
Annotate → Arrow
Choose Arrow, then drag from the tail to the head. The tool returns to Select when the drag ends. Select the arrow to move it as one object, edit either endpoint, change its color, or delete it. Free arrows work well for explanatory callouts and axes.
Undo restores the full connected structure. Projects accept up to 150 vertices, 300 propagators, and 300 free annotations.
Object inspector
Propagator styles
Quarks and leptons; arrow direction carries fermion flow.
Electromagnetic gauge boson.
Strong-force gauge boson.
Spin-0 field, often the Higgs or a model-dependent scalar.
Auxiliary field used in gauge-theory calculations.
Line-style conventions vary by subfield and paper. Use labels and a legend if your audience might read a style differently.
| Control | Range or choices | Effect |
|---|---|---|
| Particle style | Fermion, photon, gluon, scalar, ghost | Changes the line geometry while preserving its endpoints and label. |
| Arrow direction | Start → end, end → start, none | Sets fermion flow or removes the arrow. |
| Quark bundle | 1, 2, or 3 | Draws parallel fermion lines. Quark spacing appears for bundles of two or three. |
| Curvature | −220 to 220 | Bends a normal connection to either side. Zero produces a straight baseline. |
| Loop size / angle | 30–180 / −180°–180° | Changes the radius and direction of a single-vertex loop. |
| Label offset | −120 to 120 | Moves a propagator label perpendicular to the line at its midpoint. |
| Label X / Y | −150 to 150 | Adds exact horizontal and vertical adjustments after the offset. |
| Line color | Color picker | Changes the selected propagator in the editor and supported exports. |
| Momentum arrow | On/off | Adds an arrow that follows the straight, curved, or looped propagator path. |
| Momentum label | TeX source, up to 200 characters | Places a momentum symbol at the center of the momentum-arrow segment. |
| Momentum label X / Y | Within the page | Moves the momentum label independently of its arrow; the label can also be dragged. |
| Momentum direction / side | Start → end or end → start / left or right | Sets the arrow direction and the side of the propagator independently of fermion flow. |
| Momentum start / end | 0–95% / 5–100%, at least 5% apart | Sets the portion of the propagator followed by the arrow. These controls appear under Fine placement. |
| Momentum color | Color picker | Changes the momentum arrow and its label. |
Vertex controls
A selected vertex exposes its TeX label, X/Y position, label X/Y offsets, marker style, and marker radius. Vertices stay inside the 720 × 480 page with a 20-unit margin; labels can move across the page up to their visible edges. Snapping aligns vertex position edits to the active grid.
Independent annotations
| Object | Inspector controls | Canvas behavior |
|---|---|---|
| Independent label | TeX source, X/Y position, color | Drag the label to reposition it anywhere within the 720 × 480 page. |
| Free arrow | X1/Y1 tail, X2/Y2 head, color | Drag the arrow to move both endpoints while preserving its length and direction. |
Label syntax
Vertex, propagator, momentum, and independent labels use the same TeX-like input. Drag object labels for visual placement or enter offsets for repeatable alignment. The label reference lists supported commands and examples.
Figure and view settings
| Setting | Range | Use |
|---|---|---|
| Figure width | 60–240 mm | Sets physical size and determines raster pixel dimensions with the selected ppi. |
| Line width | 0.3–2 pt | Sets the base stroke in vector, raster, PDF, and LaTeX output. |
| Text size | 5–18 pt | Sets label size with the bundled DejaVu Serif face in image and PDF exports. |
| Snap to grid | On/off | Aligns current vertices as soon as you enable it, then constrains future movement. |
| Show page grid | On/off | Shows alignment lines in the editor. Exported figures omit the grid. |
| Grid spacing | 10, 20, 40 units | Chooses fine, standard, or coarse snapping. |
| Theme | Automatic, light, dark | Changes the application chrome. Diagram export colors come from object and background choices. |
View → Show Figure Style Panel keeps figure controls visible in the right sidebar. Edit → Figure Style opens the same main choices in a dialog.
Projects and history
My diagrams holds projects saved in this browser at this hostname. Click a project name to switch. Use the × button to delete one after confirmation. Click the diagram title or choose Edit → Rename Diagram to rename it.
The app autosaves after edits. Manual Save downloads an editable project file, which protects the work from browser-data clearing or a move to another hostname. Open validates and restores a project file smaller than 1 MB.
Undo and redo apply to edits within the active document. Opening a different project or replacing the document starts a new history. See Files & export for recovery and portability details.
Keyboard reference
| Keys | Action |
|---|---|
| V / A / C / L | Select / add vertex / connect / add loop. |
| ⌘Z or Ctrl+Z | Undo. |
| ⇧⌘Z or Ctrl+Shift+Z | Redo. |
| Delete or Backspace | Delete the selected vertex, propagator, independent label, or free arrow when focus is outside an input. |
| Arrow keys | Nudge a selected vertex; add Shift for a larger movement. |
| ⌘N, ⌘O, ⌘S, ⌘E | New, open, save, and export. Use Ctrl instead of Command on Windows and Linux. |