> 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/editor-tour.md).

# Editor Tour

The Digital Building Twin editor is a full-screen workspace where everything happens — drawing rooms, adding furniture, connecting sensors, setting up the view. This page is a quick walk around it so the rest of the section makes sense. Think of it as the welcome tour; the other pages are the detailed how-tos.

When you add a **Digital building twin** widget, the editor opens with a small starter model already there — a building with one floor. You grow it from there.

## The bottom toolbar

The toolbar in the middle of the bottom edge is your main control. It has four modes:

* **Select** — the normal mode. Click things to pick them up, move them, and change their settings. Press **Escape** any time to come back here.
* **Build** — opens the building tools: **Wall**, **Door**, **Window**, **Fence**, and **Trace from map**. This is how you draw the shell of your home. See [Drawing your home](/dashboards/adding-widgets/digital-building-twin/drawing-your-building.md).
* **Furnish** — opens the object library: five tabs (**Furniture**, **Appliance**, **Kitchen**, **Bathroom**, **Outdoor**) and a strip of 3D models to drop in. See [Placing objects](/dashboards/adding-widgets/digital-building-twin/placing-objects.md).
* **Sensors** — opens the Sensors panel, where you connect your devices and link their readings to things in the model. See [Connecting sensors and colors](/dashboards/adding-widgets/digital-building-twin/binding-sensors-and-colors.md).

Click a mode to switch into it; click it again to go back to Select.

## The Scene panel

The **Scene** panel is a list of everything in your model, shown as a tree — your building, each floor, and the walls, items, doors, and windows on it. Click anything in the list to select it in the view. Double-click it (or use the little pencil) to rename it. Renaming is worth doing: "Kitchen wall" or "Front door" is much easier to find later than "Wall 9."

## The settings panel

Click any object and a panel opens with that object's settings:

* **Furniture and objects** — Name, Position, Rotation (with handy **+45°** / **-45°** buttons), Scale, and size.
* **Walls** — Length, Height, Thickness, and a **Material** you can pick: white, brick, concrete, wood, glass, metal, plaster, tile, marble, or your own color.
* **Doors and windows** — Width, Height, where they sit along the wall, which side a door is hinged, which way it swings.

Whatever you've selected also gets a little badge floating above it with quick **Move**, **Duplicate**, and **Delete** buttons.

## Moving around the model

There are two ways to look at your model:

* **3D view** — spin around it freely. Drag with the left mouse button to rotate, the right button to slide the view across, and the scroll wheel to zoom in and out. Hold the **Space** bar to make left-drag slide instead of rotate.
* **2D view** — a straight-down, flat floor-plan view. You can't rotate it — just slide and zoom. It's the easier view for laying rooms out neatly.

Whatever angle and zoom you leave the editor at is what the dashboard tile shows, so set the view the way you want it before saving.

## The floor buttons

A little floating stack of floor buttons sits off to one side. It lists each floor (**L0**, **L1**, and so on), lets you add a floor above or below, and switches which floor you're working on. It also holds the **3D / 2D** switch and, if your home has more than one floor, a **Stack / Solo** switch. See [Floors and levels](/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md).

## Undo, redo, and removing things

* **Undo** — Ctrl+Z (Cmd+Z on a Mac).
* **Redo** — Ctrl+Shift+Z (Cmd+Shift+Z).
* **Remove something** — select it and press **Delete** or **Backspace**, or use the Delete button on the badge or settings panel. Your building and its floors are protected, so you can't delete those by accident.
* **Back out of a tool** — press **Escape** or right-click to drop whatever tool you're using and return to Select.

## Saving and closing

* **Save** — the button in the top-right corner. It asks for a **Widget name**; type or confirm it and your model is saved onto the dashboard.
* **Cancel** — closes the editor. If you have unsaved changes it checks first with a **Discard unsaved changes?** message — choose **Discard** to leave or **Keep editing** to stay.

## See also

* [Drawing your home](/dashboards/adding-widgets/digital-building-twin/drawing-your-building.md) — Walls, doors, and windows
* [Floors and levels](/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md) — Multiple floors and the 2D/3D switch
* [Placing objects](/dashboards/adding-widgets/digital-building-twin/placing-objects.md) — The object library


---

# 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/editor-tour.md?ask=<question>&goal=<endgoal>
```

`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.