@wirby/codestyle

0.3.1 • Public • Published

@wirby/codestyle

wir.by codestyle tools shared configs

npm code style: prettier Commitizen friendly

Install

npm i -D @wirby/codestyle

Development

make release # to push new version & generate changelog
make prerelease # only push new version to npm, for testing

EditorConfig

Create configuration file .editorconfig at the root of the project. Insert the following content:

root = true

[*]
charset = utf-8
end_of_line = lf
indent_size = 2
indent_style = space
insert_final_newline = true
max_line_length = 100
trim_trailing_whitespace = true

[Makefile]
indent_style = tab

ide

If you use Visual Studio Code, install EditorConfig plugin.


Prettier

config

  1. Create configuration file .prettierrc.js at the root of the project. Insert the following content:
const config = require('@wirby/codestyle/prettier');
module.exports = config;
  1. Also create file .prettierignore, add some ignore patterns:
# ide
.idea/
.vscode/

# npm
node_modules/
package.json
package-lock.json
yarn.lock

# misc
coverage
tsconfig.json

# changelog
*.hbs
CHANGELOG.md

npm

  1. Add following lines to yout package.json:
{
  "scripts": {
    "format": "prettier --write ."
  }
}
  1. And then use as npm run format

ide

JetBrains IDE

Install extension (It is already bundled to WebStorm). You can read more information in Prettier site.

Visual Studio Code

Install extension. Detailed documentation can be found at the extension page.


ESLint

  1. Create configuration file .eslintrc.js at the root of the project. Insert the following content:
module.exports = {
  root: true,
  extends: [
    // choose and enable needed configs
    './node_modules/@wirby/codestyle/eslint/prettier', // prettier first!
    './node_modules/@wirby/codestyle/eslint/base',
    './node_modules/@wirby/codestyle/eslint/typescript',
    './node_modules/@wirby/codestyle/eslint/import',
    // './node_modules/@wirby/codestyle/eslint/next',
    // './node_modules/@wirby/codestyle/eslint/react',
    // './node_modules/@wirby/codestyle/eslint/node',
  ],
};
  1. Add following lines to your package.json:
{
  "scripts": {
    "lint": "eslint . --ext .ts,.tsx,.js,.jsx,.json --fix --cache --max-warnings=0"
  }
}
  1. Also create file .eslintignore, add some ignore patterns:
# ide
.idea/
.vscode/

# npm
**/node_modules/*
package.json
  1. Add .eslintcache to .gitignore

Stylelint

TBD


Conventional Commits

npm i -g commitizen git-cz
  1. add .cz.json:
{
  "path": "git-cz"
}
  1. add changelog.config.js and insert following:
const getChangelogConfig = require('@wirby/codestyle/changelog.config');

module.exports = getChangelogConfig({
  scopes: [
    /* additional scopes */
    'auth',
  ],
  types: {
    /* additional types */
    temp: ['🚧', 'temporary changes'],
  },
});
  1. add commitlint.config.js and insert following:
const getCommitlintConfig = require('@wirby/codestyle/commitlint.config');

const czConfig = require('./changelog.config');

module.exports = getCommitlintConfig(czConfig);
  1. add .release-it.js:
module.exports = require('@wirby/codestyle/release-it');
  1. Add following lines to your package.json:
{
  "scripts": {
    "commit": "git-cz",
    "changelog": "auto-changelog -p && git add CHANGELOG.md",
    "release": "release-it"
  }
}
  1. add badges to README.md
[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)

lint-staged & husky

  1. add lint-staged.config.js and insert following:
module.exports = {
  '*.@(js|jsx|ts|tsx)': ['prettier --write', 'eslint --fix'],
};
  1. add .husky folder to .gitignore

  2. run npx husky install in your project root

You can extend current husky hooks, by adding scripts in you package.json:

  • "husky:commit-msg": "commitlint --edit $HUSKY_GIT_PARAMS"
  • "husky:pre-commit": "lint-staged"
  • "husky:pre-push": "npm run type-check"
  • "husky:prepare-commit-msg": "exec < /dev/tty && git cz --hook || true"

Note: If node_modules are installed and you decide to delete the .husky folder then you need to delete all node_modules and install them again.

Package Sidebar

Install

npm i @wirby/codestyle

Weekly Downloads

1

Version

0.3.1

License

MIT

Unpacked Size

19.6 kB

Total Files

18

Last publish

Collaborators

  • drapegnik