Context Menu Reference
Right-click (or Ctrl+click on macOS) to access context-sensitive actions throughout Farkitect. Available commands depend on what you click and your project role.
Explorer — Empty space
Section titled “Explorer — Empty space”Right-click blank space in the Explorer tree (below the packages) for root-level creation:
| Command | Description |
|---|---|
| New M2 Metamodel… | Create an M2 metamodel package with the standard structure |
| New M1 Model… | Create a root-level M1 model, choosing its metamodel imports as you go |
Explorer — Package
Section titled “Explorer — Package”| Command | Description |
|---|---|
| New Package… | Create a sub-package |
| New Element… | Create an element — choose its type and name |
| New Diagram… | Create a diagram in this package |
| New Catalog… | Create a catalog in this package |
| New Board… | Create a board in this package |
| Rename | Rename the package (F2) |
| Clone Package | Deep-copy the package tree |
| Export Package… | Export the package as a .farki file |
| Export as Markdown… | Export an M1 package as Markdown (not on M2 packages) |
| Delete | Delete the package and all contents |
Explorer — M2 metamodel root
Section titled “Explorer — M2 metamodel root”Right-click the root package of an M2 metamodel. Alongside its other commands, Contributors and Admins see:
| Command | Description |
|---|---|
| Upgrade from File… | Upgrade the metamodel in place from a newer version’s .farki — see How to upgrade a metamodel |
| Resolve Retired Types… | Map or delete elements of types an earlier upgrade retired — see Resolve retired types later |
Explorer — Element
Section titled “Explorer — Element”| Command | Description |
|---|---|
| New Child Diagram… | Create a diagram owned by this element |
| Add <Type> | Create a subordinate element (if the M2 defines subordinate types) |
| Rename | Rename the element (F2) |
| Delete | Delete the element from the model |
Explorer — Diagram / Catalog
Section titled “Explorer — Diagram / Catalog”| Command | Description |
|---|---|
| Open | Open the diagram or catalog (same as double-click) |
| Clone Diagram / Clone Catalog / Clone Board | Copy the view beside the original with its name in edit mode; the copy shows the same model elements |
| Rename | Rename (F2) |
| Delete | Delete the diagram, catalog or board. The confirmation says how many view links to it will be removed with it |
A diagram, catalog or board can also be dragged from the Explorer onto a diagram, where it becomes a view link.
Canvas — Node (Element)
Section titled “Canvas — Node (Element)”| Command | Description |
|---|---|
| Rename | Edit the element name inline (F2). On a note-bodied element this reads Edit Notes |
| Hide Label / Show Label | Hide or show this node’s name on this diagram |
| Arrange | Bring Forward, Send Backward, Bring to Front, Send to Back |
| Appearance | A submenu: Edit… (reveal the Properties panel’s Appearance section), Copy Appearance (Ctrl+Alt+C), Paste Appearance (Ctrl+Alt+V), and Revert Appearance to Default. See How to change a node’s or edge’s appearance on one diagram |
| Properties… | Open the element’s Properties and Notes window (Alt+Enter, or double-click the node) |
| Diagrams… | List the diagrams this element appears on |
| Insert Related… | List the elements directly related to this one and add the chosen ones around it. See Bring in the elements related to one already on the diagram |
| Open Child Diagram | Shown when the element has a child diagram: open it, or choose from a list when there are several (Enter). The same as double-clicking the drill-down marker |
| New Child Diagram | Create a child diagram for this element |
| Remove from Diagram | Remove the node from this diagram only (Delete) |
| Delete from Model | Delete the element from the model entirely (Ctrl+Delete) |
A package on a diagram has the same menu without Hide/Show Label, Diagrams…, Insert Related… and New Child Diagram. It keeps Properties… and, when the package has a child diagram, Open Child Diagram.
Several nodes or links selected
Section titled “Several nodes or links selected”Right-clicking one of several selected nodes or view links acts on all of them. Nodes and links can be selected together.
| Command | Description |
|---|---|
| Align | Left, Center, Right, Top, Middle, Bottom |
| Same | Size, Height, Width |
| Distribute | Horizontally, Vertically |
| Appearance | Edit…, Paste Appearance (Ctrl+Alt+V) and Revert Appearance to Default. There’s no Copy Appearance: copy from a single node |
| Hide Labels / Show Labels | Hide or show every selected node’s name |
| Border | Show or Hide the border on every selected view link. Shown only when a link is selected |
| Remove n from Diagram | Remove the selected nodes and links from this diagram (Delete) |
| Delete n from Model | Delete the selected elements from the model (Ctrl+Delete) |
Align, Same and Distribute apply to nodes and links alike. Appearance, Hide Labels, Show Labels and Delete from Model apply to nodes only: they are not shown when only links are selected, and with a mixed selection they leave the links alone. n counts what the command acts on.
Canvas — View link
Section titled “Canvas — View link”A view link opens another diagram, a catalog or a board.
| Command | Description |
|---|---|
| Open | Open the view the link points to (same as double-click). Available to viewers |
| Edit Label | Type over the link’s text in place (F2). Clear it to show the view’s name again |
| Show Border | Draw the link with a border, as a tile. Ticked when on |
| Remove Link | Remove the link from this diagram (Delete). The view it points to is untouched |
Canvas — Edge (Relationship)
Section titled “Canvas — Edge (Relationship)”| Command | Description |
|---|---|
| Line Style | The edge’s routing: Direct, Custom, Vertical/Horizontal Lateral or Vertical/Horizontal Tree. Not to be confused with its dash pattern, Line Pattern, which is a format setting |
| Apply line style to same type | Give every edge of this relationship type on the diagram the same routing |
| Appearance | The same submenu a node has: Edit… (reveal the Properties panel’s Appearance section for this edge), Copy Appearance (Ctrl+Alt+C) and Paste Appearance (Ctrl+Alt+V) to copy this edge’s appearance overrides onto another edge, and Revert Appearance to Default to clear them |
| Properties… | Open the relationship’s Properties and Notes window (Alt+Enter, or double-click the line or its label) |
| Rename | Edit the relationship label inline (F2) |
| Reset Name | Rename the relationship to its automatic name — the two element names joined by the relationship type’s verb (e.g., My Organisation builds Brand). Greyed out when the name already matches |
| Hide Label / Show Label | Hide or show the relationship’s name on this diagram |
| Reset Attachment Points | Let both ends choose their own attachment points again |
| Add Waypoint / Delete Waypoint | On a custom-routed edge: add a bend point where you right-clicked, or delete the one under the pointer |
| Snap Right Angles | On a custom-routed edge with bends: square up its segments |
| Remove from Diagram | Remove the edge from this diagram only |
| Delete from Model | Delete the relationship from the model |
Canvas — Background
Section titled “Canvas — Background”| Command | Description |
|---|---|
| Select All | Select all nodes (Ctrl+A) |
| Fit to View | Zoom to fit all content (Ctrl+0) |
Catalog — Row and Board — Card
Section titled “Catalog — Row and Board — Card”Right-click an element’s row in a catalog, or its card on a board. Right-clicking a catalog row also selects it.
| Command | Description |
|---|---|
| Rename | Edit the name in place, with the name selected so typing replaces it. In a catalog this edits the row’s Name cell, so it is dimmed while the Name column is hidden |
| Diagrams… | List the diagrams this element appears on, and open one with the element selected |
| Delete from Model | Delete the element from the model, after a confirmation. It is removed from every diagram and board |
F2 edits in place too: the selected card’s name on a board, and the selected cell in a catalog, whichever column it is in. Viewers see Diagrams… only. While a catalog cell is being edited, right-clicking in it gives the browser’s own menu, for copy and paste.
Panel tab
Section titled “Panel tab”Right-click any tab: a diagram, catalog or board, or a panel such as Properties or Notes. The commands act on the tab you right-clicked, within its own group of tabs, whether or not it is the one in front.
| Command | Description |
|---|---|
| Close | Close this tab |
| Close Others | Close every other tab in the group |
| Close to the Right | Close the tabs after this one |
| Close All | Close every tab in the group |
A command that has nothing to close is shown dimmed: with a single tab, only Close is available.
If any diagram being closed has unsaved changes, you are asked about each one in turn: Save, Discard or Cancel. Cancel stops the whole action and no tab is closed. Closing a panel such as Notes hides it; show it again from the View menu and it comes back where it was.
M2 Element Type (in Explorer)
Section titled “M2 Element Type (in Explorer)”| Command | Description |
|---|---|
| New Element Type… | Create a new element type in this layer |
| New Relationship Type | Create a new relationship type |
| New Enumeration | Create a new enumeration |
- Commands that require edit permissions (Contributor or Admin) are hidden for Viewers
- Commands that apply to read-only packages (M2 built-ins, M3) are hidden or disabled
- Context menus adapt based on the element’s layer (M3, M2, M1) and type