The Dashboard

How to read the RoamVitals dashboard - the status card at the top, the Vitals tiles, widgets, and what each status colour and chip means.

In the app: /

The Dashboard is the first screen you see after signing in, and the first item in the navigation. It answers one question before anything else: is everything okay right now.

Read it from the top down. The status card tells you whether anything needs you. The Vitals row tells you how much you have and how much of it is reporting. Everything below that is detail.

The top row#

Across the top of the page you will see:

• The page title Dashboard.
• A small round-dot chip that says either 3 online (with the number of hubs currently reporting) or Offline. The chip is about the app's live connection to RoamVitals. When it says Offline the page is no longer receiving instant updates and is relying on its own timed refresh. Hover it for a short explanation.
• Updated 7:12:04 AM, the time the page last pulled fresh data. It appears after the first load.
• A refresh button. Press it to pull new data immediately instead of waiting. It shows a spinner while it works.

The page pulls fresh data by itself roughly once a minute. Both that timed pull and the refresh button re-read your hubs, your sensors and your alert messages.

When a new alert fires while you are on the page, a short message slides in at the bottom right for a few seconds with the alert text. It has an X if you want it gone sooner.

The status card#

Directly under the title is the status card. It changes shape with the situation, so you can tell the state from across the room.

Nothing wrong. A green tick, All systems normal, and underneath, Nothing needs your attention.

Something informational. A plain card with one row per item. The usual row here is a sensor that has gone quiet. An offline hub also lands here if you have set hub-offline to Info in Settings.

Something to look at. A small heading, Needs a look, and one row per item. This is the shape used for warnings, and, with the default setting, for an offline hub.

Something urgent. A red-tinted card with a ◆ diamond, the worst item in bold, and Started 14 min ago underneath. If that worst item is an alert it also carries an Acknowledge button. Anything else still open is listed under a divider below it.

Each row in the card shows a status badge, the message, how long it has been going on (just now, 14 min ago, 3 h ago, 2 d ago), and an Acknowledge button when the row is an alert. Rows that are not alerts, such as an offline hub or a quiet sensor, have no Acknowledge button, because there is nothing to acknowledge: they clear themselves when your equipment starts reporting again.

One thing to know about timing. The offline-hub and quiet-sensor rows keep up on their own, on the timed refresh. The alert rows are read when the app loads. An alert that fires while you are sitting on the Dashboard reaches you as the pop-up message, and it appears in Unread Alerts and in Recent Alerts straight away, but it does not add a row to the status card until you reload the page or open Alerts.

While you are inside your quiet hours and nothing critical is open, the card takes the plain shape and adds a line above the rows: Quiet hours - non-critical alerts are muted until morning. Quiet hours are set in the Notifications card under Settings.

Two related surfaces are not part of the Dashboard but appear above it, on every page:

• A sticky coloured banner across the top of the page content for anything that has been set to pin a banner. It carries an Acknowledge button for alerts, and a small X for offline or quiet-sensor notices.
• A full-screen takeover, used by default for safety alerts (the carbon monoxide and smoke class), with I'm safe - acknowledge. For a non-alert takeover the button reads Got it.

Which alerts get a banner and which get a takeover is your choice, under Settings, in the card titled How alerts look on your screens.

The Vitals row#

Four tiles, in one row on a computer and two by two on a phone. On a narrower window they sit under a small Vitals heading.

While hubs are still loading, the first two tiles show a dash.

Unread Alerts counts individual alert messages, not ongoing problems. One problem that keeps reminding you adds a message each time, so this number can be higher than the number of rows in the status card, which collapses one ongoing problem into one row. It is counted over your hundred most recent messages, and it only covers hubs you own - alerts from a hub somebody shared with you are not in it.

Only Unread Alerts changes colour to mean something: it turns red as soon as the count is above zero. The small icon tints on the other three tiles are fixed decoration and do not change with the numbers.

If you hid the summary row on your hub's own screen, it is hidden here too.

Camper Map#

If you have pinned sensors onto a camper outline on your hub, that map appears next, titled Camper Map, with the template name on the right.

Each pin is a coloured dot with a small label above it showing the latest value the app has for that sensor. The dot colour is the sensor's status. Below the map is the full five-status legend: Normal, Warning, Critical, Offline, Stale.

Hover a pin's label to see the pin's label text and its status.

If you set your own camper photo on the hub, the map here falls back to the standard silhouette and says so underneath. Your pins are still in the right places.

The default layout: Your Hubs and Recent Alerts#

