A collection of base configs and CLI wrappers used to speed up development @ Spotify.
Five of the projects in this repo are shared configurations for common tools we use for building, linting, and formatting our code. They can be installed separately and used by anyone should they opt to follow our standards. We have a specialized point-of-view on what belongs in our configs.
We also combine the above packages and wrap them as a CLI called web-scripts
. This library is most useful for buidling and deploying npm packages. It is inspired by react-scripts.
We have a few guiding principles for this project.
- Style rules should be auto-fixable and if you can, errors should be linted ahead of runtime.
- Avoid enforcing code style in static analysis; search for bugs with static analysis, and let auto-formatting deal with code style.
- Push "fast" checks as far left as you can. Optimize for code editors/IDEs fixing issues and enforcing things; write Git hooks that catch things as a failsafe; and use static analysis in CI to prevent bad things from getting into master.
web-scripts
is meant to be configurable. We want to avoid the "eject" problem. You should be able to easily take the base configs and extend them in your project.
- TypeScript: a superset of JavaScript which we think helps make code readable and less bug-prone.
- ESLint: used for static code analysis with some auto-fixing.
- Prettier: use to format code pre-commit and automatically in your editor.
- Jest: our preferred JavaScript test framework.
- husky: allows us to hook into git events in a convenient way.
- lint-staged: allows us to write pre-commit hooks which target specific paths and run a series of commands.
This project adheres to the Open Code of Conduct. By participating, you are expected to honor this code.
This project is an opinionated approach to static analysis, code formatting, testing, and publishing. It's the result of consensus between many web engineers inside Spotify, and the default configs will mostly be written by Spotify employees. We may reject PRs to the ESLint config if we don't agree that the rule makes sense as part of our baseline, for example. Use it if it aligns with your needs!
For now, we will release this repo manually with fixed versions. To do that, use lerna publish --conventional-commits
.