Connection state chips
Every device in the RoamCore catalog now wears a small coloured chip next to its name. The chip tells you, at a glance, whether that device is ready to plug in and use, needs a small action from you, or has hit a problem — and a tiny pill beside the chip tells you honestly who built it.
What you see on screen
Beside every device name in the catalog, you'll see two small things:
- A coloured chip — green means everything is fine, yellow means you need to do something small, red means something needs your attention.
- A pill next to it — a single word telling you who built this device, so you know whether RoamCore maintains it end-to-end or you're relying on someone else.
Below them is a small Connect → button that takes you straight to the device's setup page. One tap, you're there.
What the chip colours mean
The chip uses the same colours as a traffic light, so you can read it from across the van:
| Chip | What it tells you |
|---|---|
| Green — Available | The code is shipped and the device is ready to install. |
| Green — Ready to connect | The device is set up and waiting for you to link it. |
| Bright green — Connected | The device is wired in and showing live readings. |
| Cyan — Detected | The system has seen the device on your van. |
| Cyan — Connecting | The device is linking up right now. |
| Yellow — Needs info | The device needs a small piece of information from you. |
| Amber — Needs attention | Something needs a quick look from you. |
| Grey — Unsupported | RoamCore can't work with this device yet. |
| Red — Offline | The device isn't reachable right now. |
| Purple — Update | A newer version is ready to install. |
If the chip says something you don't expect — for example, Offline when you can see the device is fine — refresh the dashboard once. The chip will refresh too.
What the pill next to the chip means
The pill answers one honest question: who built this?
| Pill | What it tells you |
|---|---|
| RoamCore Certified | RoamCore builds and maintains this end-to-end. It works the way we say it works. |
| Community Verified | A member of the community tested this on a real van and it works. RoamCore doesn't maintain it day-to-day. |
| Experimental | It builds but hasn't been integration-tested yet. Useful for tinkerers; not a day-to-day driver. |
You don't need to memorise these words — they're written in plain English on the catalog page, and the chip beside the device tells you everything else.
What to do when a chip changes
Most of the time, you don't need to do anything. Devices in Available or Connected are working as expected.
If a chip shows Needs info or Needs attention, open the device's setup page — it will tell you exactly what to enter or what to check. Usually it's a one-time step, like entering a password or confirming the device is plugged in.
If a chip shows Offline and you can see the device is fine, refresh the dashboard once. If it still says Offline after that, the device's page will tell you what to check (usually the Wi-Fi, the power, or the cable).
What to do if it goes wrong
If a chip stays the wrong colour for longer than a few minutes, the most common cause is the device is on a different Wi-Fi network, has lost power, or the cable has come loose. Power-cycle the device once and refresh the dashboard. If the chip still doesn't match what you see, the device's page has a short troubleshooting checklist — that's the next place to look.
You don't need to memorise the chip colours or the pill words — the dashboard always tells you what to do next.