# Series Open Graph Image Template

A series card with a part chip, series name, and part title.

- Page: https://www.shadcn-ui-blocks.com/open-graph-images/guide-series
- Category: [Content](https://www.shadcn-ui-blocks.com/open-graph-images/content), Guides
- Theme: light, with light and dark renditions
- Preview PNG: https://www.shadcn-ui-blocks.com/open-graph-images/guide-series/preview

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/og-image-guide-series
```

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 Series template for a multi part guide where every installment shares one recognizable card. A part marker sits in a dark pill up top, the series name reads small above the installment title, and a progress bar shows how far along the reader is.

## 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 a page in the segment 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. The progress bar is eight flex segments filled by an index test, so it doubles as a chapter count.

## Install

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

```bash
npx shadcn@latest add @shadcn-ui-blocks/og-image-guide-series
```

The file lands at `app/opengraph-image.tsx`, which makes it the site wide share card. For a series you will usually move it into that segment instead, for example `app/guides/[slug]/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 `brand` for the logo row, the `part` pill, the `series` name, the installment `title`, the `description`, and the `url`. The progress bar is drawn with `Array.from({ length: 8 })` and fills any segment where the index is under 3, so edit that length for a longer or shorter series and that threshold to mark the current part; keep both in step with the `part` text. The `title` reads best up to two lines at 66px, and the `description` is happiest under 120 characters.

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.
