Releasy will automatically do the following:
- Increment the version in the
- Commit the changed version file;
- Create a Git tag with the version;
- Push the tag and changes to the Git remote;
- If exists, increment version and date in the
- Post the release notes from CHANGELOG on GitHub release.
A GitHub Personal access token will be needed to create the release on GitHub and with all
repo permissions. When you created, add the token to an environment variable named
GITHUB_API_TOKEN in your
~/.bash_profile (for bash users) or
~/.config/fish/config.fish (for fish users) by adding the following line at the end of the file.
If you want to see what happens, grab it (
npm i -g releasy) and run anything with the
--dry-run flag. This mode will only show you what would happen, without actually applying any changes. At any time, calling
releasy -h or
releasy --help will show you the list of options available. Try it.
The default behavior increments the
patch and creates a
beta prerelease using the
$ releasyOld version: 1.0.0New version: 1.0.1-betaprompt: Are you sure?:Starting release...Version bumped to 1.0.1-betaFile package.json added # git add package.jsonFile package.json committed # git commit package.json -m "Release v1.0.1-beta"Tag created: v1.0.1-beta #git tag v1.0.1-beta -m "Release v1.0.1-beta"Pushed commit and tags # git push && git push --tagsAll steps finished successfully.
You can increment other parts of the version by providing a first argument:
$ releasy patch # 1.2.3 => 1.2.4-beta$ releasy minor # 1.2.3 => 1.3.0-beta$ releasy major # 1.2.3 => 2.0.0-beta$ releasy prerelease # 1.2.3-beta.4 => 1.2.3-beta.5$ releasy pre # is an alias to 'prerelease'
When you are ready to promote a beta version to stable, use the
$ releasy promote # 1.2.3-beta.4 => 1.2.3
Or, if you want to increment directly as stable version, use the
$ releasy --stable # 1.2.3 => 1.2.4
To apply a custom prerelease identifier:
$ releasy --tag alpha # 1.2.3 => 1.2.4-alpha
If you want to post the release notes on GitHub, use the
$ releasy --stable --notes # Release Notes submitted
If you want to prevent releasy from automatically committing, tagging or pushing, use the
$ releasy --stable --no-tag --no-push
You may create a file called
_releasy.yaml to any values set in this file will be used as default. If you prefer,
.json extensions will also work. Below is a sample
#type: prerelease # prerelease as default incrementfilename: otherpackage.json # different version file as default# you may also use any other options available on the command linestable: true # release stable versiontag: alpha # use alpha as prerelease namedry-run: true # always use dry-run modeno-tag: true # don't tag the release commitno-push: true # don't push to the remote repositoryno-commit: true # don't create the release commitdisplay-name: true # add the project name to the tag and release commit# etc
Different version files
Releasy currently supports both NodeJS' package.json and .NET C#'s AssemblyInfo.cs. The default file used is
package.json, but you may specify a different value through the options file or in the command line.
If the specified file has a
.json extension, it will be treated as Node's
package.json. This means that the version will be read from and written to your package's
If the specified file has a
.cs extension, it will be treated as an
AssemblyInfo.cs file. As such, the version will be read from and written to assembly version attributes, which are:
To conform to the .NET Framework's specification, only the
AssemblyInformationalVersion attribute will retain any prerelease version information, while the other two will be stripped of it, keeping just the version numbers.
The format of your changelog is according to Keep a Changelog that requires an
## [Unreleased] section for the next release, and the types of changes below this section.
An example of a first CHANGELOG.md to create before using a
# ChangelogAll notable changes to this project will be documented in this file.The format is based onand this project adheres to .## [Unreleased]### Added- My new feature### Fixed- An bug