1. Home
  2. 3: Building Your First App
  3. Workspace Application Interfaces

Interface Management

Rayven’s Interface Management tools let you build, organize, and customize user-facing interfaces that turn your data into powerful, interactive applications. Use the Interface Builder to create dashboards, controls, visualizations, and more — all co



What You Can Do with Interface Management

  • Build Dashboards and Apps: Create internal tools, customer-facing dashboards, monitoring apps, and more.

  • Add Interactive Widgets: Visualize data and control behavior with over 50 widget types.

  • Link to Workflows: Drive logic and automation by connecting widgets directly to your workflows and AI agents.

  • Customize User Experience: Drag, drop, and resize components for tailored interface layouts.


Using the Interface Builder

The Interface Builder is your design canvas. Here's how to create and configure interfaces:

1. Add Widgets

Widgets let you display and interact with data:

  • Charts (bar, line, pie)

  • Controls (toggles, buttons, filters)

  • Maps and gauges

  • Text boxes for static or dynamic content

  • HTML Widgets for fully custom UI components

2. Connect Widgets to Workflows

Each widget can:

  • Display data from a workflow output

  • Trigger a workflow when interacted with (e.g., via a button)

  • Show predictions or insights from AI nodes

3. Customize Widget Layouts on Interfaces

  • Use drag-and-drop to position elements

  • Resize widgets to prioritize key insights

  • Organize views using sections, tabs, or panels

4. Create Interactivity

  • Add form inputs, switches, or buttons

  • Dynamically update views based on real-time data or user input

  • Filter content by UID, time, user role, or custom labels


Managing Interfaces

The Interfaces Management Page provides a full list of existing interfaces in your environment.

Field Description
Search Interface Filter by name or keyword
Add New Launch the Interface Builder to create a new interface
Interface Name Click to open and edit
Interface Type Categorize as dashboard, control panel, or report
Number of Widgets Shows total visual/interactive components used
Created Date When the interface was originally created
Last Updated Most recent update timestamp
Action Options to view, duplicate, edit, or delete the interface
 

Creating a New Interface

To start building:

  1. Go to the Interfaces section in the left-hand menu.

  2. Click Add New.

  3. Provide a name and select an Interface Type.

  4. Use the Interface Builder to add widgets, connect workflows, and arrange your layout.

  5. Click Save  to make the interface live.


Use Cases

Interfaces are versatile and can be used for:

  • Real-time monitoring dashboards

  • Customer self-service portals

  • Field technician tools

  • Management control panels

  • Data input forms for operations or audits


Q&A

Q: Can I use my own HTML in an interface?
A: Yes. Use the HTML widget to insert custom HTML/JS/CSS components for fully bespoke UI elements.

Q: How do I show data from a workflow?
A: Bind your widget to a workflow output node. This allows real-time data updates in your interface.

Q: Can interfaces be shared externally?
A: Yes. You can manage access via user groups and permissions, and optionally white-label the interface.

Q: What happens when I update a published interface?
A: Changes can be saved as drafts and published when ready, preserving version control and preventing disruption.

Q: What types of widgets are available in the Interface Builder?
A: Rayven offers over 50 widget types including charts, gauges, tables, maps, form inputs, text blocks, toggles, buttons, and custom HTML components.


Q: Can I connect a widget to multiple workflows?
A: Yes, widgets can both display outputs from and send inputs to multiple workflows, allowing you to centralize logic and interface control in one place.


Q: Can I preview an interface before publishing it?
A: Yes. You can preview your interface in the builder at any time and test real-time interactions before publishing it to end users.


Q: How do I organize widgets into sections or tabs?
A: Use layout components such as sections, dividers, tabs, or containers to create logical groupings and improve user navigation.


Q: Can I filter data shown in widgets by user or location?
A: Yes. Use label-based filters, user group access controls, or input widgets (e.g. dropdowns, date pickers) to dynamically filter what’s displayed.


Q: Can I duplicate an interface and use it as a template?
A: Absolutely. Use the Duplicate action from the Interface Management page to clone an existing interface and modify it for a new use case.


Q: Is it possible to control who can see or edit an interface?
A: Yes. Access control can be managed using Rayven’s user group and role-based permissions to define who can view, edit, or interact with interfaces.


Q: How do I handle version control for interfaces?
A: While interfaces don't have built-in versioning, best practice is to duplicate an interface before making major changes. Save the old version as backup.


Q: Can I embed third-party apps or dashboards in my interface?
A: Yes. Use the Iframe widget to embed external URLs, apps, or tools within your Rayven interface.


Q: What’s the difference between 'dashboard', 'control panel', and 'report' interface types?
A: These are categories for organizational purposes:

  • Dashboard: Real-time visual monitoring

  • Control Panel: Interactive operational tools

  • Report: Summary or analytical views (often read-only)


Q: Are interfaces responsive on mobile or tablet devices?
A: Yes, interfaces are responsive. However, we recommend testing layouts on target screen sizes to ensure optimal usability, especially for custom HTML.