Shared semantic release configuration for Adfinis projects

Usage no npm install needed!

<script type="module">
  import adfinisSygroupSemanticReleaseConfig from 'https://cdn.skypack.dev/@adfinis-sygroup/semantic-release-config';


npm version


Sharable configuration for semantic release.


Currently, this config is only a slight modification of the default config:

  • Add @semantic-release/git plugin to publish updated package.json and CHANGELOG.md to repository after deployment


Install the npm package

yarn add --dev @adfinis-sygroup/semantic-release-config

and add the following to the extends property of your semantic release configuration:

  "extends": "@adfinis-sygroup/semantic-release-config"

This repo also contains commitlint. Configure it to check that commit messagesas are formatted according to the conventional commit format by adding the following to package.json:

  "commitlint": {
    "extends": [

Set up a pre-commit hook to integrate it; e.g. by installing husky:

yarn add husky --dev

then adding the following to package.json:

  "scripts": {
    "prepare": "husky install"

and adding the following script (with execute permissions) to .husky/pre-commit:

. "$(dirname "$0")/_/husky.sh"

# skip in CI
[ -n "$CI" ] && exit 0

# lint commit message
yarn commitlint --edit $1

CI Configuration

  • Add credentials for GitHub and npm as described here
  • Run semantic-release in the deploy stage as described here

Example for a release Github workflow:

name: Release

on: workflow_dispatch

    name: Release
    runs-on: ubuntu-latest
      - uses: actions/checkout@v2
          fetch-depth: 0
          persist-credentials: false
      - uses: actions/setup-node@v2

      - name: Install dependencies
        run: yarn install

      - name: Release on NPM
        run: yarn semantic-release
          GH_TOKEN: ${{ secrets.GH_TOKEN }}
          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}


Optionally, you can also set up commitizen for a more interactive way of adding commits:

$ git cz

? Select the type of change that you're committing:
? What is the scope of this change (e.g. component or file name)?
? Write a short, imperative tense description of the change:
? Provide a longer description of the change: (press enter to skip)
? Are there any breaking changes? No
? Does this change affect any open issues? No

Setup is simple:

npm install -g commitizen
commitizen init cz-conventional-changelog --yarn --dev --exact

After, run git cz instead of git commit.