Registry / testing / eslint-config-aqua

eslint-config-aqua

library9.2.1jsnpmunverified

A popular ESLint shareable config providing comprehensive linting rules for JavaScript, Node.js, React, Vue, Svelte, JSX, and Prettier integration. Current stable version is 9.2.1, with regular updates tracked on npm. Key differentiators: offers platform-specific configs via simple extends paths, supports both browser and Node environments, and includes optional Prettier configuration to disable conflicting ESLint rules. Requires Node >=10. Actively maintained with frequent dependency upgrades.

testing

npm install eslint-config-aqua

github ↗package ↗

INSTALL

IMPORT

SIG · ESLINT-CONFIG-AQUA

eslint-config-aqua

testingjavascriptv9.2.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

aqua

✓ // In .eslintrc or package.json: { "extends": "aqua" }

✗ import config from 'eslint-config-aqua'; // Incorrect: cannot import directly

This is a shareable config, used via extends in ESLint configuration, not imported in code.

aqua/node

✓ { "extends": "aqua/node" }

✗ { "extends": "aqua-node" }

Use path format with slash for sub-configs. 'aqua/node' targets Node.js environment.

aqua/prettier

✓ { "extends": "aqua/prettier" }

✗ { "extends": "aqua/prettier/base" }

Prettier configs require installation of prettier, eslint-plugin-prettier, and eslint-config-prettier.

aqua/react

✓ { "extends": "aqua/react" }

✗ { "extends": "aqua/react/base" }

React config enables React specific rules, use with project containing JSX.

aqua/vue

✓ { "extends": "aqua/vue" }

✗ { "extends": "aqua-vue" }

Vue config requires additional installation of babel-eslint and eslint-plugin-vue.

Shows installation and configuration of eslint-config-aqua with base, Node, and Prettier setups.

// 1. Install npm i -D eslint-config-aqua // 2. Configure .eslintrc.json { "extends": "aqua", "env": { "browser": true, "node": true } } // 3. Alternatively use platform-specific config { "extends": "aqua/node" } // 4. For Prettier, also install: npm i -D prettier eslint-plugin-prettier eslint-config-prettier // Then in .eslintrc.json: { "extends": "aqua/prettier" } // And create .prettierrc with your rules.

Debug

Known issues

breakingIn v8.0.0, all prettier configs require your own .prettierrc file.

fix

Create a .prettierrc file in your project root with your desired Prettier options.

affects: >=8.0.0

deprecatedThe v7.x series used an older dependency pattern; upgrade to v8+ for latest.

fix

Update to v9.2.1 and follow new Prettier config requirements.

affects: <8.0.0

gotchaThe Vue config requires additional installation of babel-eslint and eslint-plugin-vue; missing them will break.

fix

Run: npm i -D babel-eslint eslint-plugin-vue

affects: >=7.2.0

gotchaThe Prettier configs require eslint-plugin-prettier and eslint-config-prettier; missing will cause errors.

fix

Install: npm i -D prettier eslint-plugin-prettier eslint-config-prettier

affects: >=8.0.0

gotchaUsing 'aqua' without specifying env may result in warnings about browser/Node globals.

fix

Add env: { browser: true } or extend 'aqua/node' for Node projects.

affects: >=7.0.0

breakingv7.x to v8.0.0 removed embedded prettier config; users must supply their own .prettierrc.

fix

Upgrade to v9.2.1 and create .prettierrc file.

affects: 7.x

Errors

Common errors & fixes

Could not find config "aqua".

ESLint cannot locate the shareable config because it is not installed or not referenced correctly.

fix

Ensure eslint-config-aqua is installed: npm i -D eslint-config-aqua. Verify package.json or .eslintrc extends field.

Configuration for rule "no-console" is invalid

Conflict between eslint-config-aqua rules and user's own rules or Prettier config.

fix

Check for overlapping rules; use 'aqua/prettier' to disable formatting rules if using Prettier.

ESLint couldn't find the plugin "eslint-plugin-vue".

Missing required plugin for Vue config.

fix

Install required plugin: npm i -D eslint-plugin-vue (and babel-eslint).

Error: Failed to load config "aqua/node" to extend from.

Typo in extends path or package not installed.

fix

Use correct path: "aqua/node" (case-sensitive). Ensure package is installed.

Upgrade

Version history

9.2.1latest on npm

Audit

Dependencies

eslintrequiredpeer dependency required for the config to work

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/iCrawl/eslint-config-aqua ↗

packagehttps://www.npmjs.com/package/eslint-config-aqua ↗