Skip to main content

Publish & Use

After developing your plugin, the final step is to publish it to npm and enable it in the host system (Xpert AI).

Publish Plugin

Run the following commands in the monorepo root directory:

# Build the plugin
npx nx build my-plugin

# Use the monorepo's release workflow
npx nx release

# Or manually publish to npm
npx nx run @xpert-ai/my-plugin:nx-release-publish --access public --otp=<one-time-password-if-needed>

Once published, you'll get an installable package on npm, for example:

@xpert-ai/my-plugin

Use Plugin

In the Xpert AI host system, declare the list of enabled plugins using the PLUGINS environment variable. Separate multiple plugins with commas:

PLUGINS=@xpert-ai/my-plugin1,@xpert-ai/my-plugin2

When the host starts, it will automatically parse the PLUGINS environment variable and load these plugins in order.

Notes:

  • The host project should install the plugin packages via npm/yarn/pnpm (npm install @xpert-ai/my-plugin) and configure the plugin list in the environment variable.
  • The plugin's meta.name must match the npm package name.
  • If a plugin fails to load correctly, check the logs for register or onPluginBootstrap output.
  • After starting the Xpert AI system, you can view the loaded plugins on the system settings Plugins page.