Project Editor
Project Editor is the development tool to write authentication flows. It has a low-code editor that can be used to drag and drop the code blocks, and the actual Agama code gets generated in the background. Major components of the Project Editor are noted below:
Project explorer
: The left-hand panel displays all the artifacts in the project in a structured view.Flow editor
: The right-hand side panel is the low-code editor used to design the flow using different flow components like assignment, log, RRF, trigger, etc.- Path of the artifact being edited.
- Test deployment button.
- Save the modifications to the project in the GitHub repository.
- Generate Agama code from the flow in the flow editor.
Export
: Exports a zip archive containing the.flow
code file and.json
configuration file for the flow.Import
: Allows importing an existing flow.Clear
: Removes all the flow components from the current flow. This operation is irreversible.Notes
: Add sticky note-style annotations to the flow to highlight different areas and flow components for better understanding of the flow.
Working With The Flow Editor
When a flow (aka a .flow
file) is opened using the left navigation, the project editor presents a visual rendering of the flow using the flow editor. You can add nodes, remove nodes, and edit configuration values of the nodes using the flow editor.
Creating A Node
A new node can be created from an existing node. Drag the colored dot at the edge of an existing node. Releasing the mouse button will present a pop-up menu. You can choose what type of next node you want to create.
Node Context Menu
Click on the node to open the node context menu as shown below. Use the node context menu to edit the node configuration, delete the node, or open the flow related to the node.
Non-linear Flow
Nodes like the When
node have multiple possible next
nodes based on conditions evaluating to True
or False
. You can define these alternative execution paths by dragging colored dots on each vertex.