@m-scott-lassiter/semantic-release-github-npm-config
Advanced tools
A common, shareable configuration for publishing on Github and NPM
This is a shareable configuration for semantic-release and documents a standard commit message and continuous release practice.
It uses the following plugins:
@semantic-release/commit-analyzer@semantic-release/release-notes-generator@semantic-release/changelog@semantic-release/npm@semantic-release/github@semantic-release/gitFollow these detailed installation insructions.
This specification is inspired by and supersedes the Angular Commit Message. Feel free to copy and modify this section in your own project, or link back here as a common resource.
If possible, make atomic commits, which means:
A complex feature can be broken down into multiple commits as long as each one maintains a consistent state and consists of a self-contained change.
This project uses very precise rules over how Git commit messages must be formatted. This leads to easier to read commit history.
Each commit message consists of a header, a body, and a footer.
<header>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>
The header is mandatory and must conform to the Commit Message Header format.
The body is mandatory for all commits except for those of type "docs".
When the body is present it must be at least 20 characters long and must conform to the Commit Message Body format.
The footer is optional unless resolving issues. The Commit Message Footer format describes what the footer is used for and the structure it must have.
The header contains succinct description of the change:
revert, include reverts commit <hash>, where the hash is the SHA of the commit being reverted<type>(<scope>): <short summary>
│ │ │
│ │ └─⫸ Summary in present tense. Not capitalized. No period at the end.
│ │
│ └─⫸ Commit Scope: <custom>|api|contributing|license|readme|security
│
└─⫸ Commit Type: build|ci|docs|feat|fix|perf|refactor|revert|test
Types
Required. Must be one of the following:
api: Non-functional changes to code API documentation that help other developers understand how to use a tool or feature (i.e. intellisense)build: Changes that affect the build system configuration, package scripts, or dev dependencies (i.e. adds/remove/modify/update)ci: Changes to CI configuration files and scripts (e.g. release configs, YAML scripts)docs: Documentation only changesfeat: Adds or enhances a new matcherfix: Fixes a bug in an existing feature. Also used for non-dev dependency updates.perf: A code change that improves performancerefactor: A code change that neither fixes a bug nor adds a featurerevert: Revert to a committest: Add missing tests or correct existing testsScopes
Optional. If used, must be one of the following supported scopes:
<custom>: Used for extending these settings with your own project's requirementscontributing: Contributions to this guidance or the Code of Conductlicense: Changes to terms or copyright status within the license.
readme: Contributions to the main README.mdsecurity: Changes that address code related security issues or security policiesProvide a plain text description of why you made this change. This is the place for you to explain your thought process, developer to developer. If helpful, include a comparison of the previous behavior with the new behavior to illustrate the change's impact.
If there are breaking changes, start the body with BREAKING CHANGE: <breaking change summary>.
The footer identifies which issues this commit fixes. If none, leave it blank. Otherwise, use the format Resolves #<issue number>. If more than one issue is resolved, separate them with a comma.
This project uses Semantic Versioning and updates automatically based on specific types used in the commit messages.
Pushes to the main branch causes semantic-release to check all commits since the last version for any triggers that would cause a new version. This project extends the defaults:
fixperfapifeatBREAKING CHANGEExtensions from the semantic-release default:
api triggers a patch. Only use this type for non-functional changes to code API documentation that help other developers understand how to use the code.
feat), removing an optional parameter (use BREAKING CHANGE)This keeps API documentation for the end user as a first-class citizen without patching for any and all changes to the README or other supporting docs.
Minor Version Change:
feat(index): add function `foo`
This function adds the key functionality to the project.
Resolves: #1
Patch Version Change:
fix(index): add function `foo`
This function adds the key functionality to the project.
Resolves: #2
Major Version Change:
feat(index): add function `foobar`
BREAKING CHANGE: This function does some new useful things. Due to refactoring in the `foo` function, it no longer
Resolves: #3
No Change:
docs(readme): update readme to document new changes to `foo`
refactor: change `foo` implementation to faster xyz algorithm
Patch Version Change:
api: update the JSDoc comments in the `foo` function for parameter clarity
This configuration and all other files in this repository are distributed as free and open-source software under the MIT License, © 2022.
Contributions and bug reports welcome.
Leave a :star2: if you find this project useful!
Maintained by M. Scott Lassiter.
FAQs
A common, shareable configuration for publishing on Github and NPM
We found that @m-scott-lassiter/semantic-release-github-npm-config demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Company News
Socket won two 2026 Reppy Awards from RepVue, ranking in the top 5% of all sales orgs. AE Alexandra Lister shares what it's like to grow a sales career here.
Security News
NIST will stop enriching most CVEs under a new risk-based model, narrowing the NVD's scope as vulnerability submissions continue to surge.
Company News
/Security News
Socket is an initial recipient of OpenAI's Cybersecurity Grant Program, which commits $10M in API credits to defenders securing open source software.