Skip to main content
The Builder page is a drag-and-drop canvas where you create and edit print templates. Templates consist of positioned elements that can display static text, dynamic task data, images, barcodes, and tables.
Builder overview

The Builder with a delivery receipt template. Left sidebar shows element types and task data. Right panel shows properties for the selected element.

Adding Elements

Drag any element type from the left sidebar onto the canvas:
ElementDescription
TextStatic or data-bound text. Supports font size, family, weight, color, and alignment.
ImageStatic image (upload or URL) or data-bound image from task photos.
BarcodeGenerates a barcode from a static value or task field. Supports CODE128 format.
QR CodeGenerates a QR code from a value or URL.
LineA horizontal or vertical line for separators.
RectangleA bordered rectangle for framing content.
TableA data table that can display bill items from task data.

Selecting and Editing Elements

  • Click an element to select it. Blue handles appear for resizing.
  • Cmd+Click (Mac) or Ctrl+Click (Windows) to multi-select elements.
  • Arrow keys move selected elements by 1px. Shift+Arrow moves by 10px.
  • Tab cycles through elements. Shift+Tab goes in reverse.
  • Delete removes the selected element(s).

Data Field Binding

To display real task data in your template:
  1. Select a text element.
  2. In the Properties panel, click Data Field (instead of Plain Value).
  3. Choose a field from the dropdown (e.g., Customer Name, Status, Start Time).
  4. The element immediately resolves to the actual value from the loaded task.
You must select a flow and fetch a task in the Task Data section (bottom of the left sidebar) before data fields resolve. Without task data loaded, elements show placeholder text.

Grid and Snap

The canvas has a grid system to help align elements precisely:
  • Grid toggle (grid icon or Ctrl+G): Shows/hides the dot grid on the canvas.
  • Snap to grid (bounding-box icon or Ctrl+;): Elements snap to grid intersections during drag.
  • Measurements (rulers icon): Shows position and dimensions overlay near selected elements.
  • Alignment guides: Orange lines appear when dragging an element near another element’s edge, helping you align them.

Keyboard Shortcuts

Press F1 or click Help to see all available shortcuts.
Keyboard shortcuts modal

The Help modal lists all keyboard shortcuts organized by category.

Key shortcuts:
ActionShortcut
CopyCtrl+C / Cmd+C
PasteCtrl+V / Cmd+V
DuplicateCtrl+D / Cmd+D
UndoCtrl+Z / Cmd+Z
RedoCtrl+Shift+Z / Cmd+Shift+Z
Select AllCtrl+A / Cmd+A
DeleteDelete / Backspace
Toggle GridCtrl+G
Toggle SnapCtrl+;
Horizontal AlignCtrl+Shift+H
Vertical AlignCtrl+Shift+V
PreviewCtrl+P
HelpF1

Saving Templates

  1. Click Save Template in the toolbar.
  2. Enter a name and optional description.
  3. Click Save.
If you modify a saved template, the save dialog offers both Save (overwrite) and Save as New (create a copy).

Template Library

Click Template Library in the toolbar to see all saved templates.
Template Library

The Template Library shows cards with name, description, last modified date, and page size. Click a card to load the template.

  • Click a card to load that template onto the canvas.
  • Click the trash icon to delete a template (with confirmation).
  • Templates show the last modified date and page size/orientation.

Import and Export

Use the Export Import dropdown in the toolbar:
  • Export as JSON: Downloads the current template as a JSON file for backup or sharing.
  • Import from JSON: Loads a template from a previously exported JSON file.

Sample Templates

Click Sample in the toolbar to load a pre-built template:
  • Sample Template Invoice: A standard invoice layout.
  • Sample Template Delivery: A delivery receipt with customer details and bill items.
  • Sample Template Thermal: A narrow thermal receipt (80mm width).
Click Print Settings in the toolbar to configure:
  • Page Size: A4, Letter, or custom dimensions (in mm).
  • Orientation: Portrait or Landscape.
Print Settings dropdown

The Print Settings dropdown with page size selector, orientation toggle, and quick action buttons.