# eslint-config-lucid

> A collection of eslint plugins with settings focused on reducing cognitive load and improving readability.

Latest version **1.1.0** (published 2026-03-24) · MIT license · 0 weekly downloads

## Install

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

## Health

**Score 50/100 (C)** — status: stable.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 1.1.0 |
| Published | 2026-03-24 |
| First published | 2022-11-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | >=22.16 |
| Dependencies | 13 |
| Unpacked size | 287.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Darren Paul Wright |
| Maintainers | darrenpaulwright |
| Keywords | eslint, config, lucid |

## Links

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

## Dependencies (13)

- [globals](https://npm.io/package/globals.md) ^17.4.0
- [@babel/core](https://npm.io/package/@babel/core.md) ^7.29.0
- [eslint-plugin-n](https://npm.io/package/eslint-plugin-n.md) ^17.24.0
- [eslint-plugin-jsdoc](https://npm.io/package/eslint-plugin-jsdoc.md) ^62.8.0
- [@babel/eslint-parser](https://npm.io/package/@babel/eslint-parser.md) ^7.28.6
- [@babel/eslint-plugin](https://npm.io/package/@babel/eslint-plugin.md) ^7.27.1
- [eslint-plugin-regexp](https://npm.io/package/eslint-plugin-regexp.md) ^3.1.0
- [eslint-plugin-promise](https://npm.io/package/eslint-plugin-promise.md) ^7.2.1
- [eslint-plugin-unicorn](https://npm.io/package/eslint-plugin-unicorn.md) ^63.0.0
- [eslint-plugin-security](https://npm.io/package/eslint-plugin-security.md) ^4.0.0
- [@stylistic/eslint-plugin](https://npm.io/package/@stylistic/eslint-plugin.md) ^5.10.0
- [eslint-plugin-prefer-arrow-functions](https://npm.io/package/eslint-plugin-prefer-arrow-functions.md) ^3.9.1
- [eslint-plugin-you-dont-need-lodash-underscore](https://npm.io/package/eslint-plugin-you-dont-need-lodash-underscore.md) ^6.14.0

## 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

- 1.1.0 (latest) — 2026-03-24
- 1.0.0 — 2025-09-15
- 0.4.0 — 2024-10-25
- 0.3.1 — 2024-01-20
- 0.3.0 — 2024-01-19
- 0.2.1 — 2024-01-08
- 0.2.0 — 2024-01-08
- 0.1.0 — 2023-02-18
- 0.0.1 — 2022-11-13

## README

# Eslint Config Lucid

> A collection of eslint plugins with settings focused on reducing cognitive load and improving readability.
>
> 
<br><a name="Disclaimer"></a>

## Disclaimer
Lucid only supports the new flat config that shipped with ESLint v8.21.0

<br><a name="Installation"></a>

## Installation
First install peer dependencies:
- [eslint](https://www.npmjs.com/package/eslint) 9.x
```
npm i eslint 
```
Next, install eslint-config-lucid:
```
npm i eslint-config-lucid
```
Add Lucid to your eslint.config.js configuration file.

```javascript
import lucid, { lucidBrowser } from 'eslint-config-lucid';

export default [
	...lucid,
	lucidBrowser,
	// ... other rule sets.
];

// Or for node
import { lucidNode } from 'eslint-config-lucid';

export default [
	...lucidNode,
	// ... other rule sets.
];
```

<br><a name="About"></a>

## About
Lucid starts from the eslint recommended settings. These rules are modified to
support the intent of Lucid (see below), and other plugins are added as listed
in the Rules section below.

### Intent

When it comes to formatting and syntax rules, reducing [cognitive load](https://en.wikipedia.org/wiki/Cognitive_load) is the
primary intent of Lucid. Unlike so many code linters and formatters, I endeavor
to base all my decisions on researched psychological principals. Some principles
considered are:

- [Gestalt psychology](https://en.wikipedia.org/wiki/Gestalt_psychology)

    - Many of the rule decisions regarding code formatting are grounded in
      Gestalt Psychology, particularly around the use of whitespace to group
      like things and separate unlike things.

- [Programming complexity](https://en.wikipedia.org/wiki/Programming_complexity)

If you want to propose a change to a rule or suggest additional plugins, please
include researched psychological principals in your issue or pull request.


<br>

## Rules

<dl>
<dt><a href="docs/babel.md">babel</a> : <code>object</code></dt>
<dd><p>ESLint rules for <a href="https://www.npmjs.com/package/@babel/eslint-plugin">@babel/eslint-plugin</a>. Each rule corresponds to a core eslint rule, and has the same options. These allow modern ES features without throwing false errors.</p>
</dd>
<dt><a href="docs/core.md">core</a> : <code>object</code></dt>
<dd><p>Core ESLint rules.</p>
</dd>
<dt><a href="docs/you-dont-need-lodash-underscore.md">you-dont-need-lodash-underscore</a> : <code>object</code></dt>
<dd><p>ESLint rules for <a href="https://www.npmjs.com/package/eslint-plugin-you-dont-need-lodash-underscore">eslint-plugin-you-dont-need-lodash-underscore</a>.</p>
</dd>
<dt><a href="docs/node.md">node</a> : <code>object</code></dt>
<dd><p>ESLint rules for <a href="https://www.npmjs.com/package/eslint-plugin-n">eslint-plugin-n</a>. Note that .js files are set up for es module syntax just like .cjs.</p>
</dd>
<dt><a href="docs/prefer-arrow-functions.md">prefer-arrow-functions</a> : <code>object</code></dt>
<dd><p>ESLint rules for <a href="https://www.npmjs.com/package/eslint-plugin-prefer-arrow-functions">eslint-plugin-prefer-arrow-functions</a>.</p>
</dd>
<dt><a href="docs/promise.md">promise</a> : <code>object</code></dt>
<dd><p>ESLint rules for <a href="https://www.npmjs.com/package/eslint-plugin-promise">eslint-plugin-promise</a>.</p>
</dd>
<dt><a href="docs/regexp.md">regexp</a> : <code>object</code></dt>
<dd><p>ESLint rules for <a href="https://www.npmjs.com/package/eslint-plugin-regexp">eslint-plugin-regexp</a>.</p>
</dd>
<dt><a href="docs/security.md">security</a> : <code>object</code></dt>
<dd><p>ESLint rules for <a href="https://www.npmjs.com/package/eslint-plugin-security">eslint-plugin-security</a>.</p>
</dd>
<dt><a href="docs/@stylistic.md">@stylistic</a> : <code>object</code></dt>
<dd><p>ESLint rules for <a href="https://www.npmjs.com/package/@stylistic/eslint-plugin">@stylistic/eslint-plugin</a>.</p>
</dd>
<dt><a href="docs/unicorn.md">unicorn</a> : <code>object</code></dt>
<dd><p>ESLint rules for <a href="https://www.npmjs.com/package/eslint-plugin-unicorn">eslint-plugin-unicorn</a>.</p>
</dd>
</dl>

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