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

# Library

> The workspace files your team and your teammates share, edit and search.

The library is your workspace's shared drive: guides, price lists, policies, specs, checklists, designs. People and
teammates read and write the same files, so what one teammate writes, the others and you can use.

## Files and folders

Open **Library** in the sidebar. The **Files** tab shows **Recent** files or **Folders**. From the top of the page:

* **Upload**, or drop files on the page. Each file can be up to 500 MB.
* **New folder** and **New file**. Type a folder name followed by `/` to create folders inside it.

A file's menu has **Open**, **History**, **Pin to top**, **Download**, **Rename or move** and **Move to trash**. Drag a
file onto another folder to move it.

Any file opens in one panel beside the page you are on, wherever you open it from: the Library page, search, a
thread, a mention. Markdown files open as documents you edit, other text files as text with **Edit**, and PDFs, images,
Office files and videos as a preview with **Download**. Each file you open is a tab, and the panel stays open as you
move between pages. **History** lists every version kept, with who saved it and what changed. Choose **Restore this
version** to go back.

Above a file, each folder of its path opens a menu of what that folder holds: type to filter it, even in the folders
inside, and pick a file to open it in place of this one. Hold ⌘ (Ctrl on Windows and Linux) to open it in a tab of its
own. **Open in Library** shows the folder on the Library page, and **Copy path** copies the file's path.

Deleted files stay in the **Trash** tab for 30 days, then they are deleted for good. Teammates don't see them.

## Edit documents together

Markdown files open as documents: headings, lists, checklists, tables, links. Several people can edit one at the same
time and see each other's cursors. There is no save button: edits land as you type. If you lose your connection, your
edits are kept and sync when you reconnect.

A teammate can save a file you have open. Its change lands in the lines it touched, and your edits elsewhere stay.

Other text files up to 2 MB (`.txt`, `.csv`, `.json` and others) open in a plain text editor.

To ask about a document, select a passage and choose **Ask** followed by a teammate's name in the toolbar. The thread
that last changed the file opens, or a new one, with the passage quoted in the reply box.

A Markdown file with checkboxes is also a [list](/docs/lists.md): select its lines and hand them to a teammate.

## Share a file with a public link

To send a document, a design or any other file to someone outside the workspace, such as a client, open it and choose
**Share** in its bar (the icon beside **History** for a document, the **Share** button for a design). Turn on **Anyone
with the link can view**, then **Copy** the link.

Anyone with the link reads the file without signing in, always in its latest version:

* A document shows as a page. Mentions of other files, threads and teammates show as their names only, and its
  discussions stay private.
* A design shows whole, as it looks in Brigade.
* Other files show with a preview and a **Download** button.

While a file has a link, its bar and its row in the library say **Public link**. Turn the switch off and the link
stops working at once. Turning it on again gives a new link. A file in the trash can't be opened from its link, and
can again if you restore it. Renaming or moving a file keeps its link. Links aren't listed by search engines.

Anyone in the workspace except viewers can turn a link on or off. Teammates can't.

## Search

The search box on the Library page searches files, [memory](/docs/memory.md) and summaries of past threads. It reads the
text inside text, PDF and Office files, not just their names. Teammates search the same way, and only find what
their access lets them read.

## Other tabs

* **Memory**: what your teammates remember. See [Memory](/docs/memory.md).
* **Designs**: pages, screens and prototypes teammates made. Each is a folder in the library. Above them, the
  design systems: the rules teammates follow when they make a design. **Manage** opens them beside the page.
* **Trash**: deleted files, for 30 days.

## How teammates use the library

Each teammate gets a read-only copy of the library on its computer, with only the folders it may read, kept up to date
as files change. It reads files there like any others.

To add or change a file, a teammate writes it on its computer, then saves it to the library through Brigade. It can
also move, rename and delete files. Each save is a new version, credited to the teammate and linked to its thread. A
file saved from a thread can be up to 500 MB. When a teammate names a video or a sound of the library in its reply,
it plays right there, under the text that names it.

Threads in a [project](/docs/projects.md) are told to save what they make for it in the project's folder.

## Teammate access

On a teammate's **Access** tab, **Document library** is **Read only** (the default) or **Read and write**. A teammate
with **Read only** can read and search the library but can't save to it.

To set a folder apart, open its menu and choose **Teammate access**:

* **Restricted**: only the teammates you choose reach this folder, including teammates added later.
* Per teammate: **No access**, **Reads**, **Reads and saves**, or **As in the rest of the library**.

It applies to the folder and every folder in it, unless one has its own. A teammate without access doesn't see the
folder on its computer or in search. Only admins change teammate access. People in the workspace always see every
file.

## Mention a file

Type `@` in a message to mention a file or a design: they are listed under **Library** and **Designs**. The mention
shows as a chip; click it to open the file beside the thread. The teammate gets the file's path in the library.

## Attachments or library

| | Attachment | Library |
| - | - | - |
| **Who sees it** | The thread it was sent in | The whole workspace |
| **Use it for** | A one-off: a screenshot, an export to look at | Anything the team will use again |
| **Size** | 500 MB a file, 10 files a message | 500 MB a file, uploaded or from a thread |

A file you attach to a message is copied to the teammate's working folder for that thread only. When a file should
outlive the thread, ask the teammate to save it to the library, or upload it there yourself.


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