Merge pull request #96 from better-stack-ai/feat/media-plugin-client

feat: media plugin client

Author: olliethedev

AGENTS.md

@@ -748,6 +748,7 @@ Plugin UI pages are distributed as a shadcn v4 registry so consumers can eject a
 ### Key design rules
 
 - **Hooks are excluded** from the registry. Components import hooks from `@btst/stack/plugins/{name}/client/hooks`. Only the view layer is ejectable.
+- **Routable plugin pages should be wired back in via `pageComponents`** on the client plugin config when the plugin supports page overrides. If a plugin intentionally does not support `pageComponents`, document the direct-import rendering pattern clearly in the plugin docs and shared shadcn registry guide.
 - **`@workspace/ui` imports are rewritten**: standard shadcn components → `registryDependencies`; custom components (`page-wrapper`, `empty`, etc.) → embedded as `registry:component` files from `packages/ui/src/`; multi-file components (`auto-form`, `minimal-tiptap`, `ui-builder`) → external registry URL in `registryDependencies`.
 - **Directory structure is preserved**: source files land at `src/components/btst/{name}/client/{relative}` so all relative imports remain valid with no rewriting.
 - **`EXTERNAL_REGISTRY_COMPONENTS`** in `build-registry.ts` maps directory-based workspace/ui components to their external registry URLs.

CONTRIBUTING.md

@@ -792,6 +792,8 @@ npx shadcn@latest add "https://raw.githubusercontent.com/better-stack-ai/better-
 
 Files are installed into `src/components/btst/{plugin}/client/` with all relative imports preserved. Data-fetching hooks remain in `@btst/stack`.
 
+When a plugin exposes `pageComponents` on its client config, wire the ejected routable pages back in through that option. If a plugin intentionally does not support `pageComponents`, document the direct-import rendering pattern clearly in the plugin docs and the shared shadcn registry guide.
+
 ### Rebuild the registry locally
 
 ```bash

README.md

@@ -37,6 +37,7 @@ Enable the features you need and keep building your product.
 | **Form Builder** | Dynamic form builder with drag-and-drop editor, submissions, and validation |
 | **UI Builder** | Visual drag-and-drop page builder with component registry and public rendering |
 | **Kanban** | Project management with boards, columns, tasks, drag-and-drop, and priority levels |
+| **Media** | Media library with uploads, folders, picker UI, URL registration, and reusable image inputs |
 | **OpenAPI** | Auto-generated API documentation with interactive Scalar UI |
 | **Route Docs** | Auto-generated client route documentation with interactive navigation |
 | **Better Auth UI** | Beautiful shadcn/ui authentication components for better-auth |
@@ -121,8 +122,8 @@ Supports Prisma, Drizzle, MongoDB and Kysely SQL dialects.
 Each plugin's UI layer is available as a [shadcn registry](https://ui.shadcn.com/docs/registry) block. Use it to **eject and fully customize** the page components while keeping all data-fetching and API logic from `@btst/stack`:
 
 ```bash
-# Install a single plugin's UI
-npx shadcn@latest add https://github.com/better-stack-ai/better-stack/blob/main/packages/stack/registry/btst-blog.json
+# Install a single plugin's UI (for example, Media)
+npx shadcn@latest add https://github.com/better-stack-ai/better-stack/blob/main/packages/stack/registry/btst-media.json
 
 # Or install the full collection
 npx shadcn@latest add https://github.com/better-stack-ai/better-stack/blob/main/packages/stack/registry/registry.json

docs/assets/media-demo-1.png

@@ -18,6 +18,7 @@
       "plugins/ui-builder",
       "plugins/kanban",
       "plugins/comments",
+      "plugins/media",
       "plugins/open-api",
       "plugins/route-docs",
       "plugins/better-auth-ui",

docs/content/docs/meta.json

@@ -4,7 +4,7 @@ description: Available plugins and features for BTST
 ---
 
 import { Card, Cards } from "fumadocs-ui/components/card";
-import { BookOpen, Database, Hammer, Bot, Shield, FileText, FileCode, Route, Layout, Columns3 } from "lucide-react";
+import { BookOpen, Database, Hammer, Bot, Shield, FileText, FileCode, Route, Layout, Columns3, MessageSquare, ImageIcon } from "lucide-react";
 
 
 BTST provides a collection of full-stack plugins that you can easily integrate into your React application. Each plugin includes routes, APIs, database schemas, components, and hooks—everything you need to add complete features to your app. 
@@ -48,6 +48,18 @@ With more plugins coming soon, you can add complete features to your app in minu
     icon={<Columns3 size={20} />}
     description="Project management with boards, columns, tasks, drag-and-drop, and priority levels."
   />
+  <Card
+    title="Comments Plugin"
+    href="/plugins/comments"
+    icon={<MessageSquare size={20} />}
+    description="Threaded comments with moderation, likes, replies, and embeddable comment threads."
+  />
+  <Card
+    title="Media Plugin"
+    href="/plugins/media"
+    icon={<ImageIcon size={20} />}
+    description="Media library with uploads, folders, picker UI, URL registration, and reusable image inputs."
+  />
   <Card
     title="OpenAPI Plugin"
     href="/plugins/open-api"