Skip to content

A repository template for ESLint plugins.

License

Notifications You must be signed in to change notification settings

mysticatea/template-eslint-plugin

Repository files navigation

This is a trial of GitHub Repository Template.

Please update package.json after you created new repository with this template.

File Structure:

  • docs/rules/ is the directory to put documentation.
  • lib/rules/ is the directory to put rule definitions.
  • scripts/ is the directory to put development scripts.
  • tests/lib/ is the directory to put tests for lib/.
  • .eslintignore and .eslintrc.js are the configuration to lint this repository.

Dependencies:

This template uses mocha, nyc, and Travis CI for tests, as same as ESLint itself. If you want to use other tools, customize it.

Development Tools:

  • npm run add-rule foo command adds a rule definition.
  • npm version command updates the following stuff by the meta property of rules:
    • the header of docs/rules/*.md.
    • lib/configs/recommended.js file.
    • lib/index.js file.
    • the rule table in README.md file.

Below is an example of README.


eslint-plugin-xxxx (template)

A template for ESLint plugins.

Installation

Use npm or a compatibility tool to install.

$ npm install --save-dev eslint eslint-plugin-xxxx

Requirements

  • Node.js v8.10.0 or newer versions.
  • ESLint v5.16.0 or newer versions.

Usage

Write your config file such as .eslintrc.yml.

plugins:
  - xxxx
rules:
  xxxx/example-rule: error

See also Configuring ESLint.

Configs

  • xxxx/recommended ... enables the recommended rules.

Rules

Stylistic Issues

Rule ID Description
xxxx/example-rule An example rule. ⭐️

Semantic Versioning Policy

This plugin follows Semantic Versioning and ESLint's Semantic Versioning Policy.

Changelog

Contributing

Welcome your contribution!

See also ESLint Contribution Guide.

Development Tools

  • npm test runs tests and measures coverage.
  • npm version <TYPE> updates the package version. And it updates lib/configs/recommended.js, lib/index.js, and README.md's rule table. See also npm version CLI command.
  • npm run add-rule <RULE_ID> creates three files to add a new rule.

About

A repository template for ESLint plugins.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published