# Application Comments and Annotation: Annotation Toolbar Blueprint

Static open-state blueprint of a text-selection toolbar with comment, highlight, suggest-edit, and link affordances plus a five-color swatch row.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/annotation-toolbar-blueprint
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Comments and Annotations](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations)
- Created: 2026-06-15
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/annotation-toolbar-blueprint.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-comments-annotations-annotation-toolbar-blueprint
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, lucide-react, radix-ui
- shadcn/ui components: avatars, button
- Installs to: `@/components/blocks/application-pro/comments-annotations/annotation-toolbar-blueprint`

## About this block

Annotation Toolbar Blueprint is a static open-state
rendering of the floating text-selection toolbar: the
bar sits above a highlighted passage in a document
surface ("Acme processes payment data in an isolated
sub-processor environment"), with four icon buttons
(Comment, Highlight, Suggest edit, Insert link) and
five color swatches using chart tokens (chart-1 yellow
through chart-5 red). The Highlight button is pressed.
Below the document, a live comment thread between
Priya Nair and Avery Stone with a reply affordance
shows what the Comment action opens.

Actions and colors are typed arrays. Highlight colors
use bg-chart-N/40 tokens so they adapt to light and
dark mode without hardcoded color overrides; no Radix
portal components are used anywhere.

## When to use

Reach for this block to show the annotation UX to
stakeholders or to document the toolbar shape before
wiring up selection events. Connect it to a real
selection listener and popover anchor once the static
design is signed off.

A natural flow around it on an Application Pro page:

**Before**

- [App shell](https://www.shadcn-ui-blocks.com/blocks/application-pro/app-shells)
- [File manager](https://www.shadcn-ui-blocks.com/blocks/application-pro/file-manager)

**After**

- [Comments feed](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations)
- [Activity log](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity)

## What you can display

One strong use is the document review annotation bar.
Other toolbar blueprints:

- **Image annotation bar.** Comment and draw tools
  floating above a Placeholder image surface.
- **Code review toolbar.** Line-level comment and
  suggestion affordances in a code block.
- **Spreadsheet cell toolbar.** Format and comment
  actions anchored to a selected cell range.

> Tip: render the toolbar as a static blueprint first
> so the layout lands in screenshots and reviews before
> the selection-event wiring begins.

## More in Application Comments and Annotations

- [Annotation Layers Rail](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/annotation-layers-rail)
- [Canvas Pin Comments](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/canvas-pin-comments)
- [Code Review Thread](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/code-review-thread)
- [Comment Assignments](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/comment-assignments)
- [Comment Composer](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/comment-composer)
- [Comment Notification Inbox](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/comment-notification-inbox)
- [Comment Sidebar](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/comment-sidebar)
- [Inline Annotation Thread](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/inline-annotation-thread)
- [Mention Picker Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/mention-picker-blueprint)
- [Outdated Comments Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/outdated-comments-panel)
- [Pending Review Tray](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/pending-review-tray)
- [Reaction Bar](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/reaction-bar)
- [Resolved Comments List](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/resolved-comments-list)
- [Spreadsheet Cell Comments](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/spreadsheet-cell-comments)
- [Suggestion Review Row](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/suggestion-review-row)
- [Video Timestamp Comments](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/video-timestamp-comments)
