Skip to main content


Let's talk about the concepts of a typical Tripetto runner. Each runner consists out of two layers:

  • The runner foundation layer;
  • The runner UI layer.

The runner foundation layer is a package published on npm. It drives all the runners and does the heavy weight lifting of parsing the form definition into a virtual finite state machine that handles all the complex logic and response collection during the execution of the form. You can apply any UI framework you like on top of it (which is the second layer). Combined they are a full-featured form runner capable of running complex forms.

The following diagram shows how the layers relate to each other:

Runner overview

The runner solves a couple of things at once:

  • Form parsing: The runner takes on the task of parsing the form definition (the output of the form builder) into an executable program. This altogether eliminates the typically complex programming of logic and flows within forms.

  • UI freedom: For the UI layer you can implement anything you want. We don’t impose any particular UI framework or library. You decide how it looks and operates. Just wire it up to any UI you like by using the standard DOM-methods of the browser, or by using a library like React or framework like Angular.

♻️ Form lifecycle

Whenever a form session in a runner starts, a form instance is created. So, an instance represents a single input/user session. It holds the current state of the form and the collected data. A form instance always follows the following lifecycle:


A description of the entities used in the diagram can be found here.

Form lifecycle

When a form starts, the clusters in the root of that form are shown. Clusters can have branches with conditions. The branches that have matching conditions are taken. Branches, in turn, can have more clusters, and those clusters can have nested branches where this process repeats itself (recursive model).


Form instances can also pause and resume later on. In a typical UI-oriented application only one instance at a time is active.


We tend to call the forms you build with Tripetto smart because they can contain this advanced logic and conditional flows, allowing for jumps from one part of the form to another or the skipping of certain parts altogether; all depending on the respondent’s input.