Unless you have built your own widget layout, the rest of the page is headed Overview and holds two panels.

Your Hubs lists one card per hub, with a Manage button that takes you to the Hubs page. Each card shows:

• The hub name and a status badge.
• 3 sensors · v1.4.2, the sensor count and the software version on the hub.
• Last seen: 8/16/2026, 7:04:11 AM, when the hub last checked in. A hub that has never checked in has no such line.

Select a card to open that hub. If you have no hubs yet, the panel says No hubs connected yet and offers Add Your First Hub.

Recent Alerts lists up to five alert messages you have not acknowledged, newest first, each with a severity badge, the alert text, and the time it fired. The tick button on the right acknowledges that one message. View All opens the Alerts page. When there is nothing outstanding, the panel shows a tick and All clear!

Your widgets#

If you build your own layout, the heading changes to Your widgets and your widget grid replaces both the hub list and the Recent Alerts panel. To see your hubs or your alert history after that, use Hubs and Alerts in the navigation.

What each widget shows:

• Hub Health - hubs online out of total, for example 3/4, with All hubs healthy or a count of hubs reporting errors.
• Sensors Overview - total sensors, with how many are online underneath.
• Active Alerts - how many alert messages are unacknowledged, plus the most recent one. Shows All clear at zero.
• Alert History (7 Days) - the total for the week as a number, then seven daily bars, oldest on the left. The caption reads Daily counts, oldest to newest, or tells you how many were critical this week. All seven bars turn red once any message in the week was critical.
• Sensor Value - one sensor's latest reading as a big number, with Updated 7:14:02 AM underneath. If the sensor last reported on an earlier day, the date is included so you are not misled. If the sensor has never reported, that line shows the sensor's status word instead.
• Sensor Trend Chart - a line chart of that sensor's recent readings. Hover a point for the value. Reads No readings yet when there is no history.
• Gauge Dial - the reading printed in the middle of a half dial, with the measurement name underneath. For a reading that is already a percentage the dial runs 0 to 100 and the arc turns amber at 90 and above or at 10 and below. For anything else the dial has no fixed range to work from here, so it scales itself around the reading: the needle sits in the same place whatever the number is, and the arc stays in the normal colour. The low and high ends of a dial can only be typed in on your hub's own Add widget form.
• Battery Status and Tank Level - the value and the measurement name, and a fill bar when the reading is a percentage. The bar turns red at 20 percent or less. A sensor with no reading yet shows No readings yet instead.
• Multi-Sensor Trend - up to four sensors on one chart, with a coloured dot and the latest value for each. It takes your first four sensors automatically when you add it; there is no step for choosing them. Underneath it says Each line is scaled to its own range., which is your warning to compare shapes, not heights.
• Camper Map (Mini) - a small version of your rig outline with its pins, and a count of pinned sensors, or No pins placed yet. Its own heading reads Camper Map, and its pins are plain dots in one colour, not status colours. For status colours use the full Camper Map higher up the page.
• Clock - the time in hours and minutes, with the weekday and date underneath.
• Saved Reports - how many reports you have saved, over the line Build, run, and schedule them in Reports.
• Report Result - runs one of your saved reports and shows its chart, or the number of rows it returned over rows in the last run. It shows Running… while it works, and Could not run this report here. if the report will not run.

A widget you do not recognise, saying it was added on another device and needs an app update, came from a newer version of another RoamVitals screen. It is kept, not deleted, so it will display once your app catches up.

A widget pointed at a sensor that has since been removed reads Sensor not available. It is also kept: remove it yourself, or point a fresh widget at a sensor you still have.

Changing the layout#

1. Select Customize dashboard (or Edit layout if you already have one). The heading changes to Editing layout. Starting from scratch drops you straight in with three widgets already placed - Hub Health, Active Alerts and Sensors Overview, in two columns - which you can then rearrange or remove.
2. Choose which screen you are editing with the Desktop, Mobile and TV buttons. The web app itself uses Desktop or Mobile depending on your window width. On Mobile or TV, a chip reading ⤳ Inherits from Desktop means that screen has never been given its own layout and is borrowing the Desktop one.
3. Pick 1 column, 2 columns or 3 columns. On a phone-width window everything stacks into a single column whatever you pick here.
4. Select Add widget, pick a widget, and pick a sensor or a saved report if it asks for one.
5. Use the small buttons at the bottom of each widget to move it left or right, make it narrower or wider, or remove it. A widget can be up to three columns wide, and never wider than the grid you chose. With nothing placed you get No widgets yet - use "Add widget" to build your dashboard.
6. Select Save, or Cancel to throw the changes away.

