@runroom/npm-scripts NPM

`npm-scripts`

This package is a collection of basic npm script configurations for Runroom frontend projects. It provides a set of pre-configured scripts and dependencies to streamline the development process and improve code quality.

Features

Ready-to-use configurations for Babel, ESLint, Prettier, Stylelint, PostCSS, Tailwind, and Lint Staged.
Multiple ESLint configurations available for plain JavaScript (vanilla), TypeScript, React, and Next.js projects.
Customizable configurations that can be extended or merged to suit specific project needs.
Integration with popular testing frameworks like Cypress and Jest.
Automatic code formatting on save.
Easy installation of required dependencies for each configuration.

Getting Started

To get started with npm-scripts, follow these simple steps:

Install the package as a development dependency in your project:

npm install --save-dev @runroom/npm-scripts

Install the required dependencies based on the configurations you intend to use. You can either install all dependencies for all configurations or only the ones required for each specific configuration.
Import or extend the desired configuration files into your project's configuration files ( e.g., .babelrc.js, .eslintrc.js, etc.).
Customize the configurations as needed, adding or overriding rules to fit your project requirements.
Start using the pre-configured scripts and enjoy an enhanced development experience with improved code quality.

Babel

To use the Babel configuration:

// babel.config.js

const babelConfig = require('@runroom/npm-scripts').babelConfig;

module.exports = babelConfig;

Required dependencies:

npm install --save-dev @babel/preset-env

ESLint

When using ESLint, there are multiple configurations available to choose from. The configurations include support for plain JavaScript (vanilla), Cypress, Jest, TypeScript, React, and Next.js.

To use the ESLint configuration for plain JavaScript (vanilla):

// .eslintrc.js

const eslintConfig = require('@runroom/npm-scripts').eslintConfig;

module.exports = eslintConfig;

Required dependencies:

npm install --save-dev @babel/core @babel/eslint-parser eslint eslint-config-prettier eslint-config-standard prettier

To use the ESLint configuration with testing support (Cypress + Jest):

// .eslintrc.js

const eslintConfig = require('@runroom/npm-scripts').eslintWithTestConfig;

module.exports = eslintConfig;

Required dependencies:

npm install --save-dev @babel/core @babel/eslint-parser @testing-library/jest-dom babel-jest eslint eslint-config-prettier eslint-config-standard eslint-plugin-cypress eslint-plugin-jest eslint-plugin-testing-library jest jest-transform-stub jest-watch-typeahead prettier

To use the ESLint configuration for TypeScript:

// .eslintrc.js

const eslintConfig = require('@runroom/npm-scripts').eslintTSConfig;

module.exports = eslintConfig;

Required dependencies:

npm install --save-dev @typescript-eslint/eslint-plugin @typescript-eslint/parser eslint eslint-config-prettier eslint-config-standard prettier ts-loader typescript

To use the ESLint configuration for TypeScript with testing support (Cypress + Jest):

// .eslintrc.js

const eslintConfig = require('@runroom/npm-scripts').eslintTSWithTestConfig;

module.exports = eslintConfig;

Required dependencies:

npm install --save-dev @testing-library/jest-dom @typescript-eslint/eslint-plugin @typescript-eslint/parser babel-jest eslint eslint-config-prettier eslint-config-standard eslint-plugin-cypress eslint-plugin-jest eslint

-plugin-prettier eslint-plugin-testing-library jest jest-transform-stub jest-watch-typeahead prettier ts-loader typescript

To use the ESLint configuration for React:

// .eslintrc.js

const eslintConfig = require('@runroom/npm-scripts').eslintReactConfig;

module.exports = eslintConfig;

Required dependencies:

npm install --save-dev @typescript-eslint/eslint-plugin @typescript-eslint/parser confusing-browser-globals eslint eslint-config-prettier eslint-config-standard eslint-plugin-react eslint-plugin-react-hooks prettier ts-loader typescript

To use the ESLint configuration for Next.js:

// .eslintrc.js

const eslintConfig = require('@runroom/npm-scripts').eslintNextConfig;

