# Metrics report Open Graph Image Template

A dark report cover led by three headline statistics.

- Page: https://www.shadcn-ui-blocks.com/open-graph-images/metrics-report
- Category: [Business](https://www.shadcn-ui-blocks.com/open-graph-images/business), Reports
- Theme: dark, with light and dark renditions
- Preview PNG: https://www.shadcn-ui-blocks.com/open-graph-images/metrics-report/preview

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/og-image-metrics-report
```

The code is part of Pro and Team: the install needs an API key from either plan (https://www.shadcn-ui-blocks.com/docs/shadcn-cli).

Use the Metrics report template for quarterly reports, benchmark posts, and state of the industry write ups. Instead of illustrating the content, it leads with the content: three headline statistics sit across the bottom of the card, so the most shareable numbers in your report are the first thing a feed shows.

## How it works

This template is a metadata image route for the Next.js App Router. The file exports `size`, `contentType`, and `alt` values plus a default async function that returns an `ImageResponse`. When the report is shared, satori converts the JSX into an SVG document, the runtime rasterizes that SVG into a 1200 by 630 PNG, and Next.js serves the result and wires the `og:image` and `twitter:image` tags into the page head automatically. Because the card is code, the statistics can come from the same source of truth as the report body, so the share card never disagrees with the page.

## Install

Install with the shadcn CLI using your Shadcn UI Blocks API key:

```bash
npx shadcn@latest add @shadcn-ui-blocks/og-image-metrics-report
```

The file lands at `app/opengraph-image.tsx`, which makes it the site wide share card. For a report, move it into that segment instead, for example `app/reports/2026-q3/opengraph-image.tsx`. You can also copy the code from this page straight into your project.

The card renders text with Inter, read from `assets/fonts` at your project root with `node:fs` so the font files never ship to the browser. Download the latin woff files for weights 400, 500, 600, and 700 from [Fontsource](https://fontsource.org/fonts/inter) and save them as `assets/fonts/inter-latin-400-normal.woff` and so on.

## Customize

The `content` object holds the brand, the report chip, the title, the source line, and a `stats` array of value and label pairs. Three statistics is the sweet spot; the row divides its width evenly, so two works, and four gets tight. Keep values compact (a number plus a short unit) because they render at 56 pixels. The left border on each statistic is what separates the columns; recolor it a step lighter than the background when you change the palette.

satori supports a focused subset of CSS: flexbox layout only, flat colors, and an explicit `display: flex` on any element with multiple children. Keep those rules in mind if you rework the layout.
