# Mention

> Headless React mention suggestions for native textareas and editor integrations. Requires React 19 and Mention 0.2.1. Install @danielivanov/mention@^0.2.1 from npm; styling is optional.

Mention owns trigger detection, suggestion search, keyboard selection, and caret positioning. Textareas store plain text. Rich editors own their documents, mention nodes, transactions, clipboard behavior, and history.

## Start here

Read the coding-agent guide, follow the typed quickstart, then consult the API reference or a focused recipe. All documentation links below return Markdown from the same sources as the browser pages.

- [Coding-agent guide](https://reactmention.com/llms.mdx/docs/agents/content.md): Integrate Mention with a typed example, clear ownership, and checks you can verify.
- [Quickstart](https://reactmention.com/llms.mdx/docs/content.md): Add typed mention suggestions to a React textarea.
- [API reference](https://reactmention.com/llms.mdx/docs/api-reference/content.md): Components, hooks, and editor transactions.

## Guides and recipes

- [Accessibility](https://reactmention.com/llms.mdx/docs/accessibility/content.md): Interaction behavior, automated checks, and manual verification limits.
- [AI composer](https://reactmention.com/llms.mdx/docs/ai-composer/content.md): Add document references to a shadcn/ui composer with AI SDK 7 and Lexical.
- [Lexical](https://reactmention.com/llms.mdx/docs/lexical/content.md): Keep mention tokens, formatting, clipboard data, and history in Lexical.
- [Rich-text editors](https://reactmention.com/llms.mdx/docs/rich-text/content.md): Keep documents, chips, and undo inside the editor.
- [Troubleshooting](https://reactmention.com/llms.mdx/docs/troubleshooting/content.md): Diagnose detection, editor registration, positioning, and async behavior.
- [Caret positioning](https://reactmention.com/llms.mdx/docs/internals/caret-anchoring/content.md): From a textarea mirror or an editor measurement to the suggestion list's position.
- [Editor ownership](https://reactmention.com/llms.mdx/docs/internals/content.md): How a snapshot, a suggestion session, and a host transaction fit together.
- [Focus and ARIA](https://reactmention.com/llms.mdx/docs/internals/interaction/content.md): Native textbox semantics, suggestion relationships, focus, and keyboard handling.
- [Request lifecycle](https://reactmention.com/llms.mdx/docs/internals/request-lifecycle/content.md): Why a late response cannot become a suggestion for a newer editing session.
- [Async search](https://reactmention.com/llms.mdx/docs/recipes/async-items/content.md): Fetch suggestions with debouncing, cancellation, loading, empty, failure, and same-query retry.
- [Controlled forms](https://reactmention.com/llms.mdx/docs/recipes/controlled-value/content.md): Validate, submit, and reset a real form while Mention preserves ordinary textarea behavior.
- [Custom rendering](https://reactmention.com/llms.mdx/docs/recipes/custom-rendering/content.md): Customize option content or use the hook for application-owned layout and positioning.
- [International input](https://reactmention.com/llms.mdx/docs/recipes/i18n/content.md): Unicode trigger boundaries, right-to-left text, composition, and locale-aware search.
- [Multiple triggers](https://reactmention.com/llms.mdx/docs/recipes/multi-trigger/content.md): Give each trigger its own items and insertion format.
- [Styling](https://reactmention.com/llms.mdx/docs/recipes/styling/content.md): Optional CSS, custom component props, and theme variables.

## Optional

- [Complete documentation](https://reactmention.com/llms-full.txt): All guides in one plain-text response.