How to set up, name, configure, and manage interfaces and widgets for your application in Rayven.
Overview
Interfaces are the front-end pages of your Rayven application that Application Users interact with. Each interface displays a set of widgets—visual components such as charts, tables, forms, buttons, custom interfaces, and other UI elements—powered by Frontend Nodes in your workflows.
In this article, you'll learn how to:
-
Create and organise interfaces
-
Configure interface properties
-
Add widgets from workflows
-
Understand widget data sources and display logic
-
Use labels to control how widgets are displayed
-
Set up interface types and navigation structure
Creating and Managing Interfaces
To manage interfaces in your application:
-
Navigate to your application from the Rayven Workspace.
-
On the App Page, click the Interfaces button.
-
From this screen, you can:
-
Create new interfaces
-
Rename existing interfaces
-
Reorder them to control their display order in the app menu
-
Select an icon for each interface (used in the Application Interface menu)
-
Each Top-Level interface you create becomes a menu item in the Application Interface visible to end users—unless it’s configured as a Drilldown Interface (see next section).
Standard vs Analytics Interfaces
When creating a new interface, you'll choose one of two types:
-
Standard Interface: The default interface type for displaying any Frontend Node widgets.
-
Analytics Interface: A special interface type that includes a date range selector, allowing users to filter the displayed data by timeframe. Only compatible with widgets that support time-based data filtering.
Top-Level vs Drilldown Interfaces
Each interface must be one of the following:
-
Top-Level Interface: Appears in the left-hand menu of the App Interface.
-
Drilldown Interface: Hidden from the menu and only accessible by clicking through from a widget on another interface.
Top-Level Interfaces are typically used for main navigation (e.g., Dashboard, Customers, Admin). Drilldown Interfaces are used for detail views or custom UI flows.
Adding Widgets to an Interface
Widgets are visual components (e.g., charts, tables, images, custom UIs) that appear on an interface. To add a widget:
-
Use a Frontend Node in one of your application workflows.
-
Navigate to the Interfaces section in the Workspace.
-
Select the interface you want to configure.
-
Choose the available Frontend Nodes you wish to display as widgets.
Only Frontend Nodes used in a workflow will be available for selection in the interface configuration screen.
Note: You don’t configure layout here. Widget layout is managed by Admin users directly in the front-end App Interface.
Understanding Widget Types
There are two types of widgets in Rayven:
-
Pre-built Widgets: Include gauges, tables, charts, etc., with configurable settings (e.g., aggregation type, labels to group by). These pull data from the Cassandra workflow database.
-
Custom Widgets (UI Code Nodes): Created using HTML, CSS, and JavaScript. These offer complete flexibility and can read/write to tables, and optionally interact with workflows.
Controlling Widget Display Logic with Labels
Widgets can be configured to display differently based on label logic:
-
One Widget per UID – shows one widget per row in the Primary Table.
-
One Widget per Label Value – shows one widget per value within a selected label (e.g., Customer Type).
-
(Default) One Widget per Label – a single widget summarising across all label values.
These settings are applied in the Frontend Node configuration within the Workflow Builder.
Configuring Interface Appearance
In the Interface settings, you can optionally configure:
-
Interface background colour
-
Background image
-
Menu icon (visible in App Interface)
-
Interface name (used as the menu label)
Summary
Interfaces in Rayven are how users see and interact with your application. You configure which widgets appear on each interface by selecting Frontend Nodes from your workflows. Rayven supports both simple pre-built widgets and fully custom UI components.
Interfaces can be configured for analytics with built-in time filters, and widget display logic can be fine-tuned using label-based grouping. Layout is managed directly in the App Interface by Admin users.
FAQs
What is the difference between a Frontend Node and a Widget?
A Frontend Node is used in a workflow; when selected for an interface, it becomes a Widget that appears on the App Interface.
Can I customise the layout of widgets in the Workspace?
No. Layout is configured on the App Interface by users with the right permissions.
How do I restrict who sees each interface?
Use User Groups to assign interface access. Each group can be configured to only see specific interfaces.
What’s the difference between Standard and Analytics Interfaces?
Analytics Interfaces include a time range selector for widgets that support time-based filtering.
Can I use the same Frontend Node on multiple interfaces?
Yes. A Frontend Node can be added to one or more interfaces
Do all users see the same interfaces and interface layouts?
Not necessarily. Users will only see the interfaces assigned to their User Group(s). All users within the same User Group will see the same interfaces and the same widget layouts.
However, different User Groups can be configured to have access to different interfaces and can have distinct interface layouts. This allows you to tailor the user experience based on role, location, or other group-specific needs.