Main screen: dashboard and sections

When you open Routix Dash, you land on the home screen — your dashboard.

Data sections

Data sections are separate screens you swipe between horizontally. Each one has a name shown at the top of the screen.

If you don't have any sections yet, the home screen prompts you to add your first one. On the very first start the app also offers to create a demo section, Backend: its data pieces show fixed sample values and are not connected to any data source or destination, so you can look around the app and try the editor. If you skipped it, tap Create demo section on the empty home screen to add it any time. Delete it from the main menu (Delete current section) when you no longer need it.

Data pieces and section layouts

A section is a Fixed grid, a Resizable grid, or Freeform.

Inside a Fixed grid, every data piece is the same square. You can adjust:

Inside a Resizable grid, a data piece can cover more than one square. Virtual grid columns is one setting for every screen. The grid and the data pieces scale to the width and keep their shape. A data piece moved there from a Fixed grid starts as a block of four squares (two by two). Moving it back to a Fixed grid makes it one square again. A Resizable grid has the same Data piece background setting.

Freeform

Freeform is one canvas. Put data pieces and components anywhere, including on top of each other. The canvas scales to the width of the screen and keeps each item’s shape. It grows and shrinks with the lowest item, and scrolls when that is taller than the screen.

Edit layout turns on edit mode on this section, with a dashed frame around it. A dotted grid is always on. When you move an item, its left and top edges snap to the grid and its size stays the same. When you resize it, the edge you drag snaps. So items placed next to each other line up exactly. Grid size at the top makes the grid finer or coarser; this device remembers it.

Tap an item to select it, then drag a side or corner to change its size. A selected data piece, component, or group has a rotate handle at the top-right. Drag it to turn the item in 15° steps. Hold and drag an item to move it.

Add at the top offers Add data piece and Add component. Both open the library with Components, Grouped, and Data pieces, and the new item lands on the canvas with Edit layout on.

While Edit layout is on, tap an item, then tap its menu button for Edit, AI assistant, Duplicate, Move, Bring to front, Send to back, and Delete.

See Components.

In the section editor, Data piece background works here too. It applies to data pieces only, not to components or component groups on the canvas.

Data piece spacing in the section editor sets the gap around data pieces, from 0 to 20 (7 by default), like the spacing on a grid. Each data piece is drawn a little inside its frame, and the canvas has a small margin. So data pieces placed edge to edge have equal gaps between them and the same margin at the screen edges. Components and groups on the canvas fill their frame exactly, with no gap.

A Freeform section can have a Root data source: components on the canvas use it unless you pick another source for them. Set it, and the section's Periodic action pipes, in the section editor (Edit section at the top while Edit layout is on).

A Freeform section is always on the main screen. For a layout you show only when needed, opened by a tap with Open screen, use a custom screen.

Edit layout

Tap Edit layout to move data pieces. On a Resizable grid you can also drag an edge to change the size. Tap Edit layout again when you are done. While Edit layout is on:

The selected item shows a round menu button (three dots) just outside its frame, usually below it. When there is no room, the button moves above or to the side, and it moves with the item while you drag or resize it. Tap it for the item menu. The item menu works only while Edit layout is on. On a grid, long-press a data piece to move it.

Data setting

Data sections and data pieces each have a Data setting, the last one in their editor: your own notes or data, up to 5120 characters, as plain text or JSON. It is stored as is and not evaluated. A script on a data piece can read it as comp.userData. Don't put secrets there. See Components.

Data piece wizard

The wizard builds a working data piece for you, one question at a time. Tap Add (the + button), choose Add data piece, then choose Wizard. Manually opens the Data piece library instead.

Each question has its own screen. A progress line and Step n of m under the app bar show where you are, and your answers so far appear as chips. Tap a chip, or Back at the bottom, to answer that question again; the answers after it are cleared. The button for the current step is at the bottom. Cancel in the app bar (the × button on a narrow screen) leaves the wizard.

  1. Where does the data come from? Pick MQTT, WebSocket / Socket.IO / SSE, HTTP request (polling), HTTP stream, Timer, or Video (MJPEG).
  2. Choose a connection (MQTT and WebSocket only). Pick an existing one or create a new one. A dot shows whether it is connected.
  3. Choose a data source. Pick an existing data source of that kind, or create a new one. For MQTT, the step title adds an example: a topic subscription.
  4. Live data. The wizard listens to the data source and shows the first value it gets, with its type, for example "Number · 23.4". If nothing arrives in 15 seconds, choose Retry or Continue without data. Video waits for the first frame instead.
  5. Extract a value from JSON? Shown only when the data is JSON. Pick one value from the list, or type your own expression. The wizard shows the expression and its result on the current data, for example {{ value.temperature }} = 23.4. It is added as a transformer of the data piece, so you can change it later. To show the whole message instead, choose No, use the whole message.
  6. How should it look? Pick one of the suggested components. Each card is a live preview with your data. A number can become a value label, a gauge, a chart, or a slider; on/off can become a switch; a JSON list can become a data table or a chart. A camera picture from an MQTT or WebSocket message is offered as a Video first, then as an Image. The last card, I will design it myself, adds a data piece with only the title and the activity bar, and you add components in the data piece editor.
  7. Send changes back? Shown only for controls, such as a switch, slider, or text field. Yes, send changes picks or creates a data destination that is filled in from the data source, for example the same MQTT connection and topic. No, read-only adds the control without sending anything. A text field that sends changes gets a Send button under it, so the text is sent when you tap Send, not on every key press.
  8. Name and add. The name starts as the data source name. Tap Add data piece. The data piece is added to the section and opens in the data piece editor, where you can fine-tune it.

If you leave the wizard early, it lists the connections, data sources, and data destinations it created and asks whether to Keep or Remove them. Items that existed before are never touched.

Data piece library

Add data piece asks Wizard or Manually. Manually opens the library on the Data pieces tab. On a Fixed grid or a Resizable grid, that is the only tab. On a Freeform section, the library also has Components and Grouped.

The tab starts with ready-made data pieces: Design your own data piece, Value, Dial gauge, Knob, Chart, Switch, Mode selector, Alarm, Value with progress bar, Progress ring, Value with trend, Value with bar chart, Progress list, Room, Icon switch, Color picker, Joystick, Status list, Timeline, Number stepper, and Heater switch.

They have no data source yet, so pick one in the data piece editor after you add them. Design your own data piece adds a plain new data piece with a Header label and a Data source activity bar.

To reuse a data piece you built, turn on Edit layout, tap it, then tap its menu button, choose Save to library, and give it a name. It appears after the ready-made data pieces. A saved data piece keeps its data sources, data destinations, and the screens it opens, exactly as they were. On a Resizable grid and on a Freeform section, it also keeps its size.

Quick interactions