eslint-release

library3.3.0jsnpmunverified

ESLint Release Tool v3.3.0 is a CLI and API for automating releases in ESLint projects. It generates release versions, updates changelogs, publishes to npm, and creates GitHub releases with proper tags. Key differentiators: tightly coupled to ESLint's commit message conventions (conventional commits), supports both regular and prerelease workflows, and requires minimal configuration via environment variables. Release cadence is irregular focused on ESLint ecosystem needs. Alternative to generic tools like semantic-release but opinionated for ESLint processes.

devops

github ↗package ↗

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.

Package is CJS only; named import works with both require and ESM syntax if using bundler. Use require in Node <14.

import { generateRelease } from 'eslint-release'

Same as above; avoid default import as it doesn't exist.

import { publishRelease } from 'eslint-release'

Default export is the entire module object. Prefer named imports for clarity.

import eslintRelease from 'eslint-release'

Demonstrates programmatic usage of eslint-release: generateRelease() and publishRelease() with required environment variables.

const { generateRelease, publishRelease } = require('eslint-release'); // Set environment variables process.env.NPM_TOKEN = 'your-npm-token'; process.env.ESLINT_GITHUB_TOKEN = 'your-github-token'; // Generate a regular release (prereleaseId undefined, packageTag defaults to 'latest') generateRelease() .then(() => console.log('Release generated successfully')) .catch(err => console.error('Generation failed:', err)); // Publish the generated release publishRelease() .then(() => console.log('Release published successfully')) .catch(err => console.error('Publication failed:', err));

eslint-release --version

Debug

Known footguns

breakingBreaking: minimum Node.js version raised to 10.0.0 in v3.0.0.

deprecatedPackage maintains minimal tests and API is rapidly changing. Not for general use.

gotchaEnvironment variables NPM_TOKEN and ESLINT_GITHUB_TOKEN must be set; otherwise commands fail silently or with generic error.

gotchaThe .eslint-release-info.json file is required for publishRelease() - if missing or corrupted, publish fails.

gotchaCLI commands eslint-generate-release and eslint-publish-release assume git repository with proper commit history; otherwise version calculation fails.

Upgrade

Version history

Breaking-change detection hasn't run for this library yet.

Audit

Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity

9 hits · last 30 days

gptbot

ahrefsbot

script

Resources

githubhttps://github.com/eslint/eslint-release ↗

packagehttps://www.npmjs.com/package/eslint-release ↗