Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/americanexpress/eslint-config-amex

โœจ This is American Express' eslint config
https://github.com/americanexpress/eslint-config-amex

eslint linting one-app style-guide

Last synced: 10 days ago
JSON representation

โœจ This is American Express' eslint config

Lists

README

        


Eslint Config Amex - One Amex

[![npm](https://img.shields.io/npm/v/eslint-config-amex)](https://www.npmjs.com/package/eslint-config-amex)
[![Health Check](https://github.com/americanexpress/eslint-config-amex/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/americanexpress/eslint-config-amex/actions/workflows/ci.yml)

> ESLint configurations used at American Express.

## ๐Ÿ‘ฉโ€๐Ÿ’ป Hiring ๐Ÿ‘จโ€๐Ÿ’ป

Want to get paid for your contributions to `eslint-config-amex`?
> Send your resume to [email protected]

## ๐Ÿ“– Table of Contents

* [Usage](#-usage)
* [Contributing](#-contributing)
* [License](#๏ธ-license)
* [Code of Conduct](#๏ธ-code-of-conduct)

## ๐Ÿคนโ€ Usage

### Installation

```bash
npm install --save-dev eslint eslint-config-amex
```

The default config provides support for React applications. ESLint configs are also provided for:

* Jest
* Prettier

Install required peer dependencies before [extending your ESLint config](#extend-your-eslintrc):

Jest:

```bash
npm install --save-dev typescript eslint-plugin-jest eslint-plugin-jest-dom
```

Prettier:

```bash
npm install --save-dev prettier eslint-plugin-prettier
```

### Extend your `.eslintrc`

To use the base config:

```json
{
"extends": "amex"
}
```

To use the Prettier compatible config:

```json
{
"extends": "amex/prettier"
}
```

### (Optionally) Create an `.eslintrc` file in your test directory

```json
{
"extends": "amex/test"
}
```

If you are using Prettier use the `prettier/test` config:

```json
{
"extends": "amex/prettier/test"
}
```

This gives you the `jest` global and some `jest` specific rules.

## ๐Ÿ† Contributing

We welcome Your interest in the American Express Open Source Community on Github.
Any Contributor to any Open Source Project managed by the American Express Open
Source Community must accept and sign an Agreement indicating agreement to the
terms below. Except for the rights granted in this Agreement to American Express
and to recipients of software distributed by American Express, You reserve all
right, title, and interest, if any, in and to Your Contributions. Please [fill
out the Agreement](https://cla-assistant.io/americanexpress/eslint-config-amex).

Please feel free to open pull requests and see [CONTRIBUTING.md](./CONTRIBUTING.md) to learn how to get started contributing.

## ๐Ÿ—๏ธ License

Any contributions made under this project will be governed by the [Apache License 2.0](./LICENSE.txt).

## ๐Ÿ—ฃ๏ธ Code of Conduct

This project adheres to the [American Express Community Guidelines](./CODE_OF_CONDUCT.md).
By participating, you are expected to honor these guidelines.