From 1fbafd6cc7b63fe6810cd8c4a42cb3232139751c Mon Sep 17 00:00:00 2001
From: Mario Zechner <badlogicgames@gmail.com>
Date: Mon, 2 Feb 2026 20:16:18 +0100
Subject: [PATCH] docs: document video and image fields for package gallery

---
 packages/coding-agent/docs/packages.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/packages/coding-agent/docs/packages.md b/packages/coding-agent/docs/packages.md
index 37936ccd..4928c831 100644
--- a/packages/coding-agent/docs/packages.md
+++ b/packages/coding-agent/docs/packages.md
@@ -93,6 +93,27 @@ Add a `pi` manifest to `package.json` or use conventional directories. Include t
 
 Paths are relative to the package root. Arrays support glob patterns and `!exclusions`.
 
+### Gallery Metadata
+
+The [package gallery](https://shittycodingagent.ai/packages) displays packages tagged with `pi-package`. Add `video` or `image` fields to show a preview:
+
+```json
+{
+  "name": "my-package",
+  "keywords": ["pi-package"],
+  "pi": {
+    "extensions": ["./extensions"],
+    "video": "https://example.com/demo.mp4",
+    "image": "https://example.com/screenshot.png"
+  }
+}
+```
+
+- **video**: MP4 only. On desktop, autoplays on hover. Clicking opens a fullscreen player.
+- **image**: PNG, JPEG, GIF, or WebP. Displayed as a static preview.
+
+If both are set, video takes precedence.
+
 ## Package Structure
 
 ### Convention Directories