> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tatara.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting around the app

> The sidebar, favourites, the user menu, the status line, the theme, and how the app works on a phone.

The app has three parts: the sidebar on the left, the page you have open, and the status line along the bottom. On an ordinary document, the [details rail](https://docs.tatara.app/app/documents.md#the-details-rail) sits to the right of the page.

## The sidebar

From top to bottom, the sidebar holds:

| Row | What it is |
| - | - |
| `Search or jump to` | Opens the search window. See [Finding documents](https://docs.tatara.app/app/search.md). |
| `Favourites` | Documents you have starred. It appears once you have one. |
| `Shared with me` | Folders that people in other accounts have shared with you. It appears only when there are some. See [Sharing a folder](https://docs.tatara.app/app/sharing.md). |
| `Documents` | Every folder and document in the workspace, with a count. See [Folders and organization](https://docs.tatara.app/app/organizing.md). |
| `Tags` | The tag registry. A count beside it means tags are waiting for review. See [Organizing with tags](https://docs.tatara.app/app/tags.md). |
| `Fields` | The extra properties your workspace has defined. See [Fields](https://docs.tatara.app/app/fields.md). |
| `Settings` | Account, workspace, and personal settings. `Back to app` at the top of Settings brings you back. |
| Your name and email | Opens the [user menu](#the-user-menu). |

Click the `Favourites` or `Documents` heading to fold that section away, and click it again to bring it back. When folders nest deep, the tree can show just one branch. See [Deep folders](https://docs.tatara.app/app/organizing.md#deep-folders).

### Collapsing and resizing

The button at the top right of the sidebar (`Collapse sidebar`) folds it down to a narrow strip of icons: `Expand sidebar`, search, `Documents`, `Tags`, `Fields`, `Settings`, and your avatar. Clicking the `Documents` icon brings the sidebar back with only that section open.

You can also press `[` when your cursor is not in a text field, or `⌘\` (`Ctrl+\` on Windows) anywhere, to collapse or expand it.

To change the sidebar's width, drag its right edge. A click on the edge without dragging collapses it.

The sidebar remembers its width, whether it is collapsed, and which sections are open, in this browser. In a mid-sized window, under about 1,150 pixels wide but wider than a phone, it always shows as the strip. Widen the window and your choice comes back.

## The home page

`Files` at the start of any breadcrumb takes you to the workspace's home page. It greets you by name, shows `Documents` and `Folders` counts, and lists recent documents under `Recent`.

## Favourites

Favourites are your own shortcuts. Nobody else in the account sees your list.

To add a document, click the star in its top bar, or open its menu in the `Documents` tree (the `⋯` button, or right-click) and choose `Add to favourites`. To take it off, click the star again or choose `Remove from favourites`.

The `Favourites` section lists your favourites in the order you added them. A favourite that is deleted drops off the list, and comes back if the document is restored.

## The user menu

Click your name at the bottom of the sidebar. The menu is headed with the account you are in and holds:

* `Settings`.
* `Workspaces`, when you belong to more than one account. The one you are in is dimmed with `Already here`. Choose another to open it.
* `New account…`, which opens setup for a new account.
* `Help & docs`, with links to `Docs` and the `Changelog`.
* `Sign out`.

See [Belonging to several accounts](https://docs.tatara.app/account/members.md#belonging-to-several-accounts).

## The status line

The status line runs along the bottom of the window.

On the left is the save state of whatever you are editing: `Saving`, `Saved` with the time, `Synced` when nothing is waiting, or `Failed`. Where a failed save can be sent again, a `Retry` button appears beside it. See [Autosave](https://docs.tatara.app/app/documents.md#autosave).

On the right:

| Shows | Means |
| - | - |
| `Hold motion` | Pauses everything in the app that moves by itself, such as spinners and the moving outline around an agent's write. Press it again to let things move. It resets when you reload. |
| `Docs` | How many documents the workspace holds. |
| `Agents` | How many agent apps you have connected to this account. They are listed under **Settings → Agent access**. |

### When an agent writes

When an agent saves a change to a document, the middle of the status line shows the agent's name, `Writing`, and the document's title. When the change sits under a heading, `§` and that heading follow. The document's row in the `Documents` tree gets a moving outline, and if you have the document open, its top bar reads `Writing` too. All of this stays for a few seconds after the agent's latest write.

Where it can, Tatara names the agent after the app it connected through. Otherwise it shows `Agent`.

Screen readers hear one short sentence for each write, such as "Claude wrote Pricing Page Spec, Tiers."

## Theme

Choose how the app looks under **Settings → Appearance**. The `Theme` setting has three choices: `Light`, `Dark`, and `System`, which follows your device. Light is the default. Tatara keeps your choice in this browser only, so on another device you set it again.

## On a phone

On a narrow screen the app rearranges itself:

* The sidebar moves behind a menu button (`Open navigation`) at the top left. It slides in from the left and closes when you open something.
* The bar along the top shows the save state.
* On a document, a button at the top right opens the details rail as a sheet titled `Details`.
* There is no status line. While an agent is writing, a strip appears along the bottom with `Writing`, the document's title, and a pause button that does the same as `Hold motion`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.