PDMLab · AlexZeitler · Jan 23, 2026 · Jan 23, 2026 · Jan 23, 2026
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
@@ -1,4 +1,5 @@
 import { defineConfig } from 'vitepress'
+import { buildEndGenerateOpenGraphImages } from '@nolebase/vitepress-plugin-og-image/vitepress'
 
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
@@ -52,5 +53,14 @@ export default defineConfig({
       { icon: 'github', link: 'https://github.com/pdmlab/docker-compose' },
       { icon: 'discord', link: 'https://discord.gg/pR6duvNHtV' }
     ]
+  },
+
+  async buildEnd(siteConfig) {
+    await buildEndGenerateOpenGraphImages({
+      baseUrl: 'https://pdmlab.github.io/docker-compose/',
+      category: {
+        fallbackWithFrontmatter: true
+      }
+    })(siteConfig)
   }
 })
diff --git a/docs/api.md b/docs/api.md
@@ -1,5 +1,6 @@
 ---
 outline: deep
+category: Reference
 ---
 
 # API Docs

diff --git a/docs/commands/build.md b/docs/commands/build.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # build
 
 Build or rebuild services.

diff --git a/docs/commands/config.md b/docs/commands/config.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # config
 
 Validate and view the Compose file configuration.

diff --git a/docs/commands/create.md b/docs/commands/create.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # create
 
 Create containers for services without starting them.

diff --git a/docs/commands/down.md b/docs/commands/down.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # down
 
 Stops containers and removes containers, networks, volumes, and images created by `up`.

diff --git a/docs/commands/exec.md b/docs/commands/exec.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # exec
 
 Execute a command in a running container.

diff --git a/docs/commands/images.md b/docs/commands/images.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # images
 
 List images used by the created containers.

diff --git a/docs/commands/kill.md b/docs/commands/kill.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # kill
 
 Force stop service containers.

diff --git a/docs/commands/logs.md b/docs/commands/logs.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # logs
 
 View output from containers.

diff --git a/docs/commands/pause.md b/docs/commands/pause.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # pause / unpause
 
 Pause and unpause services.

diff --git a/docs/commands/port.md b/docs/commands/port.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # port
 
 Print the public port for a port binding.

diff --git a/docs/commands/ps.md b/docs/commands/ps.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # ps
 
 Lists containers for a Compose project, with current status and exposed ports.

diff --git a/docs/commands/pull.md b/docs/commands/pull.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # pull
 
 Pull service images.

diff --git a/docs/commands/push.md b/docs/commands/push.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # push
 
 Push service images to their registries.

diff --git a/docs/commands/restart.md b/docs/commands/restart.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # restart
 
 Restart services.

diff --git a/docs/commands/rm.md b/docs/commands/rm.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # rm
 
 Remove stopped service containers.

diff --git a/docs/commands/run.md b/docs/commands/run.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # run
 
 Run a one-off command on a service.

diff --git a/docs/commands/stats.md b/docs/commands/stats.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # stats
 
 Display a live stream of container resource usage statistics.

diff --git a/docs/commands/stop.md b/docs/commands/stop.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # stop
 
 Stops running containers without removing them.

diff --git a/docs/commands/up.md b/docs/commands/up.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # up
 
 Builds, (re)creates, starts, and attaches to containers for services.

diff --git a/docs/commands/version.md b/docs/commands/version.md
@@ -1,3 +1,7 @@
+---
+category: Commands
+---
+
 # version
 
 Show the Docker Compose version information.

diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -1,3 +1,7 @@
+---
+category: Introduction
+---
+
 # Getting started
 
 `docker-compose` is a small library that allows you to run [docker-compose](https://docs.docker.com/compose/) (which is still required) using Node.js. This is useful to bootstrap test environments.

diff --git a/docs/package.json b/docs/package.json
@@ -8,6 +8,7 @@
     "preview": "vitepress preview"
   },
   "devDependencies": {
+    "@nolebase/vitepress-plugin-og-image": "^2.18.2",
     "vitepress": "^1.6.4"
   }
 }
diff --git a/docs/public/og-template.svg b/docs/public/og-template.svg