module.exports = eslintConfig;

Required dependencies:

npm install --save-dev @typescript-eslint/eslint-plugin @typescript-eslint/parser eslint eslint-config-next eslint-config-prettier eslint-config-standard prettier ts-loader typescript

Custom Configuration

If you want to extend the default configurations, you can use the extends files and add them to your configuration file.

For example, to add Jest to the default TypeScript configuration:

// .eslintrc.js

const eslintTS = require('@runroom/npm-scripts').eslintTSConfig;
const jest = require('@runroom/npm-scripts').eslintExtends.jest;

eslintTS.extends = [...eslintTS.extends, jest];

module.exports = eslintTS;

You can also build your own configuration using the extends files. For example, to create a React vanilla configuration with Jest:

// .eslintrc.js

const base = require('@runroom/npm-scripts').eslintExtends.base;
const react = require('@runroom/npm-scripts').eslintExtends.react;
const jest = require('@runroom/npm-scripts').eslintExtends.jest;

module.exports = {
  extends: [base, react, jest]
};

How can I extend some configuration locally?

First, consider if the rule really needs to be local to your project, or if creating a pull request to this repository to make it available to everyone is more appropriate.

If the rule needs to be local to your project, you can extend any configuration by overriding or merging the exported object with your custom configuration.

Here's an example of merging:

const eslintConfig = require('@runroom/npm-scripts').eslintConfig;

// Merging
module.exports = {
  ...eslintConfig,
  rules: {
    ...eslintConfig.rules,
    'your-game': 'your-rules'
  }
};

// Overriding
module.exports = {
  ...eslintConfig,
  rules: {
    'your-game': 'your-rules'
  }
};

Prettier

To use the Prettier configuration:

// prettier.config.js

const prettierConfig = require('@runroom/npm-scripts').prettierConfig;

module.exports = prettierConfig;

Required dependencies:

npm install --save-dev prettier

Stylelint

To use the Stylelint configuration:

// stylelint.config.js

const stylelintConfig = require('@runroom/npm-scripts').stylelintConfig;

module.exports = stylelintConfig;

Required dependencies:

npm install --save-dev stylelint stylelint-config-standard stylelint-config-recommended

PostCSS

To use the PostCSS configuration:

// postcss.config.js

const postcssConfig = require('@runroom/npm-scripts').postcssConfig;

module.exports = postcssConfig;

Required dependencies:

npm install --save-dev postcss postcss-import postcss-mixins postcss-sort-media-queries postcss-preset-env

PostCSS Old

To use the PostCSS configuration:

// postcssOld.config.js

const postcssConfig = require('@runroom/npm-scripts').postcssConfigOld;

module.exports = postcssConfig;

Required dependencies:

npm install --save-dev postcss postcss-import postcss-functions postcss-space postcss-mixins postcss-simple-vars postcss-nested postcss-at-rules-variables postcss-sort-media-queries autoprefixer

Tailwind

🟠 Important: This configuration requires the use of PostCSS.

To use the Tailwind configuration:

// tailwind.config.js

const tailwindConfig = require('@runroom/npm-scripts').tailwindConfig;

module.exports = tailwindConfig;

Required dependencies:

npm install --save-dev tailwindcss

Lint Staged

To use the Lint Staged configuration:

// lint-staged.config.js

const lintStagedConfig = require('@runroom/npm-scripts').lintStagedConfig;

module.exports = lintStagedConfig;

{
  "husky": {
    "hooks": {
      "pre-commit": "lint-staged"
    }
  }
}

Required dependencies:

npm install --save-dev husky lint-staged

VSC config

This configuration provides auto-formatting on save for .js, .ts, .css, and .scss files.

{
  "[javascript]": {
    "editor.formatOnSave": true,
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[typescript]": {
    "editor.formatOnSave": true,
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[css]": {
    "editor.formatOnSave": true,
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  }
}

Contributing

We welcome contributions to npm-scripts! If you encounter any issues, have suggestions, or want to add new features, please feel free to submit an issue or create a pull request.