https://github.com/andreapontrandolfo/sheriff

A comprehensive and opinionated Typescript-first ESLint configuration.
https://github.com/andreapontrandolfo/sheriff

astro code-quality eslint javascript jest lint linting lodash nextjs playwright prettier react storybook typescript vitest

Last synced: 4 days ago
JSON representation

A comprehensive and opinionated Typescript-first ESLint configuration.

• Host: GitHub
• URL: https://github.com/andreapontrandolfo/sheriff
• Owner: AndreaPontrandolfo
• License: mit
• Created: 2022-09-25T14:40:07.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2024-12-09T18:37:49.000Z (12 days ago)
• Last Synced: 2024-12-11T06:03:08.378Z (11 days ago)
• Topics: astro, code-quality, eslint, javascript, jest, lint, linting, lodash, nextjs, playwright, prettier, react, storybook, typescript, vitest
• Language: TypeScript
• Homepage: https://www.eslint-config-sheriff.dev
• Size: 12 MB
• Stars: 122
• Watchers: 3
• Forks: 7
• Open Issues: 26
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  

      

    
Sheriff


  

  


    ✨ A comprehensive and opinionated Typescript-first ESLint configuration ✨

  


[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](code_of_conduct.md)

## 🥳 Overview

This repository is a monorepo that hosts the sourcecode of the following projects:

| Link                                                                           | Source                                                                                                            | Description                                                           | Version                                                                                                                                                  |

| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |

| [Sheriff docs website](https://www.eslint-config-sheriff.dev)                          | [docs-website](https://github.com/AndreaPontrandolfo/sheriff/tree/master/apps/docs-website)                       | Sheriff documentation website                                         | |

| [`eslint-config-sheriff`](https://www.npmjs.com/package/eslint-config-sheriff) | [eslint-config-sheriff](https://github.com/AndreaPontrandolfo/sheriff/tree/master/packages/eslint-config-sheriff) | A comprehensive and opinionated Typescript-first ESLint configuration | [![npm](https://img.shields.io/npm/v/eslint-config-sheriff.svg)](https://www.npmjs.com/package/eslint-config-sheriff)                                    |

| [`@sherifforg/create-config`](https://www.npmjs.com/package/@sherifforg/create-config) | [sheriff-create-config](https://github.com/AndreaPontrandolfo/sheriff/tree/master/packages/sheriff-create-config) | Package used to create Sheriff-based ESLint configs                             | [![npm](https://img.shields.io/npm/v/@sherifforg/create-config.svg)](https://www.npmjs.com/package/@sherifforg/create-config)                                    |

| [`@sherifforg/cli`](https://www.npmjs.com/package/@sherifforg/cli) | [sheriff-cli](https://github.com/AndreaPontrandolfo/sheriff/tree/master/packages/sheriff-cli) | The Sheriff CLI. Used to manage Sheriff-based ESLint configs                             | [![npm](https://img.shields.io/npm/v/@sherifforg/cli.svg)](https://www.npmjs.com/package/@sherifforg/cli)                                    |

## 🚀 Getting Started

Visit the [official docs](https://www.eslint-config-sheriff.dev) to get started with Sheriff.

## 📝 Updates

You can follow the latest updates on the project in the [official blog](https://www.eslint-config-sheriff.dev/blog).

## 🧡 Contributing

### Suggestions

I consider Sheriff a community effort, and I welcome suggestions and contributions of any kind.

Feel free to propose suggestions about new rules to implement, or tweaks to existing rules.


Please use the discussions tab or the issues tab for new rules proposals.

### Development

1. Clone this repository

1. Enable Corepack using `corepack enable`

1. Install dependencies using `pnpm install`

1. Do the changes

## 🌤 Changelog

[Releases](https://github.com/AndreaPontrandolfo/sheriff/releases).

## 💌 Acknowledgments

For some of this configuration, [eslint-config-red](https://github.com/GrosSacASac/JavaScript-Set-Up/blob/master/js/red-javascript-style-guide/index.js) was partially used as a base.


Additionally, inspiration was drawn from [eslint-config-airbnb](https://github.com/airbnb/javascript/tree/master/packages/eslint-config-airbnb) for some of the rules in `no-restricted-syntax`.


I don't take any attribution for the rules in the various eslint-plugins used here (except for the few that I personally created). Please consider starring the respective projects for the awesome work their authors made. Sheriff wouldn't be possible without their efforts.


The full list of the plugins used is [here](https://www.eslint-config-sheriff.dev/docs/eslint-plugins).