5. Configure an unreleased add-on from an existing repository#

We use mrs-developer tool to manage the development cycle. This tool help us to pull the remote code and configure the current project to have the add-on(s) available for the build.

5.2. mrs.developer.json#

This is the configuration file that instructs mrs-developer from where it has to pull the packages. So, create mrs.developer.json and add:

{
  "acme-volto-foo-addon": {
    "package": "@acme/volto-foo-addon",
    "url": "git@github.com:acme/my-volto-addon.git",
    "path": "src"
  }
}

Then run:

yarn develop

Now the addon is found in src/addons/.

Note

package property is optional, set it up only if your package has a scope. src is required if the content of your addon is located in the src directory (but, as that is the convention recommended for all Volto add-on packages, you will always include it)

If you want to know more about mrs-developer config options, please refer to its npm page.

5.3. tsconfig.json / jsconfig.json#

mrs-developer automatically creates this file for you, but if you choose not to use mrs-developer, you'll have to add something like this to your tsconfig.json or jsconfig.json file in the Volto project root:

{
    "compilerOptions": {
        "paths": {
            "acme-volto-foo-addon": [
                "addons/acme-volto-foo-addon/src"
            ]
        },
        "baseUrl": "src"
    }
}

Warning

Please note that both paths and baseUrl are required to match your project layout.

Tip

You should use the src path inside your package and point the main key in package.json to the index.js file in src/index.js.

5.3.1. Addon development lifecycle#

If you want to "disable" using the development version of an addon, or keep a more stable version of mrs.developer.json in your source code repository, you can set its developing status by adding a develop key:

{
  "acme-volto-foo-addon": {
    "package": "@acme/volto-foo-addon",
    "url": "git@github.com:acme/my-volto-addon.git",
    "path": "src",
    "develop": true
  }
}

You can toggle that key to false and run yarn develop again.

5.3.2. Addon dependencies, yarn workspaces#

If your addon needs to bring in additional JavaScript package dependencies, you'll have to set your addon package as a "Yarn workspace". You do this by adding a workspaces key to the the package.json of your Volto project:

...
"workspaces": ["src/addons/my-volto-addon"],
...

It is common practice to use a star glob pattern for the workspaces:

...
"workspaces": ["src/addons/*"],
...

If you do this, make sure to always cleanup the src/addons folder whenever you toggle the development status of an addon, as the existence of the addon folder under the src/addons will still influence yarn.