Skip to content
Syncpack

Manage npm engines throughout monorepo

Add the engines property of package.json files to also be inspected by syncpack.

1. Add a custom type

I’ve chosen a name of engines but it can be anything you like.

.syncpackrc
{
  "customTypes": {
    "engines": {
      // ^ this is your custom name
      "path": "engines",
      "strategy": "versionsByName",
    },
  },
}

2. Look for mismatches

Perform a one-off check of all versions defined under engines in your monorepo.

Terminal window
syncpack list --types engines

If the versions are not identical, they can be synchronised to all use the highest of the semver versions currently in use.

Terminal window
syncpack fix-mismatches --types engines

3. Track them in future

Add your new custom type to your dependencyTypes.

.syncpackrc
{
  "dependencyTypes": [
    "dev"
    "engines"
    "peer"
    "prod"
  ]
}

Now when you run any syncpack command, versions under engines will also be checked.

Terminal window
syncpack list

4. Relax the rules (optional)

If you don’t want the Node.js version to be identical in every package but do want them all to be compatible with each other, you can use a Same Range Version Group. This defines an exception which only applies to Node.js, leaving anything else found under engines unaffected.

.syncpackrc
{
  "dependencyTypes": [
    "dev"
    "engines"
    "peer"
    "prod"
  ],
  "versionGroups": [
    {
      "dependencies": ["node"],
      "dependencyTypes": ["engines"],
      "policy": "sameRange"
    }
  ]
}