Builder

The main workspace where users can create and edit their templates

The Builder is the primary workspace in Stubber where you create, edit, and manage templates. It is where you will spend most of your time when defining your process. It provides a visual canvas for building processes using states, actions, and other supporting tools.

# Accessing the Builder

To access the Builder, open the menu in the top-right corner of the screen next to the user icon, then select Builder.

After selecting Builder, you will be taken to the Builder app.

By default, the Builder opens on the folder page, which provides a list of all your templates and template folders.

The sidebar also provides shortcuts to view the organization's most recent templates, Knowledge Library, PDF templates, and StubberDBs.

For each template listed in the Builder, you can perform the following actions:

1. Open Stub List
   • Opens the list of stubs associated with the selected template.
2. Open Overview
   • Opens an overview of the selected template.
3. Open Default Flow
   • Opens the default context of the selected template. See the Canvas section below.

You also have the option to create various components using the plus button in the top-right corner of the screen.

You can create the following items:

• Template — Create a new template.
• Article — Create a new article in the Knowledge Library.
• Email Layout — Create a new email layout that can be used in templates.
• Public Form Layout — Create a new public form layout that can be used in templates.
• PDF Template — Create a new PDF template that can be used in templates.
• Folder — Create a new folder to organize your templates and other items.

# Canvas

When you edit a template in Stubber, you do so on the canvas. The canvas is where you add, drag, and connect actions and states to build your template. It is the primary workspace where you will spend most of your time when editing a template.

# On the top-most toolbar, you will find the following options, starting from the left:

• The Stubber logo redirects you to the template list page.
• The template name displays the name of the currently opened template.
• The Context dropdown allows you to switch between template contexts. For more information, see Contexts.
• The Template Overview button opens the Template Overview page, where you can view the template, its contexts, and associated stubs.
• The View in Drive button opens the folder where the template is stored.
• The Stub List button opens the list of stubs associated with the template.
• The View Parent Template button opens the parent template.
• The View JSON Editor button opens the advanced JSON editor for the template.
• The View Layout Editor button opens the Layout Editor mode, where you can edit the template layout. For more information, see Layout Editor.
• The Edit Template Details button opens the template details settings, where you can modify properties such as the template name and starting state.
• The View Contact Lists button opens the contact lists associated with the template. For more information, see Contact Lists.
• The View Flow Data button opens the flow data manager for the template.
• The Command Palette button opens the command palette, where you can search for and navigate to any state or action in the template.
• The View Activity Log button opens the activity log, where you can view collaborator activity and recent changes made to the template.
• The View Template Versions button opens the template version history, where you can view and restore previous versions of the template.
• The Publish Template button publishes the template to the live environment, making the latest version available to all collaborators.
• The Menu button opens the main navigation menu, where you can access the Stubs, Console, and Builder sections.

# On the bottom-most toolbar, you will find the following options:

• The Add Note button allows you to add notes to the canvas.
• The Add Headings button allows you to add headings to the canvas for the purpose of labeling and organizing your template.
• The Add External Link button allows you to add external resources (URL) to the canvas.
• The Add Image Link button allows you to add an image to the canvas via URL.
• The Add Prompt button allows you to add an editable components where you can write your various prompts that can be used in your template.
• The Add Markdown Annotion button allows you to add an editable component where you can write markdown text that can be used in your template.
• The Add Template Data button allows you to add editable components where you can initialize data that is relevant to the template.
• The Add Form Fields allows you to add an editable component where you can define form fields that can be used in your template.
• The Add Sticker button allows you to add a customizable sticker to the canvas, which can be used for visual organization and emphasis.
• The Paste Items button allows you to paste items from your clipboard to the canvas.
• The Open Library button allows you to browse through pre-built actions that you can add to your template.
• The Add Stub button allows you to add a new stub to the canvas, which you can use to implement and manage your processes.
• The Add State button allows you to add a new state to the canvas, which are steps that keep track of progress and provide clarity on the current state of the process.
• The Add Action button allows you to add a new action to the canvas, which are steps that enable progress toward a state.

# Navigation Tools

In the bottom-left corner of the canvas, you will find the navigation tools. These tools help you move around the canvas, adjust your view, and access quick controls while building your template.

The navigation tools include the following:

• Mini Map — Displays a small overview of the entire canvas and highlights the section currently in view. You can click anywhere on the mini map to quickly move to a different area of the canvas.
• Zoom In and Zoom Out — Adjust the canvas zoom level for better visibility and navigation.
• Fit to Screen — Automatically adjusts the canvas position and zoom level so that all template elements fit within the visible area.
• Toggle Interactivity — Enables or disables canvas interactivity. This is useful when you want to move around the canvas without accidentally changing states, actions, or connections.
• Help — Opens a guide to the available builder controls and keyboard shortcuts.

# Builder controls and shortcuts

# Flow Pilot Chat Widget

When you open a template in the Builder, the Flow Pilot window automatically opens with a welcome message, allowing you to immediately start asking questions or requesting assistance.

You can reopen the Flow Pilot at any time by clicking the chat icon in the bottom-right corner of the canvas.

The Flow Pilot Chat Widget is an AI assistant designed to help you while building and editing templates in the Builder.

Using Flow Pilot, you can:

• Ask questions about the Builder and its features.

• Get assistance with creating and configuring templates.

• Request help with prompts and markdown annotations.

• Ask the Flow Pilot to perform actions directly on the canvas, such as:

  • Adding states or actions.
  • Modifying or configuring existing states, actions and annotations.
  • Deleting states or actions.
  • Updating template components and configurations.

Flow Pilot helps streamline template development by providing in-context assistance directly within the Builder.

# Collaboration

The Builder allows for collaboration, enabling you to work on the same template as your team. You can see who is currently working on the template by looking at the top-right corner of the screen, where you will find the user icon and the number of collaborators currently working on the template. You can also see the collaborators by clicking or hovering on the user icon.

# Autosave

The Builder automatically saves your work, so you do not have to worry about losing your progress or manually saving your work.