# Application Report: Report Annotations Panel

An annotated trend chart with numbered markers pinned to dates beside a side rail listing each annotation with author, date, note, and an add control.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/report-annotations-panel
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Reports](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/report-annotations-panel.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-reports-report-annotations-panel
```

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/reports/report-annotations-panel`

## About this block

Report Annotations Panel pairs a weekly signups trend line
spanning Apr 20 to Jun 8, 2026 with a side rail of four
annotations. Numbered markers pin to the dates where
something happened: the Product Hunt launch on May 11, a
new pricing page on May 25, a homepage experiment on
Jun 1, and an onboarding email revamp on Jun 8. Each
marker is a dashed guide line down to the curve with a
numbered dot at the top, and the same numbers head the
list entries in the rail.

The chart is an inline SVG polyline with grid lines,
points, and marker groups drawn from one shared array, so
markers and list rows never drift out of sync. Every rail
entry carries an author avatar, date, and note, an add
affordance sits in the header, and the footer note that
annotations are visible to everyone with access keeps the
sharing model clear.

## When to use

Reach for this block beside any time series a team needs
to explain, wired to your metrics API and an annotations
store keyed by date. The add button should open a compose
form that drops a new marker at the selected point.

A natural flow around it on an Application Pro page:

**Before**

- [Report summary header](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports)
- [KPI cards row](https://www.shadcn-ui-blocks.com/blocks/application-pro/stat-cards)

**After**

- [Charts](https://www.shadcn-ui-blocks.com/blocks/application-pro/charts)
- [Data table](https://www.shadcn-ui-blocks.com/blocks/application-pro/data-tables)

## What you can display

One strong use is signups with launch and pricing
annotations. Other annotated series:

- **Incident timeline.** Markers for deploys and outages
  over an error rate line with on-call authors.
- **Experiment log.** Annotations at each test start and
  stop against the metric the test was meant to move.
- **Release notes.** Version tags pinned to an adoption
  curve so uptake maps to what shipped.

> Tip: shared numbering between the markers and the list
> is what lets a reader jump from a spike to its reason.

## More in Application Reports

- [Cohort Retention Grid](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/cohort-retention-grid)
- [Dashboard Grid Layout](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/dashboard-grid-layout)
- [Export Options Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/export-options-card)
- [Metric Detail Drilldown](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/metric-detail-drilldown)
- [Report Builder](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/report-builder)
- [Report Comparison View](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/report-comparison-view)
- [Report Filters Bar](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/report-filters-bar)
- [Report Run History](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/report-run-history)
- [Report Summary Header](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/report-summary-header)
- [Saved Reports List](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/saved-reports-list)
- [Scheduled Report Form](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/scheduled-report-form)
- [Scheduled Reports Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/reports/scheduled-reports-table)
