# Portfolio Design Portfolio: Annotated Screen

A single captioned product screen beside five numbered decision notes, each naming a screen region and the reasoning behind the call.

- Page: https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/annotated-screen
- Collection: [Portfolio](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro), Standard tier
- Group: [Design Portfolio](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/annotated-screen.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/portfolio-pro-design-portfolio-annotated-screen
```

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

- shadcn/ui components: placeholder
- Installs to: `@/components/blocks/portfolio-pro/design-portfolio/annotated-screen`

## About this block

Annotated Screen puts one shipped product screen on the
left as a large Placeholder with a dated caption, beside
five numbered decision notes on the right. Each note
names a screen region (Header balance figure, Table row
density, Sidebar section order) and explains a call that
is easy to miss, so the section shows the reasoning most
portfolios leave out.

Annotations are one typed array rendered as numbered
badges with a region title and body; the media column
takes 1.1fr so the screen leads without dominating. The
notes are specific on purpose: rows are 40 pixels
because finance users chose scanning speed over white
space, which reads as evidence rather than opinion.

## When to use

Reach for this block on a case study page when a single
screen carries a lot of thinking that deserves to be
spelled out. The installer swaps the screen Placeholder
and caption, then rewrites the five region notes to name
the decisions a reviewer would otherwise miss.

A natural flow around it on a Portfolio Pro page:

**Before**

- [Case study sections](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/case-study-sections)

**After**

- [Process sections](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/process-sections)
- [Contact sections](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/contact-sections)

## What you can display

One strong use is the annotated dashboard breakdown.
Other annotation layouts:

- **Onboarding flow.** Number the notes across a
  multi-step screen and explain one decision per step.
- **Component teardown.** Point the notes at states,
  spacing, and copy inside a single component.
- **Landing page critique.** Adapt the regions to hero,
  proof, and call to action for a marketing case.

> Tip: keep each note about a decision that cost a
> debate or a test; obvious observations dilute the
> section, so cut any note a visitor could have made
> themselves.

## More in Portfolio Design Portfolio

- [Before After Design](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/before-after-design)
- [Brand Showcase](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/brand-showcase)
- [Case Study Design](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/case-study-design)
- [Concept Grid](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/concept-grid)
- [Design Directions](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/design-directions)
- [Design Principles](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/design-principles)
- [Design Process](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/design-process)
- [Design System Display](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/design-system-display)
- [Featured Project](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/featured-project)
- [Iteration Timeline](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/iteration-timeline)
- [Logo Grid](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/logo-grid)
- [Project Index](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/project-index)
- [Research Decisions](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/research-decisions)
- [Responsive Pairs](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/responsive-pairs)
- [Screens Carousel Blueprint](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/screens-carousel-blueprint)
- [UI Wall](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/ui-wall)
- [Visual Grid](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/visual-grid)
- [Work Showcase](https://www.shadcn-ui-blocks.com/blocks/portfolio-pro/design-portfolio/work-showcase)
