Skip to content

Create & update a major tag for your release using semantic-release (for example 'v2')

Notifications You must be signed in to change notification settings

doteric/semantic-release-major-tag

Repository files navigation

semantic-release-major-tag

A package for semantic-release that creates or updates the major tag (v2 for example) for you depending on the release version. The plugin works only on the success step of semantic-release.

Why?

Motivation: semantic-release/semantic-release#1515

Setup

  1. Install
npm install --save-dev semantic-release-major-tag
# or
yarn add -D semantic-release-major-tag
  1. Include the plugin inside the plugins section of the semantic-release configuration.
{
  "plugins": [
    // ...
    "semantic-release-major-tag",
    // ...
  ]
}

Settings

customTags (optional, defaults to [v${major}]) - An array of the tags format to be created.
Use ${major}, ${minor} or ${patch} as strings to specify where you would like the specific version number to be present.

includePrerelease (optional, defaults to false) - Set to true if you would like to include prereleases.

Example:

{
  "plugins": [
    // ...
    ["semantic-release-major-tag", {
      "customTags": ["v${major}-example", "example-${major}.${minor}"],
    }],
    // ...
  ]
}