<html> element tell the dashboard where those buttons are, and ask it for a slim top bar of its own.
In a browser tab none of this is set, and the dashboard looks as it always has.
Keep the window buttons off the sidebar
Set--clawboo-titlebar-inset to the height of the strip the window buttons sit in. The dashboard leaves that much room at the top, above the sidebar and the page, so the buttons never cover either. Unset, it is 0.
Set it on <html>, or on any element above the dashboard: the dashboard reads it with a fallback of 0 rather than defining it itself, so the value you set always wins.
Ask for the slim top bar
From 0.9.0, setdata-clawboo-embed-titlebar on <html> as well, and the strip becomes a slim bar in the dashboard’s own frame colour, the same as the team rail’s:
- Left, after the window buttons: the button that hides and shows the sidebar, then back and forward through the dashboard’s own pages. Back and forward are greyed out until there is somewhere to go.
- Middle: the team the page belongs to, with its icon, or the page’s name, such as Board.
- Right: Needs you, which opens the Board’s Needs you, and Help, which opens these docs in a new tab.
For example, on macOS with an inset title bar:
The sidebar button
The sidebar’s hide button moves out of the agent column into the bar, ahead of back and forward. It hides the sidebar, and once the sidebar is hidden it brings it back; hovering it then shows the sidebar under the bar without docking it.Cmd/Ctrl + \ still hides and shows the sidebar. A window narrower than a phone’s width works as in a browser: each page’s header opens the sidebar as a drawer, and the bar shows no sidebar button.
Moving the window
The bar is the window’s drag area (-webkit-app-region: drag), so pressing its empty space and dragging moves the window, and double-clicking it does whatever the window does on a double-click, such as zoom on macOS. Its buttons are not part of the drag area, so a click on one always reaches the button.
Back and forward
The dashboard keeps its own short history of the pages you moved between, up to 50 back, in the page’s memory: a reload starts it empty. Back skips a page that is gone, such as a deleted team’s chat or a deleted chat room. While the bar shows,Cmd + [ and Cmd + ] (Ctrl on Windows and Linux) go back and forward, except while you are typing.
Check that the server supports it
GET /api/system/capabilities reports ui.embedTitlebar: true from a server whose dashboard can draw the bar. An older server leaves the flag out. See Feature flags.
Related
- Tour the dashboard: the sidebar, its account bar and the page beside it.
- An app that starts Clawboo: naming the app’s own people on the requests it sends.