adoption-insights - version:bump to v1.52.0 by lokanandaprabhu · Pull Request #3893 · redhat-developer/rhdh-plugins

lokanandaprabhu · 2026-07-21T11:07:00Z

Backstage release v1.52.0 has been published, this Pull Request contains the changes to upgrade adoption-insights to this new release.

Please review the changelog before approving, there may be manual changes needed:

Changelog: v1.52.0
Upgrade Helper: From 1.49.3 to 1.52.0

Additional fixes for Backstage 1.52.0 regressions

`NavItemBlueprint` removed in `@backstage/frontend-plugin-api@0.17.0`

Root cause: NavItemBlueprint was removed from @backstage/frontend-plugin-api in v0.17.0. Nav items are now auto-discovered from PageBlueprint extensions via title and icon params.

Fix:

Removed NavItemBlueprint import and usage from alpha.tsx
Added title and icon params to PageBlueprint.make()
Updated Sidebar.tsx to use the new navItems prop (via navItems.rest()) instead of the deprecated items prop

NavItemBlueprint was removed in @backstage/frontend-plugin-api@0.17.0. Migrated to PageBlueprint title/icon params and updated Sidebar to use the new navItems prop instead of the deprecated items prop. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

rhdh-gh-app · 2026-07-21T11:07:27Z

Important

This PR includes changes that affect public-facing API. Please ensure you are adding/updating documentation for new features or behavior.

Changed Packages

Package Name	Package Path	Changeset Bump	Current Version
app-legacy	workspaces/adoption-insights/packages/app-legacy	none	`v0.0.0`
app	workspaces/adoption-insights/packages/app	none	`v0.0.0`
backend	workspaces/adoption-insights/packages/backend	none	`v0.0.0`
@red-hat-developer-hub/backstage-plugin-adoption-insights-backend	workspaces/adoption-insights/plugins/adoption-insights-backend	minor	`v0.8.4`
@red-hat-developer-hub/backstage-plugin-adoption-insights-common	workspaces/adoption-insights/plugins/adoption-insights-common	minor	`v0.8.4`
@red-hat-developer-hub/backstage-plugin-adoption-insights	workspaces/adoption-insights/plugins/adoption-insights	minor	`v0.8.4`
@red-hat-developer-hub/backstage-plugin-analytics-module-adoption-insights	workspaces/adoption-insights/plugins/analytics-module-adoption-insights	minor	`v0.8.4`

sonarqubecloud · 2026-07-21T11:08:16Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

codecov · 2026-07-21T11:08:23Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 56.59%. Comparing base (f8f09d1) to head (fd5ed53).
⚠️ Report is 2 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #3893   +/-   ##
=======================================
  Coverage   56.59%   56.59%           
=======================================
  Files        2372     2372           
  Lines       95021    95021           
  Branches    26591    26578   -13     
=======================================
  Hits        53777    53777           
  Misses      39700    39700           
  Partials     1544     1544

Flag	Coverage Δ	*Carryforward flag
adoption-insights	`84.54% <ø> (ø)`
ai-integrations	`69.26% <ø> (ø)`	Carriedforward from f8f09d1
app-defaults	`69.79% <ø> (ø)`	Carriedforward from f8f09d1
augment	`46.67% <ø> (ø)`	Carriedforward from f8f09d1
boost	`75.27% <ø> (ø)`	Carriedforward from f8f09d1
bulk-import	`72.59% <ø> (ø)`	Carriedforward from f8f09d1
cost-management	`13.55% <ø> (ø)`	Carriedforward from f8f09d1
dcm	`60.72% <ø> (ø)`	Carriedforward from f8f09d1
extensions	`56.18% <ø> (ø)`	Carriedforward from f8f09d1
global-floating-action-button	`71.18% <ø> (ø)`	Carriedforward from f8f09d1
global-header	`62.19% <ø> (ø)`	Carriedforward from f8f09d1
homepage	`47.58% <ø> (ø)`	Carriedforward from f8f09d1
install-dynamic-plugins	`56.77% <ø> (ø)`	Carriedforward from f8f09d1
intelligent-assistant	`69.50% <ø> (ø)`	Carriedforward from f8f09d1
konflux	`91.98% <ø> (ø)`	Carriedforward from f8f09d1
lightspeed	`69.02% <ø> (ø)`	Carriedforward from f8f09d1
mcp-integrations	`83.40% <ø> (ø)`	Carriedforward from f8f09d1
orchestrator	`57.01% <ø> (ø)`	Carriedforward from f8f09d1
quickstart	`65.11% <ø> (ø)`	Carriedforward from f8f09d1
sandbox	`79.56% <ø> (ø)`	Carriedforward from f8f09d1
scorecard	`82.66% <ø> (ø)`	Carriedforward from f8f09d1
theme	`83.85% <ø> (ø)`	Carriedforward from f8f09d1
translations	`5.15% <ø> (ø)`	Carriedforward from f8f09d1
x2a	`79.31% <ø> (ø)`	Carriedforward from f8f09d1

