Plugin hooks internals

configureServer vs build staticFiles preload Bun.plugin ordering versus manic build stages.

Plugin hooks internals

Plugins implement ManicPlugin (packages/manic/src/config/index.ts) — optional preload, bunfig, configureServer, build.

Hook timeline

Initializing diagram...
HookRuns whenTypical use
preloadBefore Bun.build graphs · --preload in devRegister BunPlugin (Tailwind, MDX, …)
bunfigmanic dev startupMerge serve.static plugins
configureServercreateManicServer startupaddRoute, injectHtml, addLinkHeader
buildAfter client bundle + baseline HTMLemitClientFile, injectHtml

createPlugin shorthand

staticFiles expands into configureServer addRoute + build emitClientFile — the canonical dev/prod parity pattern (Plugins).

Sharp edges

  • plugin.build receives apiRoutes: [] — APIs bundle after plugin hooks (Caveats).
  • configureServer routes do not exist in production unless mirrored via emitClientFile or providers.

See also

Client router runtime

RouteRegistry matcher scoring window globals navigation View Transitions gate.

Providers contract

ManicProvider.build context dist clientDir serverFile apiEntries after minification.

On this page

Plugin hooks internals
Hook timeline
createPlugin shorthand
Sharp edges
See also