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.
- Swipe left or right to move between sections.
- Routix Dash remembers which section you were on.
- You can create as many data sections as you want. With Pro, data pieces, components, custom screens, and bottom sheets are not limited either. Without a paid plan, you can have up to 30 data pieces and Freeform components in all sections together, up to 200 components inside data pieces, and two custom screens and two bottom sheets, with up to 30 components across all of them. When you reach a limit, the app opens Plans. See Plans.
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:
- Column counts for small and big screens, in vertical and horizontal layout, and the spacing between data pieces
- Data piece corner radius
- Data piece background: Solid, Soft gradient (the default), Tinted gradient, Top light, or Custom gradient.
- Set Gradient direction (not for Top light) and Gradient strength (not for Custom gradient).
- The soft, tinted, and top light gradients follow the app theme, so they look right in light and dark theme.
- Custom gradient lets you pick a start and end color for the light theme and for the dark theme.
- A data piece with its own background color keeps that color.
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.
- Edit on a data piece opens the data piece editor. Edit on a component opens its settings. On a group, Edit contents opens what is inside.
- Every item also has Paste, and a component or group has Copy and Cut.
- Long-press the empty canvas for Paste. A paste on the same canvas goes to the nearest free spot. Data pieces are not copied this way.
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 top bar shows Edit section (opens the section editor) and Add, and hides the top-right menu button.
- Swiping between sections pauses.
- Tapping a data piece or a component selects it and does not run its tap actions.
- Pinch with two fingers to zoom the section, and drag with two fingers to look around. Turning Edit layout off resets the zoom.
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.
- Where does the data come from? Pick MQTT, WebSocket / Socket.IO / SSE, HTTP request (polling), HTTP stream, Timer, or Video (MJPEG).
- Choose a connection (MQTT and WebSocket only). Pick an existing one or create a new one. A dot shows whether it is connected.
- 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.
- 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.
- 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. - 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/offcan 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. - 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.
- 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.
- Long-press a saved data piece in the library for Edit, Rename, Export, Import, and Delete. Edit changes only the saved copy, not the data pieces you already added.
- Import at the top of the tab adds a data piece that was exported from the library.
- Ready-made data pieces cannot be edited, renamed, exported, or deleted.
- You can save as many data pieces as you like. Adding one to a section still counts toward the data piece limit of your plan.
Quick interactions
- While Edit layout is on, tap Add at the top. On a grid section it adds a data piece. On a Freeform section, choose Add data piece or Add component. A new data piece is added to the section you are on.
- Add data piece asks Wizard or Manually; see Data piece wizard. Manually opens the library on Data pieces; see Data piece library.
- On a Resizable grid, the data piece you pick is added right away and Edit layout turns on. The new data piece is selected, so its menu button shows. It shows Tap the menu button for more (Click the menu button or right-click for more when a mouse or trackpad is connected to an iPad) and Resize by dragging sides or corners.
- On a Fixed grid, the data piece you pick opens in the data piece editor.
- To add a section, a data source, or a data destination, use the menu.
- Without Pro, all sections together hold up to 30 data pieces and Freeform components; past that, the app opens Plans.
- Open the menu (top right) to manage sections, data pieces, connections, sources, destinations, plans, and settings. See Menu and navigation.
- While Edit layout is on, tap a data piece on the home screen, then tap its menu button for more options like edit, duplicate, move, or delete. In list screens, long-press works anytime.
- In editor lists (transformers, tap actions, sources, destinations, connections, variables, and similar), swipe a row right to left to delete it.
- Tap a data piece or component to run its tap actions, if it has any. If the data piece has tap actions turned on, the tap runs those and does not reach components. On long press runs configured On long press lists on components. Outside Edit layout, long-press does not open the edit menu. While Edit layout is on, tap and long-press action lists do not run.