# eslint-config-fullstack

> a complete starter ESLint config file to help students avoid errors and learn best practices

Latest version **6.0.0** (published 2018-07-23) · MIT license · 0 weekly downloads

## Install

```sh
npm install eslint-config-fullstack
pnpm add eslint-config-fullstack
yarn add eslint-config-fullstack
bun add eslint-config-fullstack
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 6.0.0 |
| Published | 2018-07-23 |
| First published | 2016-06-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 42.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 17 |
| Author | Gabriel Lebec |
| Maintainers | fsadmin, geoffbass, glebec, gtelljohann, joedotjs, queerviolet, tmkelly28 |
| Keywords | eslint, eslintconfig, eslintrc, linter, lint, fullstack, gracehopper, academy, fsa, fs, gha, gh, educational |

## Links

- npm: https://www.npmjs.com/package/eslint-config-fullstack
- Repository: https://github.com/FullstackAcademy/eslint-config-fullstack
- Homepage: https://github.com/FullstackAcademy/eslint-config-fullstack#readme
- Issues: https://github.com/FullstackAcademy/eslint-config-fullstack/issues
- npm.io page: https://npm.io/package/eslint-config-fullstack

## Alternatives

- [eslint-plugin-sonarjs](https://npm.io/package/eslint-plugin-sonarjs.md) — 2.9M weekly downloads
- [eslint-config-expo](https://npm.io/package/eslint-config-expo.md) — 1.5M weekly downloads
- [@matter/protocol](https://npm.io/package/@matter/protocol.md) — 63.5K weekly downloads
- [@eventcatalog/linter](https://npm.io/package/@eventcatalog/linter.md) — 24.8K weekly downloads
- [@pandacss/eslint-plugin](https://npm.io/package/@pandacss/eslint-plugin.md) — 18.7K weekly downloads

## Recent versions

- 6.0.0 (latest) — 2018-07-23
- 5.1.0 — 2018-07-23
- 5.0.0 — 2018-04-08
- 4.0.0 — 2018-03-30
- 3.0.0 — 2017-05-17
- 2.8.1 — 2017-03-24
- 2.8.0 — 2017-03-24
- 2.7.0 — 2017-02-09
- 2.6.0 — 2017-01-13
- 2.5.0 — 2016-12-23
- 2.4.0 — 2016-12-23
- 2.3.0 — 2016-12-22
- 2.2.0 — 2016-12-22
- 2.1.0 — 2016-12-22
- 2.0.0 — 2016-11-30
- … 13 more at https://npm.io/package/eslint-config-fullstack/versions

## README

<img src="https://learndotresources.s3.amazonaws.com/workshop/570bdee44a306c0300b78b52/eslint-fullstack.jpg" align="right">

# `eslint-config-fullstack`

[![Built at Fullstack Academy](https://img.shields.io/badge/built%20at-Fullstack%20Academy-green.svg)](http://www.fullstackacademy.com)
[![npm version](https://img.shields.io/npm/v/eslint-config-fullstack.svg?maxAge=3600)](https://www.npmjs.com/package/eslint-config-fullstack)
[![Build Status](https://travis-ci.org/FullstackAcademy/eslint-config-fullstack.svg?branch=master)](https://travis-ci.org/FullstackAcademy/eslint-config-fullstack)
[![Greenkeeper badge](https://badges.greenkeeper.io/FullstackAcademy/eslint-config-fullstack.svg)](https://greenkeeper.io/)

### An ESLint [Shareable Config](http://eslint.org/docs/developer-guide/shareable-configs) for [Fullstack Education Group](http://www.fullstackacademy.com/) Students

## Installation

### Global

Global installation is recommended for [Fullstack Education Group](http://www.fullstackacademy.com/) students. To install or upgrade the config along with its peer dependencies:

```sh
npm install -g eslint eslint-config-fullstack eslint-plugin-react babel-eslint
```

In your global `~/.eslintrc.json` file:

```json
{
    "extends": "fullstack"
}
```

Note that the `eslint-config-` portion of the module name is assumed by ESLint.

### Local

A specific project can extend this definition by including `eslint eslint-config-fullstack eslint-plugin-react babel-eslint` as saved dev-dependencies, and defining a local `.eslintrc.json`. Project-level eslintrc files are recommended to be set as `root`, which prevents users' global configs from producing inconsistent results:

```json
{
    "extends": "fullstack",
    "root": true
}
```

### Note on Parsing

This config now uses `babel-eslint` as the parser by default. This enables linting some relatively modern code which ESLint's default parser does not handle, and was necessary for this project to lint itself. You still need to install `babel-eslint` manually as it is a peer dependency of this config.

## Extending

Any [rules](http://eslint.org/docs/rules/) added to your global or local `.eslintrc.json` files will override the rules defined by this package. For example:

```json
{
    "extends": "fullstack",
    "rules": {
        "semi": [1, "always"]
    }
}
```

This turns on enforcing the use of semicolons, a rule which is silenced by default in the current version of the `eslint-config-fullstack` package.

## Background

The [ESLint](http://http://eslint.org/) linting system is a popular one for its support of ES6 syntax, pluggable [rules](http://eslint.org/docs/rules/), automatic rule names in warning messages, and [shareable](http://eslint.org/docs/developer-guide/shareable-configs) / [extendable](http://eslint.org/docs/user-guide/configuring#extending-configuration-files) config files.

This npm package provides a thorough starting config file. It was developed at [Fullstack Academy of Code / Grace Hopper Academy](http://www.fullstackacademy.com/) to use in an educational setting, helping students to avoid definite errors but also pick up best practices.

Because it defaults to supporting multiple environments (e.g. Node, browsers, Jasmine, Mocha, etc.) it is probably not suitable for general production, where one might want a finer-grained and more restrictive config. However it is easy to override and extend this base config with custom rules, [as explained above and in the ESLint docs](http://eslint.org/docs/user-guide/configuring#using-a-shareable-configuration-package).

## License

MIT

---
_Source: https://npm.io/package/eslint-config-fullstack · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
