Unable to process schema.json/package.json in plugin. ${err.

Error message

Unable to process schema.json/package.json in plugin. ${err.message}

What it means

Error "Unable to process schema.json/package.json in plugin. ${err.message}" thrown in Budibase/budibase.

Source

Thrown at packages/server/src/utilities/fileSystem/plugin.ts:30

  path: string,
  cleanupDirectory = path
): Promise<PluginUpload> => {
  let pkg: Package
  let schema: PluginSchema
  try {
    pkg = JSON.parse(fs.readFileSync(join(path, "package.json"), "utf8"))
    schema = JSON.parse(fs.readFileSync(join(path, "schema.json"), "utf8"))
    if (!pkg.name) {
      throw new Error("package.json is missing 'name'.")
    }
    if (!pkg.version) {
      throw new Error("package.json is missing 'version'.")
    }
    if (!pkg.description) {
      throw new Error("package.json is missing 'description'.")
    }
  } catch (err: any) {
    throw new Error(
      `Unable to process schema.json/package.json in plugin. ${err.message}`,
      { cause: err }
    )
  }

  return {
    metadata: { package: pkg, schema },
    directory: path,
    cleanupDirectory,
  }
}

async function getPluginImpl(path: string, plugin: Plugin) {
  const hash = plugin.schema?.hash
  if (!fs.existsSync(path)) {
    fs.mkdirSync(path)
  }
  const filename = join(path, plugin.name)

View on GitHub (pinned to a81a902e9a)

When it happens

Trigger: Thrown at packages/server/src/utilities/fileSystem/plugin.ts:30 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Budibase/budibase@a81a902e9a (2026-08-29). Data as JSON: /api/errors/f13668e00c131045. Report an issue: GitHub.