Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including simple-release with all npm packages installed. Try it out:

var simpleRelease = require("simple-release")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

simple-release v1.2.0

An npm module for managing release of nested projects

:rocket: simple-release

An npm module for managing release of nested projects

Dependency Status


This was built out of my personal frustration in manually writing changelogs for our project releases. What we have is multiple repositories for different projects and a base repository where all the code is combined before release. Instead of maintaing changelog's for tens of different projects in their own github releases, what this does is combine the latest commits of the base project and all dependent projects and combine them into one changelog, which is used to maintained in the release of the base repository.


Lets say you have a Project Base. There is SubProject 1 and SubProject 2 which are included within Project Base before release. What simple-release aims to do is generate a changelog for each: Project Base, SubProject 1 and SubProject 2. This is then used to create a tagged release in github.

How it works / Setup

Install this module using: npm install -g simple-release

Step 1:

This releases needs access to your github account for creating releases and writing to your project repository. So you will need to create and add your github token to the environment variable GITHUB_TOKEN. For more info, check this article

Step 2:

Go to your base project and type:

$ simple init

This will interactively help you setup your project for use with this module.

Setup screenshot

Thats it. You're all set to start doing hassle free releases!

How to Release

Go to your base project and type:

/* Run for every subsequent releases
 * 'type' is a semver release type
 * Suported values for type: major, premajor, minor, preminor, patch, prepatch, or prerelease
 * Default type is 'patch'
$ simple release <type>

This will:

  1. pick all the latest commits since the last release for your base project and all your sub-projects
  2. create a new semver tag based on the release type
  3. update your package.json with the new tag
  4. create a tagged release with a changelog


Suggestions/ideas on how to make it better are most welcome. :)

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free