# @acid-info/docusaurus-og

> Docusaurus OpenGraph image plugin

Latest version **1.0.4-alpha.0** (published 2026-05-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install @acid-info/docusaurus-og
pnpm add @acid-info/docusaurus-og
yarn add @acid-info/docusaurus-og
bun add @acid-info/docusaurus-og
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; no vulnerabilities; high maintenance score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.0.4-alpha.0 |
| Published | 2026-05-08 |
| First published | 2023-06-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=20.0 |
| Dependencies | 11 |
| Unpacked size | 200 KB |
| Known vulnerabilities | 0 (+4 in 2 direct dependencies) |
| Install scripts | no |
| GitHub stars | 4 |
| Maintainers | mikeatacidinfo, jayacidinfo, pajicf, julesfiliot, jinho |

## Links

- npm: https://www.npmjs.com/package/@acid-info/docusaurus-og
- Repository: https://github.com/acid-info/logos-docusaurus-plugins
- Homepage: https://github.com/acid-info/logos-docusaurus-plugins#readme
- Issues: https://github.com/acid-info/logos-docusaurus-plugins/issues
- npm.io page: https://npm.io/package/@acid-info/docusaurus-og

## Dependencies (11)

- [sharp](https://npm.io/package/sharp.md) ^0.32.1
- [lodash](https://npm.io/package/lodash.md) ^4.17.21
- [satori](https://npm.io/package/satori.md) ^0.10.1
- [object-hash](https://npm.io/package/object-hash.md) ^3.0.0
- [@docusaurus/core](https://npm.io/package/@docusaurus/core.md) 3.8.1
- [node-html-parser](https://npm.io/package/node-html-parser.md) ^6.1.5
- [@docusaurus/types](https://npm.io/package/@docusaurus/types.md) 3.8.1
- [@docusaurus/utils](https://npm.io/package/@docusaurus/utils.md) 3.8.1
- [@docusaurus/utils-common](https://npm.io/package/@docusaurus/utils-common.md) 3.8.1
- [@docusaurus/utils-validation](https://npm.io/package/@docusaurus/utils-validation.md) 3.8.1
- [@docusaurus/module-type-aliases](https://npm.io/package/@docusaurus/module-type-aliases.md) 3.8.1

## Recent versions

- 1.0.4-alpha.0 (latest) — 2026-05-08
- 1.0.3-topic-chore-update-vac-assets.3 (topic-chore-update-vac-assets) — 2026-05-07
- 1.0.0-alpha.12 (canary) — 2025-04-17
- 1.0.3 — 2026-05-07
- 1.0.3-beta.2 — 2025-07-17
- 1.0.3-beta.1 — 2025-07-16
- 1.0.3-beta.0 — 2025-07-16
- 1.0.3-alpha.0 — 2025-05-27
- 1.0.2 — 2025-04-23
- 1.0.2-beta.1 — 2025-04-23
- 1.0.2-beta.0 — 2025-04-23
- 1.0.2-alpha.releasetest.0 — 2025-04-22
- 1.0.2-alpha.20250422T104919.0 — 2025-04-22
- 1.0.2-alpha.0 — 2025-04-22
- 1.0.1 — 2025-04-22
- … 25 more at https://npm.io/package/@acid-info/docusaurus-og/versions

## README

# Docusaurus OG

Docusaurus OG enables you to automate the generation of custom OpenGraph (OG) images for your Docusaurus website, enhancing the visual representation of your content when shared on social media and other platforms.

This plugin leverages [Vercel's Satori](https://github.com/vercel/satori) to convert your HTML and CSS into images. It lets you define image renderers tailored to each Docusaurus content plugin, allowing you to create unique OG images for your website's content.

## Installation

To get started, simply follow these steps:

1. Install the plugin:

```bash
yarn add @acid-info/docusaurus-og

# or

npm install @acid-info/docusaurus-og
```

2. Integrate the plugin into your `docusaurus.config.js`:

```js
plugins: [
  [
    '@acid-info/docusaurus-og',
    {
      path: './preview-images', // relative to the build directory
      imageRenderers: {},
    },
  ],
]
```

3. Define your image renderers for the content plugins of your choice. Here's an example:

```js
imageRenderers: {
  'docusaurus-plugin-content-docs': require('./lib/ImageRenderers').docs,
  'docusaurus-plugin-content-pages': require('./lib/ImageRenderers').pages,
  'docusaurus-plugin-content-blog': require('./lib/ImageRenderers').blog,
}
```

## Create an Image Renderer

An image renderer is a function that receives a `data` object representing page data and a `context` object representing the Docusaurus context. This function returns HTML or JSX content, which serves as input for Satori, the image generation tool. Satori processes this content to produce the corresponding OpenGraph image.

For example, here's an image renderer for the `@docusaurus/plugin-content-docs` plugin:

```tsx
// src/ImageRenderers.tsx
import type { DocsPageData, ImageRenderer } from '@acid-info/docusaurus-og'
import { readFileSync } from 'fs'
import { join } from 'path'
import React from 'react'

export const docs: ImageRenderer<DocsPageData> = (data, context) => [
  <div style={{ display: 'flex', background: 'black', color: 'white' }}>
    {data.metadata.title}
  </div>,
  {
    width: 1200,
    height: 630,
    fonts: [
      {
        name: 'Inter',
        data: readFileSync(
          join(__dirname, '../../static/Inter/Inter-Regular.ttf'),
        ),
        weight: 400,
        style: 'normal',
      },
    ],
  },
]
```

### JSX Support

If you wish to use JSX within your image renderer, you'll need to compile your code to JavaScript. Here's a TypeScript example:

1. Create a `tsconfig.client.json` file in your project root to compile your `src` directory:

```json
// tsconfig.client.json
{
  "compilerOptions": {
    "noEmit": false,
    "composite": true,
    "incremental": true,
    "esModuleInterop": true,
    "tsBuildInfoFile": "./lib/.tsbuildinfo-client",
    "rootDir": "src",
    "outDir": "lib",
    "module": "CommonJS",
    "target": "esnext",
    "jsx": "react",
    "types": ["node"],
    "baseUrl": "./",
    "lib": ["DOM"]
  },
  "include": ["src"]
}
```

2. Add `prestart` and `prebuild` scripts to your `package.json`:

```json
// package.json
{
  "scripts": {
    "prestart": "tsc --project tsconfig.client.json",
    "prebuild": "tsc --project tsconfig.client.json"
  }
}
```

3. Exclude the `lib` directory from your version control by adding it to your `.gitignore` file:

```bash
echo "lib" >> .gitignore
```

4. Import your image renderer from the `lib` directory:

```js
plugins: [
  [
    '@acid-info/docusaurus-og',
    {
      path: './preview-images', // relative to the build directory
      imageRenderers: {
        'docusaurus-plugin-content-docs': require('./lib/ImageRenderers').docs,
        'docusaurus-plugin-content-pages': require('./lib/ImageRenderers')
          .pages,
        'docusaurus-plugin-content-blog': require('./lib/ImageRenderers').blog,
      },
    },
  ],
]
```

---
_Source: https://npm.io/package/@acid-info/docusaurus-og · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
