Skip to content

Sidebar & component pages ​

The sidebar provides folder shortcuts, bookmarks, tags and layouts. You can switch pages, stack sidebar panes or move a page to the main area.

Component pages and sidebar panes ​

Each sidebar pane has a tab strip and displays one of its pages at a time. To see two pages together, place them in vertically stacked panes. Sidebar panes and main-area split panes are arranged separately.

Component pageContents
LayoutsSaved workspaces; see Layouts & workspaces
RecentsFolders ranked by visit frequency and time; see Interface tour
BookmarksSaved folders and bookmark folders; see Bookmarks
TagsColored tags and their file counts; see Tags
StorageDrives, network drives and portable devices; see Storage locations
PlacesHome, common system folders and added network locations; see Network shares
Open TabsTabs open in every pane of this window

All seven pages are visible by default, each in its own pane. Layouts, Storage and Places start expanded; the other panes start collapsed. Existing windows keep their saved arrangement. Open Settings → Layout → Sidebar to control each page's visibility. Hiding a page does not delete its bookmarks, tags or layouts; its contents return when you enable it again.

Switch component pages ​

  1. If the sidebar is hidden, click the sidebar button at the top-left of the window to open it.
  2. Click an icon or name in a pane's tab strip to switch to that page.
  3. Scroll to the position you need within the page.
The tessoa sidebar with each component page in its own pane; Tags is expanded to show Important, Projects and child tagsThe tessoa sidebar with each component page in its own pane; Tags is expanded to show Important, Projects and child tags
Click Tags in its collapsed pane to expand it. The other component pages remain in their own panes.

Each page remembers its vertical and horizontal scroll positions during the current run. Switch to another page and back to return to the same position. When the tab strip cannot fit all icons, scroll over the strip to reach the others; the current tab is automatically brought into view.

The button at the right end of the strip follows its current page. Bookmarks, Tags, Layouts and Places offer + for their creation actions; Recents offers × to clear its records when it is not empty. These buttons are visible without hovering.

The Search files… box sits above all sidebar panes. It uses the sidebar search scope, regardless of the current component page. While results are displayed, the sidebar temporarily shows a single result list; clearing the search restores its panes.

Stack panes and reorder tabs ​

  1. Hold the component tab you want to move, such as Bookmarks.
  2. Drag it to the upper or lower edge of a target pane's content area.
  3. Wait for the split target to highlight, then release to create a pane.
In this example, Layouts and Tags have been combined in one pane. Drag Tags into a lower pane, adjust the divider, then collapse and expand the upper pane.

There is no fixed three-pane limit. A split target is offered only when the target pane has enough height for both resulting panes. In a short window, first resize a divider to give the target more height, or merge tabs into one pane.

Drop targetResult
Between tabs in a tab stripReorder pages at the insertion point, or move one from another pane
The middle of another pane's content areaJoin that pane
The upper or lower content edge, with enough heightCreate a pane above or below the target

Moving a pane's last component tab elsewhere removes the empty pane.

Adjust width and height ​

ActionResult
Drag the sidebar's right edgeResize the sidebar, up to half the window width
Drag the divider between stacked panesResize the adjacent panes; other panes keep their heights
Hover a divider and click its fit buttonFit the pane with less content to its content height and give the remaining space to the other pane, subject to the minimum pane height
Click the same button againRestore the proportions from before fitting; manually resizing the divider or changing the pane structure clears this restore point

The fit button adjusts the heights once. After the content or window size changes, adjust again as needed. Both adjacent panes must be expanded to drag their divider or use its fit button.

Collapse sidebar panes ​

Click the triangle at the far left of a pane's tab strip to collapse or expand the pane. Collapsing leaves its tab strip visible and gives the content space to other expanded panes. All panes can be collapsed.

Clicking any component tab in a collapsed pane expands that pane and selects the page. Clicking the current tab in an expanded pane does not collapse it; use the left-hand triangle.

The triangle before a folder row controls that folder's subtree separately. See The folder tree in the sidebar.

Open Tabs ​

  1. Click the sidebar's Open Tabs tab to expand the page.
  2. Click a row to focus its tab in the corresponding pane.

If you previously hid this page, first enable Open Tabs in Settings → Layout → Sidebar.

Open Tabs expanded in its own tessoa sidebar pane, listing tabs by main-area pane with the Documents row selectedOpen Tabs expanded in its own tessoa sidebar pane, listing tabs by main-area pane with the Documents row selected
Open Tabs lists tabs by main-area pane within its own sidebar pane. Click Documents to focus its tab in the right-hand pane.

This page lists tabs in the current window only. After splitting the main area, each pane has a group whose number matches its tab group badge. Pane group rows are labels only. The list updates as tabs open or close.

Place a component page in the main area ​

  1. Hold a component tab in the sidebar.
  2. Drag it over a main-area tab strip or pane and wait for the drop target to highlight.
  3. Release to create a component tab alongside the file tabs in that pane.
In this example, Layouts and Tags share a sidebar pane. Drag Tags into the main area to make it a tab, then drag it back to the sidebar.

The page keeps its contents and actions in the main area. Bookmarks still opens saved folders, and Tags still manages colored tags. While the page is in the main area, its tab is absent from the sidebar strip.

ActionResult
Drag the component tab back to a sidebar tab stripInsert it at the drop position in that pane
Close the component tab or its containing paneReturn the page to the sidebar
Open a folder from a main-area component pageOpen it in another available file pane; without another available file pane, create a file tab in the current pane

Ordinary file, terminal and preview tabs cannot currently be dragged into the sidebar. Sidebar component pages also cannot move to another window or become a separate window.

Use Vim keyboard controls ​

With Vim mode enabled, press e to focus the sidebar. These are the default bindings. A “section header” means keyboard focus is on the current component page's title in its tab strip.

ActionDefault key
Focus the current page header in the previous / next pane[ / ]
On a header, switch to the previous / next page in this paneh / l
On a header, collapse / expand this paneSpace
On a folder row, collapse / expand its treeh / l
Enter sidebar search/

Switching pages with the keyboard leaves a collapsed pane collapsed; press Space to expand it. Switching panes or pages stops at either end without wrapping.

Saved state and version compatibility ​

Sidebar width, page order, stacked panes, the current page in each pane and collapsed state are saved with the window session. Reopening the app restores each window's sidebar. Page scroll positions last only for the current run.

Named layouts save main-area panes and their tabs, including sidebar component pages placed there. The sidebar's own arrangement belongs to the window; switching named layouts does not switch to another sidebar arrangement.

When upgrading from 0.23.x, the sections in existing windows become one pane per section, retaining their collapsed state. Use the steps above to merge them into the page groups you need.

Warning

Saving configuration after downgrading to 0.23.x discards the sidebar panes and new component settings that the older version does not recognize. Upgrading again may require rearranging the sidebar. Back up the current configuration first using the configuration backup instructions in the FAQ if you need to preserve it.

User docs for tessoa