skills.rest
nrwl
nrwlOFFICIAL
Explore all skills by this author →
Website𝕏@nxdevtoolsGitHub

nx-gradle-plugin-version-bump

Bumps the dev.nx.gradle.project-graph plugin version across five files with migration generation.

29.3k|3.0k|Updated Aug 11, 2017
Search Tags:#plugin#release automation#gradle#Monorepo#version bump#NX#Migration
One-click install
npx skills add https://github.com/nrwl/nx --skill nx-gradle-plugin-version-bump
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nx-gradle-plugin-version-bump
Source: https://github.com/nrwl/nx/tree/main/.claude/skills/nx-gradle-plugin-version-bump
Command: npx skills add https://github.com/nrwl/nx --skill nx-gradle-plugin-version-bump

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Releasing a new version of the dev.nx.gradle.project-graph plugin requires identical edits across five files, including version constants, build scripts, migration code, documentation, and migrations.json, which is error-prone when done manually.

Core Features & Use Cases

  • Version Constant Updates: Updates gradleProjectGraphVersion in versions.ts and the version field in build.gradle.kts.
  • Migration Generation: Creates the TypeScript migration file and Markdown documentation under the correct MIGRATION_FOLDER derived from the Nx version.
  • migrations.json Registration: Adds the new migration entry with implementation and documentation paths following the existing schema.
  • Use Case: When the Nx team prepares a release that ships a new Gradle project-graph plugin version, run this Skill to produce all five file changes consistently and verify them with nx run-many -t test,build,lint -p gradle.

Quick Start

Bump the Gradle project graph plugin to the next version and create the corresponding migration files and migrations.json entry.

Frequently Asked Questions about nx-gradle-plugin-version-bump

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bump the dev.nx.gradle.project-graph plugin version in Nx?▼

Update gradleProjectGraphVersion in packages/gradle/src/utils/versions.ts and the version field in packages/gradle/project-graph/build.gradle.kts, then create migration files under packages/gradle/src/migrations and register the entry in packages/gradle/migrations.json.

How do I create an Nx migration for a Gradle plugin version change?▼

Create a TypeScript file in the version-derived migration folder that calls updateNxPluginVersionInCatalogsAst and addNxProjectGraphPlugin with the new version, add a Markdown documentation file, and register both in migrations.json with dist-prefixed paths.

Which files change in an Nx Gradle plugin version bump?▼

Exactly five files change: versions.ts, build.gradle.kts, the new migration TypeScript file, the migration Markdown documentation, and migrations.json. Compare against the most recent version bump PR to confirm no extra or missing files.

How is the migration folder name derived from the Nx version?▼

Take the Nx version from package.json devDependencies, replace dots with hyphens, and remove any beta or rc suffix. For example, 22.7.0-beta.1 becomes the folder 22-7-0 under packages/gradle/src/migrations.

How do I verify a Gradle plugin version bump in Nx?▼

Run nx run-many -t test,build,lint -p gradle to execute tests, builds, and linting for the gradle package. Then compare your diff against the most recent version bump PR to confirm the same set of files changed.

Related Skills

Explore More Software Engineering Skills→
inho-teaminho-team
6

Mbump

Bump the QE Framework version across plugin.json, package.json, and marketplace.json.

Official
Advanced
AIKUSANAIKUSAN
2

minecraft-ci-release

Automate Minecraft CI and release workflows for Fabric, NeoForge, and Paper projects.

Community
Advanced
chrisjwalkchrisjwalk
71

update-packages

Automate npm package updates across a monorepo with nx migrate.

Community
Advanced
heikopanjasheikopanjas

semantic-versioning

Determine and apply MAJOR, MINOR, or PATCH version bumps in project manifests.

Community
Intermediate