CannedRepliesManager
The library behind a reply composer's slash menu, with search, add, edit, duplicate and delete, variable buttons, a live preview and validation of duplicate shortcuts.
Code
<CannedRepliesManager replies={replies} onSave={async (reply) => save(reply)} onDelete={async (reply) => remove(reply.id)}/>Chat · beta
Live examples and controls: CannedRepliesManager in the lab.
Install
npx shadcn@latest add https://docs.nasaqui.com/r/canned-replies.jsonSaved answers people type again and again. Each has a shortcut typed after a slash in any composer, a title and a
body with {{variables}}. A CannedReply is structurally an Inbox CannedSnippet, so the same list feeds
CannedPicker.
When to use
- Settings screen for a team's reply library.
When not to use
- Email layouts: use
EmailTemplates.
Import
import { CannedRepliesManager } from "@fadymondy/nasaq/web";
// inside this monorepo: "@nasaq/web"Quick start
<CannedRepliesManager
replies={replies}
onSave={async (reply) => save(reply)}
onDelete={async (reply) => remove(reply.id)}
/>Anatomy
EntityList with shortcut, title, reply, uses and updated columns. A "New reply" button, row actions in a context
menu (edit, duplicate, delete), an editor dialog with variable buttons and preview, and a delete confirmation.
API
| Prop | Type | Description |
|---|---|---|
replies | CannedReply[] | { id, shortcut, title, body, uses?, updatedAt? }. |
variables | CannedReplyVariable[] | { key, label, sample }. Default name, agent, company. |
onSave | (reply) => Promise<void or { error? }> | Create or update. New replies have an id starting with new-. Omit for read only. |
onDelete | (reply) => Promise<...> | Omit to hide delete. |
labels | CannedRepliesLabelOverrides | Override any string. |
It also accepts the EntityList props that make sense (loading, error, empty, view, and so on).
Pure helpers: normalizeCannedShortcut, validateCannedReply, cannedReplyVariables, nextFreeCannedShortcut.
Examples
Feed the same array to CannedPicker in a composer: <CannedPicker snippets={replies} onPick={insert} />.
Accessibility
Fields have visible labels, errors use role="alert", the preview is a live region, rows open actions from a context-click or the row menu.
RTL & i18n
English and Arabic ship. Shortcuts are left-to-right, reply text uses dir="auto".
Styling & tokens
Semantic tokens only.
Do / Don't
- Do keep shortcuts short and unique.
- Don't put private data in a reply everyone can insert.
Related
Lab
https://docs.nasaqui.com/?path=/docs/components-chat-canned-replies--docs
MapView
A map of pins and routes without a map library, with layer toggles, a legend, zoom and pan by drag, wheel, buttons or keyboard, a location card and pin clustering; tiles come from a URL template you provide, and without one it draws a coordinate grid.
ChatThread
Chat UI kit. A bottom-sticking message thread, messages with avatar, time, status and streaming, and an autosizing composer.