scratch-semantic-release-config


Remixed from: @jedmao/semantic-release-npm-github-config

Plugins

This shareable configuration uses the following plugins:

- @semantic-release/commit-analyzer
- @semantic-release/release-notes-generator
- @semantic-release/npm
- @semantic-release/github
- @semantic-release/git

Summary

- Provides an informative git commit message for the release commit that
does not trigger continuous integration and conforms to the conventional commits specification (e.g., "chore(release): 1.2.3 [skip ci]\n\nnotes").
- Creates a tarball that gets uploaded with each GitHub release.
- Publishes the same tarball to npm.
- Commits the version change in package.json.
- Creates or updates a changelog file.

Install

``bash
npm install --save-dev semantic-release scratch-semantic-release-config
`

Usage

The shareable config can be configured in the semantic-release configuration file:

`json
{
"extends": "scratch-semantic-release-config",
"branch": "main"
}
`

Configuration

Ensure that your CI configuration has the following _secret_ environment variables set:

- GH_TOKEN with public_repo access.
- NPM_TOKEN
- NODE_AUTH_TOKEN

See each plugin documentation for required installation and configuration steps.

$3

If you're configuring a GitHub workflow you might want
to do a test build matrix first and then publish only if those tests succeed across all environments. The following
will do just that, immediately after something is merged into main.

`yml
name: Node CI

on:
push:
branches:
- main

jobs:
test:
name: Test on node ${{ matrix.node }} and ${{ matrix.os }}

runs-on: ${{ matrix.os }}

strategy:
matrix:
node: [8, 10, 12]
os:
- ubuntu-latest
- windows-latest
- macOS-latest

steps:
- name: Preserve line endings
run: git config --global core.autocrlf false
- name: Checkout
uses: actions/checkout@v1
- name: Setup Node
uses: actions/setup-node@v1
with:
node-version: ${{ matrix.node }}
- name: Install & test/cover
run: npm ci && npm run cover
env:
CI: true

release:
name: npm publish / GitHub release
needs: test
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v1
- name: Setup Node
uses: actions/setup-node@v1
with:
node-version: 12
registry-url: https://registry.npmjs.org/
- name: Install
env:
CI: true
run: npm ci
- name: Build
if: success()
run: npm run build
- name: Semantic Release
if: success()
env:
GH_TOKEN: ${{ secrets.GH_TOKEN }}
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
run: npx semantic-release
``