> For the complete documentation index, see [llms.txt](https://docs.chirpwireless.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chirpwireless.io/overview.md). # Overview The home overview is the first thing you see when you open Chirp. Think of it as your home's front page — a single screen that tells you whether everything is running smoothly, which devices need attention, and what's happened recently. The overview is available on plans that include the Overview feature. If your plan includes it, it loads automatically when you log in. ## Where to find it Tap **Overview** in the sidebar. ## What you'll see The overview is divided into a few easy-to-scan sections, each showing a different slice of your home's status. ### "My board" and Live Data The heading **My board** sits at the top of the page, next to a **Live Data** button. The Live Data button is a small clickable icon. When you hover over it, a tooltip reads **"New data is automatically displayed"** — meaning Chirp keeps the overview fresh as new sensor readings arrive. If you've just made a change (like adding a new sensor) and want to see it reflected immediately, click the button to trigger a manual refresh. ### Summary cards Below the header, a row of summary cards gives you an at-a-glance view of your smart home. The row scrolls sideways if there are more cards than your screen can fit. Cards you'll see include: * **Devices** — Shows how many devices are registered in your home. A small warning indicator appears on the card when Chirp can't confirm a device is reporting — either it has never sent anything, or it has gone quiet for longer than its **Data sending interval** — the field where you tell Chirp how often the device is configured to send (see [Adding Sensors](/devices/adding-sensors.md)). Tapping the card takes you to the full device list. A small add button in the corner lets you start registering a new device right from here. * **Gateways** — Shows how many gateways you have connected. Warning indicators appear if a gateway has gone offline or become inactive. Tapping takes you to the gateways page, and the add button starts the gateway setup flow. These cards work as both a status check and a shortcut. If you see a warning number, you know something needs your attention before you even open the details. ### Notifications Below the cards, a **Notifications** panel shows recent alerts and events — what happened, which device triggered it, and when. If a door opened while you were out or a temperature crossed a threshold overnight, you see it here without opening the full alarm inbox. ### Add a sensor At the bottom of the page, a dedicated **Add Device** section makes it easy to register new sensors or gateways. This is especially helpful when you're first setting up your home and the overview is still empty — it's the natural "what to do next" prompt. ## When your home is brand new If you've just created your Chirp account and haven't connected anything yet: * The **Devices** and **Gateways** cards show **0** with no warnings. * The **Notifications** section has nothing to display. * The **Add Device** section at the bottom invites you to get started. As soon as you connect your first sensor and gateway, the cards light up. Readings flow in and notifications start tracking what matters. ## Making the most of your overview * **Use notifications as a morning briefing.** Scroll through recent notifications to see what happened overnight without opening each sensor individually. * **Tap the Live Data button after adding a sensor.** When you've just registered a new sensor, tapping Live Data confirms that Chirp is receiving its readings right away. ## What's next * [Finding Your Way Around](/first-steps/finding-your-way-around.md) — A tour of the full Chirp interface. * [Adding Sensors](/devices/adding-sensors.md) — Register your first sensor. * [Building a Dashboard](/dashboards/building-a-dashboard.md) — Create a custom view tailored to a room or purpose. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.chirpwireless.io/overview.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.