Skip to main content

Developing Plugins

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

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.


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

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.

filter_file: /path/to/file


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>;