Skip to main content

Inputs

InputRequiredDescription
github-tokenNoThis is your GitHub token, it's already available to your GitHub action
semverYesThe version you want to bump. For more info please refer to npm semver docs. Use auto to automatically determine the bump. version
commit-messageNoThe commit message template. The keyword {version} will be replaced with the new version. (Default: Release {version})
npm-tokenNoThis is your npm Publish token. Read how to create access tokens. Required only if you want to release to npm. If you omit this, no npm release will be published.
optic-urlNoURL if you have a custom application that serves OTP.
(Default: <Optic service URL>)
optic-tokenNoThis is your Optic token. You can add your npm secret to the Optic app, generate a token and pass it to this input.
(If skipped, no OTP is requested while publishing. Useful when you want to use Automation token instead of Publish token. Read more
actor-nameNoThe name you want to see in the new release commit.
(Default: User who triggered the release workflow)
actor-emailNoThe email you want to see in the new release commit.
(Default: User who triggered the release workflow)
npm-tagNoIf you want to release to the npm with a custom tag, say next.
(Default: latest)
build-commandNoAn optional build commit to run after the version bump and before releasing the package
api-urlNoGitHub App URL. You wouldn't need to set this unless you're deploying a custom GitHub app instead of optic-release-automation.
(Default: https://optic-release-automation-ocrlhra4va-ue.a.run.app/)
app-nameNoGitHub App name. You also wouldn't need to set this unless you're deploying a custom GitHub app.
(Default: optic-release-automation[bot])
sync-semver-tagsNoIf you want to keep the major and minor versions git tags synced to the latest appropriate commit. Note: it will be evaluated as false in case of a prerelease.
(Default: false)
notify-linked-issuesNoAn optional flag to enable an automatic comment on all issues linked to each release so that people following those issues get notified of the code being released.
(Default: true)
artifact-pathNoSet this input to the distribution folder or file you want to add as the main asset for your release. It will be downloadable from the release page and a preview of it will be available in the pull request.
version-prefixNoA prefix to apply to the version number, which reflects in the tag and GitHub release names.
(Default: 'v')
prerelease-prefixNoA prefix to apply to the prerelease version number.
base-tagNoChoose a specific tag release for your release notes. This input allows you to specify a base release (for example, v1.0.0) and will include all changes made in releases between the base release and the latest release. This input is only used for generating release notes and has no functional implications on the rest of the workflow.
provenanceNoSet as true to have npm generate a provenance statement. See Provenance section above for requirements.
(Default: false)
accessNoSet as public or restricted to change an npm package's access status when next published.