*This pull request uses carry forward flags. Click here to find out more.

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update f8f09d1...fd5ed53. Read the comment docs.

🚀 New features to boost your workflow:

📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

lokanandaprabhu · 2026-07-21T11:14:19Z

Application is working fine.

rhdh-qodo-merge · 2026-07-21T11:25:57Z

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 🔗 Cross-repo conflicts (1) 📜 Skill insights (0)

Context used

✅ Compliance rules (platform): 11 rules

✅ Cross-repo context

Explored: repo: redhat-developer/rhdh (sha: 5992bddd)

Explored: repo: redhat-developer/rhdh-operator (sha: 97f42f76)

Explored: repo: redhat-developer/rhdh-local (sha: 48b26cbd)

Not relevant to this PR: redhat-developer/rhdh-chart

1. RHDH wrappers not bumped 🔗 Cross-repo conflict ☼ Reliability

Description

This PR prepares new minor releases of the adoption-insights packages, but downstream RHDH
dynamic-plugin wrappers are still pinned to 0.8.2, so RHDH won’t consume the new release until
wrapper dependencies are bumped and the corresponding wrapper artifacts/images are
rebuilt/published.

Code

workspaces/adoption-insights/.changeset/version-bump-1-52-0.md[R1-6]

+---
+'@red-hat-developer-hub/backstage-plugin-adoption-insights': minor
+'@red-hat-developer-hub/backstage-plugin-adoption-insights-backend': minor
+'@red-hat-developer-hub/backstage-plugin-adoption-insights-common': minor
+'@red-hat-developer-hub/backstage-plugin-analytics-module-adoption-insights': minor
+---

Relevance

