Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt

Use this file to discover all available pages before exploring further.

The right panel is a tabbed dock on the right side of the chat. It hosts the diff view, the preview, the BRICKS Controller web interface, and device DevTools — each in its own tab — so you can keep one of them in view while you work with the agent.

Open the panel

Click the Right panel button in the top-right corner of the window. It stays pinned to that corner whether the panel is open or closed, so it is always in the same place. When you open the panel, it shows the first available tab. CTOR remembers whether the panel was open and reopens it in that state the next time you launch the app. The panel is only available when there is something to show — an open project, a Git repository, a selected app, or an open DevTools tab. With none of these, the toggle is inactive.

Tabs

The panel has three built-in tabs plus any number of device DevTools tabs:
TabShowsAvailable when
DiffUncommitted changes from git diffThe project is in a Git repository
PreviewThe compiled app in an embedded webviewA project is open
ControllerThe BRICKS Controller web interfaceAn app is selected, or in the main chat
DevToolsA device’s Chrome DevTools inspectorOpened from the Local Devices panel

Diff

The Diff tab shows your project’s uncommitted changes and carries a badge with the current added and deleted line counts (+ / ). See the diff view reference for view modes and per-file controls.

Preview

The Preview tab runs your compiled project as an embedded webview and exposes a Chrome DevTools Protocol (CDP) endpoint. Its toolbar includes a DevTools toggle that docks the preview’s own inspector. See the preview reference for the full pane controls.

Controller

The Controller tab embeds the BRICKS Controller web interface, scoped to the active app and workspace. It tracks your app’s stage, so a beta app opens against the beta Controller and a production app against the production one. Click Open controller in browser in the tab bar to open the same view in your default browser — useful for full-screen work or a dedicated window. This replaces the older standalone Controller window.

DevTools

Open a device’s Chrome DevTools inspector from the Local Devices panel — see Local devices. Each device opens as its own DevTools tab, titled with the device name and hosting the devtools:// inspector in a webview. DevTools tabs behave differently from the built-in tabs:
  • Deduplicated per device — reopening a device reuses its tab and refreshes the connection (for example, after entering a new passcode).
  • Persistent — they stay open across project and session switches, because they track physical devices rather than the current project.
  • Pop out — click Open DevTools in window in the tab bar to move the inspector into a standalone window. This closes the tab and restores the classic separate-window behavior.
When the device you inspect is the foreground project’s running preview, the DevTools button docks the inspector inside the Preview tab instead of opening a separate tab. See Dock the preview’s DevTools.

Manage tabs

  • Add a tab — click + (New tab) in the tab bar and pick a built-in tab that isn’t already open. Opening the Preview tab starts compiling the project; opening Diff loads the current changes.
  • Close a tab — click the × on the tab. Closing Diff or Preview also stops its backend; closing a DevTools tab disconnects that inspector.
  • Reorder tabs — drag a tab left or right to change its position. A drop indicator shows where it will land.
  • Switch tabs by keyboard — press Cmd+1 through Cmd+9 (Ctrl on Windows and Linux) to jump to the first through ninth open tab, matching the order in the bar.
When more tabs are open than fit, the tab row scrolls horizontally so every tab stays reachable. If the panel is narrow, the active tab’s toolbar collapses its buttons to icons to make room.

Resize the panel

Drag the handle on the panel’s left edge to resize it against the chat area. The panel can take up to 80% of the window width.