How to configure application interfaces, manage widgets, and define navigation using the Rayven Workspace.
Overview
Interfaces in Rayven are the pages your application users see when they log into the front-end of your application. As a Workspace user, you define which interfaces exist, what data each interface displays via widgets, and how they are named and structured. Interfaces are the core mechanism for visualising and interacting with your application’s functionality—whether through charts, forms, maps, or custom UI elements.
This article explains how to create and manage interfaces from the Workspace, configure what widgets appear on each, understand interface types and navigation structures, and delegate layout control to Application Users.
Creating and Managing Interfaces
In the Workspace, navigate to the Interfaces section of your application to:
-
Create a new interface
-
Rename or delete existing interfaces
-
Reorder interfaces using drag-and-drop (which determines the left-hand menu order)
-
Assign interface icons (shown in the app menu)
-
Select which Frontend Nodes (i.e. Widgets) are available on each interface
Widgets are not designed or arranged within the Workspace. Instead, layout configuration is done by Application Users (with appropriate permissions) via the front-end at https://app.rayven.io.
Interface Type Overview
When creating a new interface, you will be prompted to select a type. Rayven offers two:
-
Standard Interface – the default interface type used in most applications.
-
Analytics Interface – includes built-in date range filtering, suited for reporting or historical data review.
Interface Navigation Types
Each interface in Rayven can be either:
-
Top-Level Interface – shown in the app's left-hand menu.
-
Drilldown Interface – accessed via interactions within widgets, not shown in the menu.
Selecting Widgets for an Interface
To make a widget available on an interface, it must first exist as a Frontend Node in a workflow. If the node isn’t used in any workflow, it won’t appear in the interface configuration screen.
Once the Frontend Node has been added to a workflow:
-
Go to the Interfaces section in the Workspace.
-
Select the interface you want to edit.
-
Choose from the list of available widgets (i.e. Frontend Nodes) and tick the ones you want to display on the interface.
Widgets only become available for selection after the corresponding node has been added to at least one workflow in the current application.
Understanding Widget Layout and Customisation
Widget layout—including position and size—is managed by Application Users directly in the App Interface (front-end). Only users with the appropriate interface editing permission can make these changes.
To edit layouts, a user must:
-
Have a role of Super Admin, Admin, Customer Admin, or Editor
-
Be granted the "Edit Interfaces" permission on their user record
Without this setting, users can view interfaces but cannot move or resize widgets.
Widget Display Settings: One Widget or Many?
For each Frontend Node, you can control how many instances (widgets) of it appear on the interface using the Number of Widgets to Display setting:
-
One Widget per Label (default)
One widget for the selected label (e.g. one summary per label type). -
One Widget per Label Value
One widget for each unique label value (e.g. per Region or Customer Type). -
One Widget per UID
One widget per unique primary record (e.g. per Asset or Customer).
Backgrounds, Colours & Icons
Interfaces can have optional backgrounds configured:
-
Solid background colour
-
Image background
-
Menu icon per interface (shown in App Interface menu)
These settings are available when creating or editing an interface in the Workspace.
Managing Interface Access
Access to interfaces is controlled via User Groups.
When setting up a User Group:
-
You specify which interfaces are visible to users in that group.
-
You also define what data each user group sees using label-based filters.
All users in the same User Group share the same interface structure and widget layouts. To provide different layouts or interface visibility, create separate User Groups and configure them with different access rules.
Summary
Rayven’s interface system lets you modularly construct the front-end of your application. You control what interfaces exist, what data appears on them, and how users interact with those pages. While structural and access settings are configured in the Workspace, the layout of each interface is determined directly by Application Users in the front end. This separation allows for flexible, secure, and role-appropriate control over application UX.
FAQs
What’s the difference between Standard and Analytics Interfaces?
Standard Interfaces can show any type of widget. Analytics Interfaces are designed for date-range-based filtering and only support compatible widgets (e.g. charts, calculated tables).
Can I change the layout of an interface in the Workspace?
No. Layout changes (dragging/resizing widgets) are made directly in the App Interface by users with "Edit Interfaces" permissions.
How do I show a custom widget I coded in HTML/JS?
Use the UI Code node in a workflow. Then select that node in the interface configuration to make it appear as a widget.
Can I control which interfaces users see?
Yes. This is done via User Groups. You assign which interfaces a User Group can access during configuration.
Do I need a new interface for each page in my app?
Not necessarily. You can use Drilldown Interfaces for layered navigation or design a single interface that handles its own navigation via UI Code nodes.
Can two users in the same group have different interface layouts?
No. Users in the same User Group share the same layout. To provide different layouts, create separate User Groups.