# Template Library block

> Wide template library dialog with category rail, live search, and selectable template cards

Template gallery picker dialog: fixed category rail (radio group), live search input, and selectable cards with thumbnail and badges. Uses ReUI Badge with Dialog, Input, ScrollArea, RadioGroup, Item. Starter library, template browser, asset picker.

- Type: Pro block
- Category: [Dialog](https://web.dev.reui.io/blocks/application/dialog.md)
- Page: https://web.dev.reui.io/blocks/application/dialog/dialog-5
- Docs (Base UI): https://ui.shadcn.com/docs/components/base/dialog.md
- Docs (Radix UI): https://ui.shadcn.com/docs/components/radix/dialog.md
- MCP: `get_block("dialog-5")`
- Built with: Badge, Button, Dialog, Empty, Input, Item, Label, Radio Group, Scroll Area, Separator
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

A wide 2 pane gallery: a use case rail beside searchable thumbnail cards, with a ready count and the pick in the footer

## Agent notes

- Open template and Build from blank have no `onClick`; act on `resolvedSelectedTemplate` in their handlers
- Replace `TEMPLATE_RECORDS` and `TEMPLATE_CATEGORIES` in data.tsx; every `imageUrl` is a picsum.photos placeholder
- `resolvedSelectedTemplate` falls back to the first visible card, so a filter that hides the pick changes it silently

## When not to use

- A side rail that switches between account settings panels: use [Account Settings Modal](https://web.dev.reui.io/blocks/application/dialog/dialog-10.md) (`get_block("dialog-10")`)
- Starter templates offered in place on a page with no projects yet: use [First Project](https://web.dev.reui.io/blocks/application/empty-state/empty-state-3.md) (`get_block("empty-state-3")`)

## Install

```bash
npx shadcn@latest add @reui/dialog-5
```

## About Dialog blocks

### When to use

- New record forms over the current page: a project, a quick task or entry, or a finance account
- Access flows: email invites with a role, an app picker and the consent step before a sync
- Pickers and account tasks: a time span, a starter template, settings, a checklist, cancellation or help

### When not to use

- A plain modal shell you fill with your own title, body and buttons: use [Dialog](https://web.dev.reui.io/components/dialog.md) (`get_component("dialog")`)
- A data entry layout that sits in the page itself rather than over it: use the [Form blocks](https://web.dev.reui.io/blocks/application/form.md)
- A one question confirm, such as deleting a record, with nothing to fill in: use [Alert Dialog](https://web.dev.reui.io/components/alert-dialog.md) (`get_component("alert-dialog")`)

### Agent notes

- Each root renders its own launch `Button` and starts `open` as true in `useState`; swap in your trigger and start it closed
- Primary actions only close through `setOpen`, fire a sonner `toast` or have no handler; wire your submit and API call there
- Each page.tsx centers the root in a `min-h-svh` main with an `sr-only` h1; mount only the root component inside your page

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.