Skip to main content

UI Guide

Complete guide to the Apptor Flow web interface.


Application Layout

The Apptor Flow UI is a single-page Angular application. After logging in, you land on the Flow Dashboard.

Top Navigation Bar

A persistent top navigation bar is present on every page:

ButtonNavigates toWhat's there
Dashboard/flowsYour flow list — create and manage workflows
Upload/knowledge-baseKnowledge Base — RAG document collections
Connect/connectionsConnections — integrations to external services
Design/designerWorkflow Designer — last opened flow
Run/process-instancesExecution monitoring — all workflow runs
Administration/adminAdmin panel — users, API keys, secrets, webhooks, analytics

The current user's name is shown in the top-right corner. Click it to access your profile or sign out.


Main Sections

Flow Dashboard (/flows)

Flow Dashboard

The home screen. Shows all flows in your organization as cards. You can filter by status (All / Published / Drafts), search by name, sort by Last Updated / Created Date / Name, and create new flows.

Knowledge Base (/knowledge-base)

Knowledge Base

Manage RAG document collections. Upload documents (PDFs, Word docs, plain text, etc.) and organize them into collections. Workflow AI nodes can search these collections at runtime.

Connections (/connections)

Connections

Create and manage named integration connections — REST APIs, AI providers, email services, SMS providers, SQL databases, and MCP servers. Connections store credentials per environment (Development / Production) so workflows don't embed secrets.

Workflow Designer (/designer/:id)

Workflow Designer

The visual drag-and-drop editor. Build workflows by dragging nodes from the left panel onto the canvas, connecting them, and configuring properties in the right panel.

Execution Monitoring (/process-instances)

Process Instances

Track all workflow executions. Select a workflow from the left panel to see its instances. Click any instance to inspect the step-by-step execution log, node statuses, and variable values.

Administration (/admin)

Admin Dashboard

The admin area has a dedicated left sidebar with sections:

SectionPages
ObservabilityProcess Analytics, AI Analytics, Dead Letter Queue
IntegrationsAPI Specs, Integrations
SecurityIdentity Providers, Users, API Keys, Secrets
AutomationWebhooks, Webhook Health
SettingsOrganization settings

Pages in This Guide

GuideWhat It Covers
Getting StartedLogin, first workflow, quick orientation
Workflow DesignerCanvas, node palette, toolbar, connecting nodes
Properties PanelConfiguring individual nodes
Executing WorkflowsRun workflows, monitor executions, inspect logs
Version ManagementSave, publish, view version history
ConnectionsCreating and managing integration connections
Process AnalyticsExecution metrics, AI usage, performance analysis
Knowledge BaseDocument collections and RAG search
A2UI ComponentsAI-generated dynamic UI component catalog