@nexpress/plugin-sdk

Plugin SDK for NexPress — the Next.js-based CMS. Author plugins with definePlugin().

Install

pnpm add @nexpress/plugin-sdk

Plugin model (v1)

Plugins are npm-package + rebuild, not hot-loadable. A plugin can register hooks, actions, routes, and scheduled tasks at startup. It cannot add collections or fields at runtime — those require schema codegen + a DB migration. Plugins run in-process with full Node access; there is no sandbox in v1.

Quick example

import { definePlugin } from "@nexpress/plugin-sdk";

export default definePlugin({
  manifest: {
    id: "reading-time",
    name: "Reading Time",
    version: "0.1.0",
  },
  hooks: {
    "content:beforeSave": async ({ doc, ctx }) => {
      if (typeof doc.body === "string") {
        const words = doc.body.split(/\s+/).length;
        doc.readingMinutes = Math.max(1, Math.round(words / 220));
      }
      return doc;
    },
  },
});

Then in your nexpress.config.ts:

import readingTime from "@nexpress/plugin-reading-time";

export default defineConfig({
  // ...
  plugins: [readingTime()],
});

Restart the server — the hook fires on every content:beforeSave.

Available extension points

• hooks — content:beforeSave, content:afterSave, content:beforeDelete, content:afterDelete, member:*, media:*
• actions — custom API handlers at /api/plugins/<id>/actions/<name>
• routes — full route handlers at /api/plugins/<id>/<...path> (rate-limited at the framework level — see AGENTS.md)
• scheduled — cron-style tasks dispatched by pg-boss

Links

• Repository
• docs/plugin-admin.md
• docs/plugin-render.md
• Reference plugins — reading-time, seo-audit, forum, oauth-github, oauth-google

License

MIT