⭐ Low
Prior adoption-insights releases bump packages only; no wrapper bump work here (e.g., PRs #3370,
#2807).
PR-#3370
PR-#2807

ⓘ Recommendations generated based on similar findings in past PRs

Evidence
The PR declares minor bumps for all adoption-insights packages, while downstream RHDH wrappers
explicitly depend on 0.8.2 for the same packages; RHDH also includes tooling that maps npm package
names to published OCI artifact names for wrappers, implying wrapper updates are required before
consuming the new release via dynamic plugin artifacts.
workspaces/adoption-insights/.changeset/version-bump-1-52-0.md[1-6]
External repo: redhat-developer/rhdh, dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-adoption-insights/package.json [46-49]
External repo: redhat-developer/rhdh, dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-adoption-insights-backend-dynamic/package.json [37-43]
External repo: redhat-developer/rhdh, dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-analytics-module-adoption-insights-dynamic/package.json [44-47]
External repo: redhat-developer/rhdh, scripts/compare-wrappers-with-published-oci-images.sh [68-75]

Agent prompt

The issue below was found during a code review. Follow the provided context and guidance below and implement a solution

### Issue description
This PR introduces a minor-version release for adoption-insights packages. Downstream in `redhat-developer/rhdh`, the dynamic-plugin wrapper packages are pinned to `0.8.2`, so adopting this new release requires coordinated updates in RHDH (wrapper dependency bumps and rebuild/publish of wrapper artifacts/images).

### Issue Context
RHDH wrapper packages embed specific `@red-hat-developer-hub/backstage-plugin-...` versions, and RHDH tooling/scripts treat these wrappers as the source of truth for published dynamic-plugin OCI artifacts.

### Fix Focus Areas
- workspaces/adoption-insights/.changeset/version-bump-1-52-0.md[1-6]
- /cross_repos/rhdh/dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-adoption-insights/package.json[46-49]
- /cross_repos/rhdh/dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-adoption-insights-backend-dynamic/package.json[37-43]
- /cross_repos/rhdh/dynamic-plugins/wrappers/red-hat-developer-hub-backstage-plugin-analytics-module-adoption-insights-dynamic/package.json[44-47]
- /cross_repos/rhdh/scripts/compare-wrappers-with-published-oci-images.sh[68-75]

ⓘ Copy this prompt and use it to remediate the issue with your preferred AI generation tools

rhdh-qodo-merge · 2026-07-21T11:26:48Z

PR Summary by Qodo

Bump adoption-insights to Backstage v1.52.0 and migrate nav to PageBlueprint

⚙️ Configuration changes 🐞 Bug fix 🕐 40+ Minutes

AI Description

• Upgrade adoption-insights workspace to Backstage v1.52.0 across app, backend, and plugins.
• Add changeset to release minor versions for adoption-insights packages.
• Migrate frontend nav registration to PageBlueprint title/icon and Sidebar navItems API.

Diagram

graph TD
  A["adoption-insights workspace"] --> B["Backstage v1.52 deps"] --> C["Frontend plugin (alpha.tsx)"] --> D["PageBlueprint title/icon"] --> E["Nav auto-discovery"] --> F["App Sidebar (Sidebar.tsx)"]

  subgraph Legend
    direction LR
    _ws([Component]) ~~~ _file["Source file"] ~~~ _api{{Backstage API}}
  end

High-Level Assessment

The following are alternative approaches to this PR:

1. Pin Backstage / frontend-plugin-api to pre-0.17.x

➕ Avoids the NavItemBlueprint removal migration work
➕ Lower short-term change risk
➖ Blocks v1.52.0 adoption and future upgrades
➖ Accumulates security and compatibility debt

2. Implement custom, app-owned sidebar items (bypass auto-discovery)

➕ Full control over grouping and ordering
➕ Less sensitivity to future nav extension API changes
➖ Moves nav wiring out of the plugin model
➖ More app maintenance and less Backstage-standard behavior

3. Incremental upgrades (1.49.3 → 1.50/1.51 → 1.52)

➕ Smaller, easier-to-debug upgrade steps
➕ Clearer attribution for regressions
➖ More PRs and overhead
➖ Still requires the same endpoint migration work

Recommendation: Proceed with the current approach: upgrading to v1.52.0 and performing the required nav migration is the most sustainable path. The NavItemBlueprint removal is a forced API change; adapting PageBlueprint params and Sidebar consumption keeps the app aligned with Backstage’s supported extension discovery model.

Files changed (13) +124 / -161

Bug fix (2) +14 / -37

Sidebar.tsxMigrate Sidebar to navItems API and new item shape +11/-23

Migrate Sidebar to navItems API and new item shape
• Switches SidebarContent to consume the new navItems prop (navItems.rest()) instead of the deprecated items prop. Updates filtering and rendering to use href/icon values and makes Settings group always present.
workspaces/adoption-insights/packages/app/src/modules/nav/Sidebar.tsx

alpha.tsxRemove NavItemBlueprint and move title/icon to PageBlueprint +3/-14

Remove NavItemBlueprint and move title/icon to PageBlueprint
• Drops NavItemBlueprint usage (removed in @backstage/frontend-plugin-api@0.17.x) and relies on auto-discovered nav items from the page extension. Adds title and icon params directly to PageBlueprint.make() and removes the explicit nav item extension registration.
workspaces/adoption-insights/plugins/adoption-insights/src/alpha.tsx

Documentation (1) +1 / -23

report-alpha.api.mdRefresh alpha API report after nav-item removal +1/-23

Refresh alpha API report after nav-item removal
• Updates the generated alpha API report to reflect removal of the nav-item extension definition and associated IconComponent usage. Keeps API docs consistent with the new PageBlueprint-based nav model.
workspaces/adoption-insights/plugins/adoption-insights/report-alpha.api.md

Other (10) +109 / -101

version-bump-1-52-0.mdAdd changeset for Backstage v1.52.0 upgrade +8/-0

Add changeset for Backstage v1.52.0 upgrade
• Introduces a changeset marking multiple adoption-insights packages for a minor release. Documents the Backstage bump to v1.52.0 as the release driver.
workspaces/adoption-insights/.changeset/version-bump-1-52-0.md

backstage.jsonBump Backstage version metadata to 1.52.0 +1/-1

Bump Backstage version metadata to 1.52.0
• Updates the workspace Backstage version field from 1.49.3 to 1.52.0 to reflect the target release.
workspaces/adoption-insights/backstage.json

package.jsonUpdate repo tooling (cli/defaults/repo-tools) for v1.52 +3/-3

Update repo tooling (cli/defaults/repo-tools) for v1.52
• Bumps Backstage development tooling versions used by the adoption-insights workspace. Aligns CLI/defaults/repo-tools with the v1.52.0 upgrade baseline.
workspaces/adoption-insights/package.json

package.jsonUpgrade legacy app Backstage dependencies to v1.52 line +26/-26

Upgrade legacy app Backstage dependencies to v1.52 line
• Updates the legacy app’s Backstage dependencies and related test utils to versions compatible with Backstage v1.52.0. This is primarily a dependency alignment change with no direct code behavior edits in this PR.
workspaces/adoption-insights/packages/app-legacy/package.json

package.jsonUpgrade app dependencies and frontend-plugin-api to 0.17.x +13/-13

Upgrade app dependencies and frontend-plugin-api to 0.17.x
• Bumps app dependencies including @backstage/frontend-plugin-api to 0.17.2 and updates frontend test utils. This upgrade enables the nav migration away from NavItemBlueprint.
workspaces/adoption-insights/packages/app/package.json

package.jsonUpgrade backend app Backstage dependencies to v1.52 line +26/-26

Upgrade backend app Backstage dependencies to v1.52 line
• Bumps Backstage backend defaults, plugin APIs, and core backend plugins to versions compatible with Backstage v1.52.0. Also updates the backend’s Backstage CLI devDependency.
workspaces/adoption-insights/packages/backend/package.json

package.jsonAlign adoption-insights backend plugin dependencies with v1.52 +8/-8

Align adoption-insights backend plugin dependencies with v1.52
• Updates Backstage backend plugin dependencies and test utilities to match the v1.52.0 upgrade. Keeps the plugin’s dependency surface consistent with the upgraded backend app.
workspaces/adoption-insights/plugins/adoption-insights-backend/package.json

package.jsonUpdate common package peer/dev Backstage versions +2/-2

Update common package peer/dev Backstage versions
• Bumps @backstage/cli and updates the peer dependency on @backstage/plugin-permission-common. Ensures downstream consumers resolve compatible permission common versions.
workspaces/adoption-insights/plugins/adoption-insights-common/package.json

package.jsonUpgrade adoption-insights frontend plugin deps for v1.52 +14/-14

Upgrade adoption-insights frontend plugin deps for v1.52
• Updates plugin dependencies, including @backstage/frontend-plugin-api, catalog-react, and permission-react to versions compatible with Backstage v1.52.0. Also aligns devDependencies (config/core-app-api/dev-utils/test-utils).
workspaces/adoption-insights/plugins/adoption-insights/package.json

package.jsonUpgrade analytics module dependencies for v1.52 +8/-8

Upgrade analytics module dependencies for v1.52
• Bumps core Backstage frontend dependencies (including frontend-plugin-api) and dev tooling to align with v1.52.0. No functional code changes included here beyond version alignment.
workspaces/adoption-insights/plugins/analytics-module-adoption-insights/package.json

v1.52.0 version bump

fd5ed53

NavItemBlueprint was removed in @backstage/frontend-plugin-api@0.17.0. Migrated to PageBlueprint title/icon params and updated Sidebar to use the new navItems prop instead of the deprecated items prop. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

lokanandaprabhu requested review from a team, Eswaraiahsapram, karthikjeeyar and rohitkrai03 as code owners July 21, 2026 11:07

github-actions Bot added the workspace/adoption-insights label Jul 21, 2026

rhdh-qodo-merge Bot added enhancement New feature or request Bug fix labels Jul 21, 2026

christoph-jerolimov approved these changes Jul 21, 2026

View reviewed changes

christoph-jerolimov merged commit 8af2af2 into main Jul 21, 2026
18 checks passed

christoph-jerolimov deleted the adoption-insights/v1.52.0 branch July 21, 2026 22:07

christoph-jerolimov mentioned this pull request Jul 21, 2026

chore(adoption-insights): version bump to v1.51.2 #3403

Closed

4 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

adoption-insights - version:bump to v1.52.0#3893

adoption-insights - version:bump to v1.52.0#3893
christoph-jerolimov merged 1 commit into
mainfrom
adoption-insights/v1.52.0

lokanandaprabhu commented Jul 21, 2026

Uh oh!

rhdh-gh-app Bot commented Jul 21, 2026

Uh oh!

sonarqubecloud Bot commented Jul 21, 2026

Uh oh!

codecov Bot commented Jul 21, 2026 •

edited

Loading

Uh oh!

lokanandaprabhu commented Jul 21, 2026

Uh oh!

rhdh-qodo-merge Bot commented Jul 21, 2026

Uh oh!

rhdh-qodo-merge Bot commented Jul 21, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

lokanandaprabhu commented Jul 21, 2026

Additional fixes for Backstage 1.52.0 regressions

NavItemBlueprint removed in @backstage/frontend-plugin-api@0.17.0

Uh oh!

rhdh-gh-app Bot commented Jul 21, 2026

Changed Packages

Uh oh!

sonarqubecloud Bot commented Jul 21, 2026

Quality Gate passed

Uh oh!

codecov Bot commented Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

lokanandaprabhu commented Jul 21, 2026

Uh oh!

rhdh-qodo-merge Bot commented Jul 21, 2026

Code Review by Qodo

Uh oh!

rhdh-qodo-merge Bot commented Jul 21, 2026

PR Summary by Qodo

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

`NavItemBlueprint` removed in `@backstage/frontend-plugin-api@0.17.0`

codecov Bot commented Jul 21, 2026 •

edited

Loading