Save writes only the screen named in the buttons at that moment, and switching to another one reloads that screen's saved layout over your draft. Save before you switch, or you will lose the changes you just made.

In the picker, widgets that need a sensor are greyed out until you have one, Multi-Sensor Trend needs at least two, and Report Result needs at least one saved report.

Your layout is shared with the screen on your hub, so what you save here can also change what shows there.

Status colours and badges#

Five statuses are used everywhere in the app. Each one has its own shape as well as its own colour, so you never have to rely on colour alone.

Offline and Stale are drawn cool and muted with a dashed outline on purpose. A gap in the data is not a danger, and it should never look like one.

On a hub card the badge keeps the shape and colour above but is labelled with the hub's own word: Online, Offline, Updating while it installs new software, or Error. A hub is marked offline when it has not checked in for about ten minutes.

On an alert row the badge is labelled with the alert's level: Critical, Warning or Info. An Info badge is drawn in the same calm colour as Normal, because an informational event is a note, not a health state.

A sensor counts as stale when it is connected but its newest reading is more than 30 minutes old. When that happens you will see a row in the status card such as Fridge has been quiet for over 30 min - probably fine, just no signal, or a count when several go quiet at once.

How to read a reading#

A reading has three parts: the number, the unit, and when it was taken.

• Numbers are rounded to two decimal places.
• Temperatures and pressures are shown in the units set on your hub. New accounts read in °F and psi.
• The Updated line under a value is when the sensor last reported, not when you last refreshed the page. If that was on an earlier day, the date is shown as well as the time.
• Trend charts plot the numbers as the sensor recorded them, so the unit named in a chart tooltip can differ from the unit on a value tile if you have chosen a different one.

Worked example#

You open the app at 7:14 in the morning and the page looks like this.

The status card is red-tinted with a ◆ diamond:

◆  Fridge too warm - Fridge
   Started 2 min ago                         [ Acknowledge ]

The card names the alert rule first and the sensor second, so you know what tripped and where.

The chip at the top says 1 online. The Vitals row reads:

Total Hubs 1    Online Hubs 1    Sensors 6    Unread Alerts 1

Both hub tiles agree, so nothing is out of contact. One alert message is waiting on you.

Under Recent Alerts the top row reads:

◆ Critical
Alert 'Fridge too warm': temperature above 40 °F (now 54.14 °F)
8/16/2026, 7:12:04 AM

Read it as: your rule named "Fridge too warm" watches temperature, its limit is 40 °F, and the fridge is currently 54.14 °F. It fired two minutes ago, which matches the Started 2 min ago on the status card.

You go and shut the fridge door properly. Once you have, select Acknowledge on the status card. That row leaves the card, and when it was the last thing outstanding the calm All systems normal card takes its place. Acknowledging here tells RoamVitals somebody is on it, so the reminders stop.

It does not tick off the message itself, so Unread Alerts still reads 1 and the message is still sitting in Recent Alerts. To clear the message, use the tick button on its row in Recent Alerts. On the Alerts page a message only gets its own Acknowledge button when there is no ongoing problem behind it; otherwise it lives inside that problem's timeline.

What to do if#

A value tile shows a dash, or says "No readings yet". The Sensor Value, Gauge Dial, Battery Status and Tank Level widgets, and the values on the camper map pins, fill in from live readings the app receives while you are signed in, and they start empty each time you reload the page. Opening Hubs and then your hub gives the app somewhere to pick those readings up: if the hub sends readings while you have that page open, the values carry over to the Dashboard for the rest of your session. Sensor Trend Chart and Multi-Sensor Trend do not depend on this, because they load history directly, and the Updated line on Sensor Value is correct either way.

The chip at the top says Offline. The app is not receiving live updates. Alerts and status will still appear, just on the timed refresh rather than instantly. Check your own internet connection first, then press the refresh button.

A hub badge says Offline. The hub has not checked in for about ten minutes. Power, internet at the RV, or the hub itself. Open the hub from the Hubs page for its details. The status card will also carry a row reading Basecamp is offline - readings paused.

Something is marked Stale. The sensor is paired but has not sent anything for over half an hour. You will see it as a row in the status card, and as the pin colour on the camper map. This is usually range or a sleeping device rather than a fault, which is why it is never shown in red.

You want alerts to shout louder or quieter. Go to Settings and use How alerts look on your screens to choose what warnings, alarms, safety alerts and hub-offline notices do on screen. Quiet hours are set in the Notifications card on the same page.