Create and edit nodes

Define custom nodes in your user package by creating TypeScript files. Each .node.ts file defines one node. When you save the file, the package reloads in Fusion on its own. The new or updated nodes are then ready to use on the canvas.

Node files use the Fusion TypeScript API to work with Fusion objects and operations. The full API reference is on that page. Use it when you need something the public packages do not cover. For example, you may want a node to read specific geometry types, manufacturing data, or document properties.

Before you start, confirm that:

• Fusion is running with the System Modeler add-in enabled
• The Fusion Automation API extension is installed
• TypeScript API definitions are set up. See Set up TypeScript API definitions.

Create a node file

1. In the Explorer panel, right-click your package folder.

2. Select New File, and name it with the .node.ts extension (for example, my-node.node.ts).

3. Write the node definition in TypeScript.

   Use the TypeScript API definitions for autocomplete, type information, and inline documentation as you write.

4. Press Ctrl+S (Windows) / Command+S (macOS) to save the file.

   System Modeler reloads the package in Fusion. The new node appears in the Library panel under your user package.

Edit an existing node

1. Open the .node.ts file in the IDE.

2. Make your changes.

3. Save the file.

   The package reloads and the updated node is available immediately.

Reload the package manually

If the automatic reload doesn't run, trigger it manually.

1. Press Ctrl+Shift+P (Windows) / Command+Shift+P (macOS) to open the command palette.

2. Search for and select System Modeler: Import package.

   The package reloads in Fusion.