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

# Decks

> Capture viewport snapshots into presentation-ready card collections.

# Decks

Decks are collections of **cards** — captured viewport snapshots that preserve exactly what you see in the viewer, including camera position, channel settings, adjustments, and annotations. Think of them as a scientific presentation builder built into your analysis workflow.

## What are decks for?

* **Lab meetings** — capture key findings as cards and present them directly from Relay
* **Figures** — build publication-ready figure collections with consistent styling
* **Documentation** — document your analysis workflow step by step
* **Collaboration** — share a deck with colleagues to show exactly what you found

## Creating a card

1. Set up your view — zoom in on a region, adjust channels, add annotations
2. Click **Add to Deck** in the toolbar
3. The current viewport state is captured as a card, including:
   * Camera position (pan, zoom, rotation)
   * Channel settings (visibility, colors, LUTs)
   * Image adjustments (brightness, contrast, gamma)
   * Z-slice and time point
   * Annotation visibility settings
   * A thumbnail preview

## Working with cards

| Action              | Description                                    |
| ------------------- | ---------------------------------------------- |
| **Edit title**      | Give each card a descriptive title             |
| **Add description** | Explain what the card shows                    |
| **Add notes**       | Include detailed notes for context             |
| **Reorder**         | Drag cards or use move up/down to rearrange    |
| **Duplicate**       | Create a copy of a card (includes annotations) |
| **Delete**          | Remove a card from the deck                    |
| **Edit in viewer**  | Reopen a card in the viewer to modify it       |

## Managing decks

You can create multiple decks to organize your work:

* **Create** — create a new empty deck with a title
* **Rename** — change a deck's title
* **Duplicate** — copy an entire deck including all cards and annotations
* **Delete** — remove a deck and all its cards
* **Reorder** — rearrange decks in the sidebar
* **Switch** — click a deck to make it the active deck

## Presentation mode

Enter **Presentation Mode** to display your cards full-screen:

* Cards display one at a time with their title and description
* Navigate between cards with arrow keys or buttons
* The viewer renders each card with its exact saved viewport state
* Present directly from your analysis environment — no export needed

## Themes

Decks support built-in themes to style your presentation:

| Theme          | Background      | Style                                |
| -------------- | --------------- | ------------------------------------ |
| **Dark**       | Black (#000)    | White text, blue accents, sans-serif |
| **Light**      | White (#fff)    | Dark text, blue accents, sans-serif  |
| **Scientific** | Slate (#1e293b) | Light text, cyan accents, monospace  |

## Card viewer sources

Cards can reference images from multiple sources:

* **Files** — local files loaded in the viewer
* **URLs** — remote images or Zarr datasets
* **Scientific images** — images from the scientific image store
* **Cloud assets** — files from Relay Drive (re-downloadable after refresh)

Each card stores enough information to reconstruct the exact view later, even after a page refresh.

## Annotation integration

Cards support annotation filters that control which annotations are visible:

| Mode         | Description                        |
| ------------ | ---------------------------------- |
| **All**      | Show all annotations               |
| **IDs**      | Show only specific annotation IDs  |
| **Snapshot** | Freeze annotations at capture time |
| **None**     | Hide all annotations               |

Each card can have its own dedicated annotation document for card-specific markup.