npm-ci-guard
v1.0.0
Published
Guard your npm CI by catching lockfile and npm-version issues before they hit main.
Downloads
137
Maintainers
Readme
npm CI Guard
Catch npm ci / lockfile problems before they break your CI.
npm-ci-guard is a small CLI + GitHub Action that checks:
- Is
package-lock.jsonconsistent withpackage.json? - Are we using an npm version compatible with this lockfile?
- Did someone run
npm installlocally but forget to commit the lockfile?
Status
MVP / experimental - focused on a single command:
npm-ci-guard check.
Why?
Typical pain:
npm cisuddenly breaks in CI after a Node / npm upgrade.npm cifails whilenpm installworked locally.- You pinned npm versions but lockfile behaviour is still flaky.
Job to be done:
Before I merge or upgrade anything, I want to know if our
package-lock.jsonwill install deterministically in CI (and across machines), and if not, what to fix.
Install / Usage
You can run it via npx (no global install needed):
npx npm-ci-guard check