Sherif: Opinionated, zero-config linter for JavaScript monorepos
Sherif is an opinionated, zero-config linter for JavaScript monorepos. It runs fast in any monorepo and enforces rules to provide a better, standardized DX.
- ✨ PNPM, NPM, Yarn...: sherif works with all package managers
- 🔎 Zero-config: it just works and prevents regressions
- ⚡ Fast: doesn't need
node_modulesinstalled, written in 🦀 Rust
Run sherif in the root of your monorepo to list the found issues:
# PNPM
pnpm dlx sherif@latest
# NPM
npx sherif@latestAny error will cause Sherif to exit with a code 1. We recommend running Sherif in your CI once all errors are fixed. This is useful to prevent regressions (e.g. when adding a library to a package but forgetting to update the version in other packages of the monorepo)
You can use --ignore-rule <name> (or -r <name>) to ignore one or multiple rules, and --ignore-package <name> (or -p <name>) to ignore one or multiple packages.
Note Sherif doesn't have many rules for now, but will likely have more in the future (along with more features).
package.json files should not have empty dependencies fields.
A given dependency should use the same version across the monorepo.
You can use --ignore-dependency <name> (or -i <name>) to ignore a dependency and allow having multiple versions of it.
The root package.json is private, so making a distinction between dependencies and devDependencies is useless - only use devDependencies.
The root package.json should specify the package manager and version to use. Useful for tools like corepack.
The root package.json should be private to prevent accidentaly publishing it to a registry.
- dedubcheck that given me the idea for Sherif
- Manypkg for some of their rules
- This article for the Rust releases on NPM