renovate-config-e18e

[!WARNING]
This preset is experimental and work in progress. It exists to test the current limits of Renovate presets with
an e18e focus.

A Renovate shared config preset for e18e replaceable packages. It adds replacement recommendations to PR bodies and can automatically replace packages with modern alternatives.

The package list is auto-generated from the module-replacements
package.

Usage

Add the preset to your Renovate config (renovate.json):

 {
   "extends": [
+    "github>OrbisK/renovate-config-e18e"
   ]
 }

The default preset already includes config:best-practices and Merge Confidence columns — no need to add them separately.

It is recommended to pin to a specific version tag to avoid unexpected changes when the package list is updated. You can
find available versions on the releases page.

 {
   "extends": [
-    "github>OrbisK/renovate-config-e18e"
+    "github>OrbisK/renovate-config-e18e#0.1.1"
   ]
 }

Individual presets

The default preset extends best-practices, which combines config:best-practices, recommendations, replacements, and mergeConfidence/all-badges. You can also use the best-practices sub-preset directly or pick individual presets:

Preset	Description
github>OrbisK/renovate-config-e18e:best-practices	Combines config:best-practices, recommendations, replacements, and mergeConfidence/all-badges
github>OrbisK/renovate-config-e18e:abandonment	Marks e18e replaceable packages as abandoned using abandonmentThreshold and adds an e18e label
github>OrbisK/renovate-config-e18e:recommendations	Adds replacement recommendations to PR bodies (see below)
github>OrbisK/renovate-config-e18e:replacements	Replaces packages with recommended alternatives using replacementName, opens a undefineddraft PRundefined with an embedded migration guide
github>OrbisK/renovate-config-e18e:columns/community-notes	Adds a “Community Notes” column to the default prBodyColumns for patch, minor and major updates
github>OrbisK/renovate-config-e18e:mergeConfidence/all-badges-append(column)	All Merge Confidence columns with e18e Community Notes plus a custom appended column
github>OrbisK/renovate-config-e18e:mergeConfidence/age-confidence	Like columns/community-notes with columns matching mergeConfidence:age-confidence-badges
github>OrbisK/renovate-config-e18e:mergeConfidence/all-badges	Like columns/community-notes with columns matching mergeConfidence:all-badges

Using individual presets

To use only specific presets, reference them directly instead of the default:

{
  "extends": [
    "github>OrbisK/renovate-config-e18e:abandonment",
    "github>OrbisK/renovate-config-e18e:replacements"
  ]
}

Recommendations preset

The recommendations preset provides two ways to surface e18e replacement info in PRs:

1. undefined“Community Notes” column — a shields.io badge in the PR body table linking to the e18e replacement docs. The default preset already includes mergeConfidence/all-badges which configures this column automatically. If you use the recommendations preset individually, you can enable the column with a columns or mergeConfidence preset, or add "Community Notes" to your own prBodyColumns manually.

2. undefinedWarning callout — a [!WARNING] note added to the PR body with a link to the e18e replacement guide. This is the fallback behavior when the “Community Notes” column is not in prBodyColumns.

Both are automatically skipped for PRs with updateType: "replacement", since the replacements preset already
provides a detailed migration guide.

[!NOTE]
Renovate’s prBodyColumns does not merge — it overrides. If you set prBodyColumns yourself or use presets that set it (e.g. Merge Confidence), you need to include "Community Notes" in your column list manually.

Columns presets

The mergeConfidence/all-badges-append preset accepts one argument to append a custom column to the all Merge Confidence columns layout (Package, Change, Age, Adoption, Passing, Confidence, Community Notes). This is useful because Renovate’s prBodyColumns does not merge — it overrides, so adding a single column normally requires duplicating the entire list.

{
  "extends": [
    "github>OrbisK/renovate-config-e18e:mergeConfidence/all-badges-append(Pending)"
  ]
}

How it works

The presets are generated from the module-replacements package,
which provides a curated list of npm packages that have preferred modern alternatives (e.g. axios -> native fetch,
chalk -> built-in Node.js styling).

• undefinedAbandonment: Renovate’s abandonmentThreshold marks these packages as abandoned in Renovate’s UI.
• undefinedRecommendations: Defines a prBodyDefinitions entry for a “Community Notes” column, and falls back to a prBodyNotes warning callout when the column is not in prBodyColumns.
• undefinedColumns: Provides prBodyColumns presets that include the “Community Notes” column. Since prBodyColumns does not merge, these presets define the full column list.
• undefinedReplacements: Uses Renovate’s replacementName to open undefineddraft PRsundefined that swap packages (e.g. glob -> tinyglobby) with an embedded migration guide. PRs are drafts because they require manual changes to imports and usage beyond the dependency swap.

Regenerating the config

To update the generated presets after a module-replacements update:

pnpm generate

Releasing

Releases are handled with bumpp and GitHub Actions:

pnpm release

This will prompt for a version, update package.json, create a commit and tag, and push to the remote. A GitHub Actions
workflow then automatically creates a GitHub Release with auto-generated release notes.

Roadmap

• Test grouped PRs
• Publish replacements docs as separate package (replace ./docs)
• Check if automerge is disabled for replacements
• Migrate to e18e org
• e18e badges (size increase from vX to vY, ...)

Renovate wishlist

Features we’d like to see in Renovate to improve this preset:

• Engine match support for dependency replacements, recommend replacements based on the project's Node.js version
• Allow replacements to remove a dependency without specifying a replacement package (remove when available natively)
• Mergeable prBodyColumns Mergeable `prBodyColumns` or an option to append a column to the defaults
• renovate-config-validator `renovate-config-validator` should support subpresets