You're reading docs for Nextly Alpha. APIs may change between releases.

CLIError codes

PLUGIN_ROUTE_ROOT_UNREACHABLE

A plugin declares a root-mounted route at a path a request never reaches it on.

Cause

A plugin declares a root-mounted route at a path a request never reaches it on.

A route with mount: "root" is answered only after Nextly's own handlers have had the request. Some first path segments, such as admin-meta or plugins, are claimed by a built-in handler before that, so a root route there could never answer. The Why line names the handler that takes the request.

Fix

  • Leave the route under the plugin's namespace with mount: "plugin", the default.
  • Or move the root route to a path whose first segment no built-in handler claims.

Example

✗ Plugin "reviews" declares a root-mounted route at "/admin-meta/reviews", which cannot answer.
  Why:  The admin metadata endpoints answer from the verb wrappers, and the GET branch claims the whole subtree, so the fallback this route waits for is never reached.
  Next: Leave the route under the plugin's namespace (`mount: "plugin"`), or move it to a path whose first segment no built-in handler claims.
  Docs: https://nextlyhq.com/docs/cli/errors/plugin-route-root-unreachable  (PLUGIN_ROUTE_ROOT_UNREACHABLE)

On this page

Was this page helpful?