nevir's code style
- …avoid dangerous and/or confusing patterns.
- …encourage patterns that improve readability.
- …enforce as much of the style as possible, to let developers focus on code behavior, not style.
npm install @nevir/code-style --save-dev # Adds peer dependencies to your project, and sets up shared configs. node ./node_modules/@nevir/code-style/.scripts/bootstrap.js
That's it! It will set you up with configuration for the various style tools.
Similarly, whenever you upgrade to a new version of the package, run
bootstrap.js again to update any necessary peer dependencies.
The bootstrap script will set you up with a few new npm scripts for your convenience:
npm run test-style: Checks to see whether any files in your project violate the style. You can optionally pass specific files/globs to test as arguments.
npm run fix-style: Fixes any auto-fixable style issues in your project. You can optionally pass specific files/globs to fix as arguments.
Additionally, it configures VS Code to automatically fix and highlight style issues as you edit files.
The bootstrap script sets up several tools in your project:
This package configures typescript into a very strict mode. Primarily, this is to avoid ambiguous types (ensuring that the compiler can optimally check all usages).
Pretty standard configuration for Prettier. Nothing much special here.
This package configures eslint with…
…a pretty strict set of style rules; to keep you out of trouble, and to minimize arguments over style in PRs.
…support for TypeScript sources.
--fixrules that play nice with Prettier.