verdaccio/website/versioned_docs/version-5.x/dev-plugins.md

id	title
dev-plugins	Developing Plugins

There are many ways to extend verdaccio, the kind of plugins supported are:

• Authentication
• Middleware
• Storage
• Theme
• Filter plugins

We recommend developing plugins using our TypeScript type definitions.

Other plugins

The following plugins are valid and in process of incubation.

Theme Plugin

The plugin must return a function that returns a string. The string should be the absolute location of the root of your user interface.

API

const path = require('path');

module.exports = (...arguments) => {
  return path.join(__dirname, 'static');
};

It is imporant that the name of the plugin must start with verdaccio-theme- prefix.

Theme Example

• @verdaccio/ui-theme: The default Verdaccio theme based in React.js.

Filter Plugin

Since 4.1.0

Filter plugins were introduced due a request in order to be able to filter metadata from uplinks.

More info in the PR.

filters:
  storage-filter-blackwhitelist:
    filter_file: /path/to/file

API

The method filter_metadata will allow you to filter metadata that comes from any uplink, it is Promise based and has to return the same metadata modified.

Do not remove properties from the metadata, try to do not mutate rather return a new object.

interface IPluginStorageFilter<T> extends IPlugin<T> {
	filter_metadata(packageInfo: Package): Promise<Package>;
}