> 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/dashboards/adding-widgets/digital-building-twin.md).
# Digital Building Twin
The Digital Building Twin lets you build a 3D model of your home and watch your sensors come to life inside it. Draw your rooms, drop in the furniture, place your sensors where they really are — and then the model lights up: the bedroom glows warm, the front door shows open, the basement turns blue when the leak sensor gets wet.
It's the difference between reading "Sensor 4: 1" in a list and glancing at a picture of your house where the garage door is clearly, visibly open. Your home stops being a column of numbers and becomes something you can actually *see*.
And it's all built right into Chirp. There's no extra app to download and no design software to learn. You sketch the layout, furnish it from a library of more than 60 ready-made 3D objects, connect each one to a sensor, and pick the colors that mean "all good" and "look at this." Once it's done, it sits on your dashboard like any other widget.
## What you can make with it
* **A 3D model of your home** — draw walls, doors, and windows across as many floors as your house has, in a flat 2D view or a 3D view. See [Drawing your home](/dashboards/adding-widgets/digital-building-twin/drawing-your-building.md).
* **A head start from a plan** — if you have a floor plan as a DXF file, import it instead of drawing. See [Importing a floor plan](/dashboards/adding-widgets/digital-building-twin/importing-a-dxf-plan.md).
* **A model traced from a map** — draw your home's outline straight onto a satellite map. See [Tracing from the map](/dashboards/adding-widgets/digital-building-twin/tracing-from-the-map.md).
* **A furnished home** — add sofas, beds, the fridge, a parking spot, and more from the object library. See [Placing objects](/dashboards/adding-widgets/digital-building-twin/placing-objects.md) and the [Object library](/dashboards/adding-widgets/digital-building-twin/object-catalog.md).
* **A live picture of your home** — connect sensors to objects and choose colors so the model reacts as things change. See [Connecting sensors and colors](/dashboards/adding-widgets/digital-building-twin/binding-sensors-and-colors.md).
* **Readings shown right in the room** — pin a sensor's value to a spot in the model. See [Pins and live readings](/dashboards/adding-widgets/digital-building-twin/drop-pins-and-live-values.md).
* **A home placed on the real map** — anchor your home to its real-world location. See [GPS anchoring](/dashboards/adding-widgets/digital-building-twin/gps-anchoring.md).
## Adding a Digital Building Twin to a dashboard
The Digital Building Twin is a dashboard widget. In the widget picker it's listed as **Digital building twin**.
1. Open the dashboard you'd like it on and switch the dashboard to **edit mode**. (Not sure how? [Adding Widgets](/dashboards/adding-widgets.md) explains edit mode and the widget picker.)
2. In the widget picker, click **Digital building twin**.
3. The home editor opens full-screen. This is where you draw, furnish, and connect everything — each page in this section takes one part of that.
4. When you're happy with it, click **Save** in the top-right corner. A **Widget name** box appears — type a name and click **Save** again.
5. The editor closes and your Digital Building Twin appears on the dashboard, showing the model with live sensor colors.
Want to change it later? Open the dashboard in edit mode and open the widget's settings — the full editor opens again with everything just as you left it.
## How it looks on your dashboard
Once saved, the widget sits on your dashboard grid like any other tile — you can resize it, drop it in a folder, and share it with the household. On the dashboard the model is view-only: it shows your home with live colors and readings, and any editing happens back inside the full editor.
Whatever view you leave the editor in is the view the dashboard shows. Save it in the flat 2D view and the dashboard shows a clean floor plan. Save it in 3D, tilted the way you like, and that's the angle the tile opens at.
## Where to start
* New here? Read the [Editor tour](/dashboards/adding-widgets/digital-building-twin/editor-tour.md) first to learn your way around.
* Want to dive in? Go to [Drawing your home](/dashboards/adding-widgets/digital-building-twin/drawing-your-building.md).
* Got a floor plan already? See [Importing a floor plan](/dashboards/adding-widgets/digital-building-twin/importing-a-dxf-plan.md).
## See also
* [Adding Widgets](/dashboards/adding-widgets.md) — Edit mode and the widget picker
* [Conditions](/dashboards/adding-widgets/conditions.md) — How color rules work across your widgets
---
# 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/dashboards/adding-widgets/digital-building-twin.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.