Registry / devops / eslint-plugin-turbo

eslint-plugin-turbo

library2.9.6jsnpmunverified

Official ESLint plugin for Turborepo, providing lint rules to enforce Turborepo best practices and prevent common misconfigurations. Current stable version is 2.9.6, released alongside Turborepo. It is maintained by Vercel and follows Turborepo's release cadence: canary releases daily, stable releases weekly. Key differentiators: Tight integration with Turborepo's monorepo pipeline; rules like `no-undeclared-env-vars` help catch missing environment variable declarations early. Includes TypeScript type definitions. Requires `turbo >2.0.0` and `eslint >6.6.0`. Supports ESM and CJS.

devops testing

npm install eslint-plugin-turbo

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ESLINT-PLUGIN-TURB

eslint-plugin-turbo

devopsjavascriptv2.9.6

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.

eslint-plugin-turbo

✓ import turbo from 'eslint-plugin-turbo'

✗ const turbo = require('eslint-plugin-turbo')

Default import works in both CJS and ESM; require also works in CJS.

turbo

✓ import turbo from 'eslint-plugin-turbo'

✗ import { turbo } from 'eslint-plugin-turbo'

The plugin is exported as default; named export 'turbo' does not exist.

rules

✓ import { rules } from 'eslint-plugin-turbo'

✗ import rules from 'eslint-plugin-turbo/rules'

Rules are available as a named export for programmatic use.

Configure ESLint with the turbo plugin using the recommended config and an explicit rule.

// .eslintrc.cjs module.exports = { plugins: ['turbo'], extends: ['plugin:turbo/recommended'], rules: { 'turbo/no-undeclared-env-vars': 'error', }, };

Debug

Known issues

deprecatedThe 'turbo/no-undeclared-env-vars' rule may be deprecated in future versions in favor of a more comprehensive env validation.

fix

Watch release notes for migration guidance.

affects: >=2.0.0

gotchaThe plugin requires 'turbo' to be installed as a peer dependency; missing it causes runtime errors.

fix

Run 'npm install turbo --save-dev' in your project.

affects: >=2.0.0

breakingIn version 2.0.0, the plugin switched from CommonJS to ESM-first; some CJS setups may break.

fix

Ensure your ESLint configuration supports ESM, or use dynamic import if needed.

affects: >=2.0.0

gotchaThe 'recommended' config may not enable all rules; check documentation for additional rules.

fix

Explicitly add rules like 'turbo/no-undeclared-env-vars' if needed.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Failed to load plugin 'turbo' declared in '...'

Missing 'turbo' package as peer dependency.

fix

Install turbo: npm install turbo --save-dev

TypeError: Cannot read properties of undefined (reading 'default')

Using named import 'turbo' instead of default import.

fix

Use default import: import turbo from 'eslint-plugin-turbo' or require('eslint-plugin-turbo')

ESLint couldn't determine the plugin 'turbo' uniquely.

Multiple versions of eslint-plugin-turbo installed in monorepo.

fix

Ensure only one version is installed, e.g., by hoisting the dependency.

Upgrade

Version history

2.9.6latest on npm

Audit

Dependencies

turborequiredpeer dependency: required for runtime pipeline validation

eslintrequiredpeer dependency: ESLint plugin core

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/vercel/turborepo ↗

packagehttps://www.npmjs.com/package/eslint-plugin-turbo ↗

homepagehttps://turbo.build/repo ↗