Platform Help

Semantic Release

Prerequisites:

pnpm i -D @kurocado-studio/styleguide

Install Semantic Release

Install semantic-release and the plugins you intend to use (at minimum, the base config expects @semantic-release/changelog):

pnpm i -D semantic-release @semantic-release/changelog

Configure Semantic Release

Create a .releaserc.mjs:

Apps (not published to npm)

export { semanticReleaseAppConfig as default } from '@kurocado-studio/styleguide';

npm packages (published)

export { semanticReleaseNpmConfig as default } from '@kurocado-studio/styleguide';

Options

Export

Type

Use when

Notes

semanticReleaseBaseConfig

object

You want to build your own

Includes conventional commits + changelog plugin.

semanticReleaseAppConfig

object

Apps released on GitHub

Base + @semantic-release/github.

semanticReleaseInternalConfig

object

Internal-only versioning

Only commit analysis (minimal side effects).

semanticReleaseNpmConfig

object

Publish to npm

Adds prerelease branches + @semantic-release/npm.

semanticReleaseAppMonorepoConfig

object

Monorepo app release

Extends semantic-release-monorepo.

semanticReleaseInternalMonorepoConfig

object

Monorepo internal release

Extends semantic-release-monorepo.

semanticReleaseNpmMonorepoConfig

object

Monorepo npm release

Extends semantic-release-monorepo.

Branch channels (npm preset)

Branch

Channel

Pre-release

alpha

alpha

true

beta

beta

true

develop

canary

true

pre

pre/rc

"rc"

Add scripts

{ "scripts": { "release": "semantic-release" } }
Last modified: 18 December 2025