> ## 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.

# Slide decks

> Agent-built presentations that open full screen: moving between slides, thumbnails and the grid, speaker notes, presenting, and sharing a deck.

A slide deck is a presentation your agent builds, such as a pitch or a board update. It is one document with a section for each slide, and it opens on its own full-screen page where you page through it and present it.

Underneath, a deck is an [HTML document](https://docs.tatara.app/formats/html.md) laid out as slides on a fixed 16:9 canvas, and it runs in the same sandbox as any HTML page. Use a deck for something you will present or click through a slide at a time. Use an ordinary HTML page for a report or a one-pager that is read top to bottom.

## How one gets made

Ask your agent:

> "Turn the Q3 board update into a ten-slide deck, with speaker notes on each slide."

> "In the Q3 deck, split the revenue slide in two and move the pipeline slide to the end."

Only a connected agent can create or change a deck. The app has no new-deck option and no slide editor, so in the app you can present and share a deck but not change it.

Each time the agent saves a version, Tatara checks that the content of every slide fits on the slide, and tells the agent which slides do not, so it can fix them before you look.

If you have the deck open when it changes, the new version appears within a few seconds. While you are presenting, it waits until you stop.

## Opening a deck

Click the deck in the sidebar, or find it with search. It opens on its own page, without the sidebar, at an address with `/slides/` where other documents have `/files/`. The address also names the slide you are on, so a link copied from it opens on that slide for anyone in your account.

The head of the page holds:

* `Slide thumbnails`, the button on the left, which shows and hides the thumbnails.
* The deck's title.
* `Share`, which creates a public link. See [Sharing a deck](#sharing-a-deck).
* `Close`, the `X` on the right, which takes you back to the deck's folder.

The page does not remember how you set it up. Each visit opens in `One slide`, fitted to the window, with the notes closed.

Unlike an ordinary HTML page, a deck's page has no properties rail, no padlock, and no `Open raw in new tab` or `Expand`.

## Moving between slides

The slide carries a counter such as `3 / 12` in its bottom right corner, between a previous and a next arrow. Click the slide anywhere except a link or button on it to go to the next slide. On a touch screen, swipe left or right. Click a thumbnail to jump to that slide.

| Key | Does |
| - | - |
| `→` `↓` `Page Down` `Space` | Next slide |
| `←` `↑` `Page Up` | Previous slide |
| `Home` / `End` | First / last slide |
| `Enter` | In the grid, opens the selected slide |
| `Esc` | Stops presenting |

> [!NOTE]
>
> Once you click a slide, the keyboard goes to the slide itself, and there only `→`, `←`, `Page Up`, `Page Down` and `Space` work. The same goes for presenting full screen.

## Views

`View` sits at the top of the thumbnails, or over the top left of the slide when the thumbnails are hidden. Its menu has:

| Option | Shows |
| - | - |
| `One slide` | The selected slide, large. This is where a deck opens. |
| `Grid` | Every slide as a numbered tile. Click one to open it in `One slide`. |
| `Slide thumbnails` | A column of numbered thumbnails beside the slide. |
| `Speaker notes` | The selected slide's notes, in a panel under it. |

The thumbnails start open on a wide window and hidden on a narrow one. Turning them on from the grid takes you back to `One slide`.

Speaker notes show as plain text, or `No notes on this slide.` when a slide has none. You only see them in `One slide`. They do not show in the grid, while presenting, or on a public link.

### Zoom

In `One slide`, the button at the top right shows the zoom, such as `64%`. Its menu has `Zoom in`, `Zoom out`, `Fit slide`, and fixed steps from 25% to 200%. A slide zoomed past the window's edge scrolls.

## Presenting

`Present` is the play button at the top right. It shows the selected slide full screen and nothing else. Move through the deck with the keys, the arrows on the slide, a click, or a swipe. Press `Esc` to stop and go back to the page.

You can present from the grid too. It starts at the selected slide.

## On a phone

The thumbnails start hidden, and the slide fills the width of the screen. Swipe the slide to move between slides.

Where the browser cannot put a page full screen, as on an iPhone, `Present` fills the browser window instead, with a `Close` button at the top right.

## Sharing a deck

`Share` works the way it does for any HTML page: there is one public link per deck, anyone holding it can view without signing in, and removing it turns it off for good. See [Sharing a page](https://docs.tatara.app/formats/html.md#sharing-a-page).

On the shared link, the slide fits the viewer's window. They move through it with the arrows and counter in its bottom right corner, a click, or a swipe. The **Shared via Tatara** badge sits in the bottom left corner, out of their way. Viewers get no thumbnails, grid or speaker notes.

> [!WARNING]
>
> Speaker notes are hidden on a public link, but they are still part of the page. Anyone with the link can read them with their browser's developer tools. Keep anything the audience should not see out of the notes of a deck you share.

In a folder [shared with someone outside your account](https://docs.tatara.app/app/sharing.md), a deck shows `Can't show this here`. Shared folders do not show decks yet.

## In your workspace

A deck lives in a folder like any document, and the sidebar shows it with the same icon as one. Search finds it by name.

* **Rename, move, delete, favourite.** Use the `⋯` menu on the deck's row in the sidebar, or right-click the row. See [Folders and organization](https://docs.tatara.app/app/organizing.md) and [Deleting documents and folders](https://docs.tatara.app/app/deleting.md).
* **Description and tags.** Your agent sets them when it creates the deck. The deck's page has nowhere to change them, so ask your agent.
* **Locking.** A deck's page has no padlock, so you cannot lock a deck from the app.
* **Export and print.** The app has no export, download, or print option for a deck.

## If it looks wrong

| You see | What it means |
| - | - |
| `This deck has no slides yet.` | The deck exists but holds no slides. Ask your agent to add them. |
| `This document is no longer a slide deck.` | Your agent rewrote it as an ordinary HTML page while you had it open. Choose `Open it` to view it as one. |
| `Deck not found` | Nothing lives at this address, or the deck was deleted. `Go to files` takes you back. |
| `Couldn't load the HTML.` | The deck failed to load. Choose `Retry`. |

If a slide looks broken or its content runs off the edge, ask your agent to fix it. It already has the report Tatara made when it saved the deck. See [Troubleshooting](https://docs.tatara.app/troubleshooting.md).


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