Create and publish TS/JS NPM packages seamlessly.
Interested in supporting this free template?
- Clone, download or fork this project.
- Replace in the package.json the next values with your own ones:
- name
- description
- keywords
- repository
- author
- Add
Read and write permissions
andAllow GitHub Actions to create and approve pull requests
inhttps://github.com/<username>/<project-name>/settings/actions
- Create a NPM secret and add it to the project secrets:
- Generate Token in
https://www.npmjs.com/settings/<your-profile>/tokens
- Create a
New repository secret
namedNPM_TOKEN
and copy its value (https://github.com/<username>/<project-name>/settings/secrets/actions
)
- Generate Token in
- (Optional) Add codecov flow:
- Go to codecov, login, find your project and add the given
CODECOV_TOKEN
to your project secrets (https://github.com/<username>/<project-name>/settings/secrets/actions
).
- Go to codecov, login, find your project and add the given
As you can check in .releaserc and release.yml workflow, and read in depth in the semantic-release documentation, the project is configured to trigger a new versioned commit and publish to NPM under master
, next
, next-major
, beta
and alpha
.
To skip a CI include [skip ci]
in the commit title or cancel the Github action.
This follows the conventional commits, so to trigger:
- patch: Add a
fix
commit to a relevant branch . - minor: Add a
feat
commit to a relevant branch . - major: Add a
BREAKING CHANGE: description
footer commit to a relevant branch like:
feat: New core processing
BREAKING CHANGE: core functions are broken and not backward compatible.
IMPORTANT: Commits with !
will not trigger a new version nor will be recorded in the changelog (example: feat!: breaking stuffs
).