Skip to content

Feat/rhidp 16564 entity overview nfs - #4832

Open
rohitratannagar wants to merge 3 commits into
redhat-developer:mainfrom
rohitratannagar:feat/RHIDP-16564-entity-overview-nfs
Open

rohitratannagar wants to merge 3 commits into
redhat-developer:mainfrom
rohitratannagar:feat/RHIDP-16564-entity-overview-nfs

Conversation

@rohitratannagar

@rohitratannagar rohitratannagar commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

Summary

Aligns NFS catalog entity pages in @red-hat-developer-hub/backstage-plugin-app-defaults with legacy RHDH 1.10 when the app-defaults feature loader is used—without requiring app.extensions YAML in the host app.

Jira: RHIDP-16564

“Stock” = default upstream Backstage NFS entity pages (no app-defaults overrides). RHDH defaults = this PR’s behavior via appDefaultsFeatureLoader.

Default UX by kind

Kind Overview Other tabs
Component About + Links left; no dependency/API list cards; no relations graph Dependencies: graph left, list cards right
API About left; relations graph right; no Definition card on Overview Definition unchanged under Documentation → Definition
System About left; relations graph right System Diagram
Group / User About left No relations graph

Stock Backstage tabs (Documentation group, Kubernetes, etc.) are unchanged.

Zero-config enable

Load appDefaultsFeatureLoader from @red-hat-developer-hub/backstage-plugin-app-defaults.

Plugin overrides register:

  • Overview layout: entity-content-layout:catalog/rhdh
  • About/Links type: info in catalog-plugin-override (not app YAML)
  • Tabs: entity-content:catalog/rhdh-dependencies, entity-content:catalog/rhdh-system-diagram
  • Graphs: default entity-card:catalog-graph/relations disabled; rhdh-overview-relations (API/System) and rhdh-dependencies-relations (components)
  • API docs: entity-card:api-docs/definition hidden on Overview

Cards moved to Dependencies (components): depends-on-components, depends-on-resources, has-subcomponents, consumed-apis, provided-apis.

More detail: plugin README — Catalog entity pages (NFS).

Extension IDs (quick reference)

Purpose Extension ID
Overview layout entity-content-layout:catalog/rhdh
Dependencies tab entity-content:catalog/rhdh-dependencies
System Diagram tab entity-content:catalog/rhdh-system-diagram
Overview graph (API, System) entity-card:catalog-graph/rhdh-overview-relations
Dependencies graph (component) entity-card:catalog-graph/rhdh-dependencies-relations
Default relations card (replaced) entity-card:catalog-graph/relations
API definition on Overview (hidden) entity-card:api-docs/definition

Configuration scenarios

Default — full RHDH UX

Use appDefaultsFeatureLoader only; no entity-page YAML required.

A — Disable Dependencies / System Diagram tabs

app:
  extensions:
    - entity-content:catalog/rhdh-dependencies: false
    - entity-content:catalog/rhdh-system-diagram: false

B — Default upstream overview columns (disable RHDH layout)

app:
  extensions:
    - entity-content-layout:catalog/rhdh: false

C — Default upstream single relations graph on Overview

app:
  extensions:
    - entity-card:catalog-graph/rhdh-overview-relations: false
    - entity-card:catalog-graph/rhdh-dependencies-relations: false
    - entity-card:catalog-graph/relations: true

E — Tune relations graph (height / direction)

app:
  extensions:
    - entity-card:catalog-graph/rhdh-overview-relations:
        config:
          height: 500
    - entity-card:catalog-graph/rhdh-dependencies-relations:
        config:
          height: 480
          direction: TB

Ticket: https://redhat.atlassian.net/browse/RHIDP-16564

Test plan

Automated

  • yarn tsc:full in workspaces/app-defaults
  • yarn workspace @red-hat-developer-hub/backstage-plugin-app-defaults test
  • yarn workspace @red-hat-developer-hub/backstage-plugin-app-defaults build
  • yarn build:api-reports:only in workspaces/app-defaults
  • Prettier + pre-commit ESLint on changed plugin sources

Manual (workspaces/app-defaults, yarn start)

Check Expected
Component → Overview About/Links left; no list cards; no graph
Component → Dependencies Graph left; list cards right
API → Overview Graph right; no Definition card
API → Definition tab Definition loads
System → Overview Graph right
System → System Diagram Diagram loads
Group/User → Overview About left; no graph

Use EntityContentLayoutBlueprint with info-left/content-right placement
and RHDH container-query Grid; disable relations card in example config.
@rhdh-gh-app

rhdh-gh-app Bot commented Sep 16, 2026

Copy link
Copy Markdown

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
@red-hat-developer-hub/backstage-plugin-app-defaults workspaces/app-defaults/plugins/app-defaults minor v1.2.1

@codecov

codecov Bot commented Sep 16, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 0% with 138 lines in your changes missing coverage. Please review.
✅ Project coverage is 63.20%. Comparing base (2696305) to head (108f3e0).
⚠️ Report is 3 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #4832      +/-   ##
==========================================
- Coverage   63.29%   63.20%   -0.09%     
==========================================
  Files        2682     2699      +17     
  Lines      106623   106761     +138     
  Branches    29812    29845      +33     
==========================================
  Hits        67483    67483              
- Misses      37331    37469     +138     
  Partials     1809     1809              
Flag Coverage Δ *Carryforward flag
adoption-insights 84.77% <ø> (ø) Carriedforward from 2696305
ai-integrations 79.83% <ø> (ø) Carriedforward from 2696305
app-defaults 38.34% <0.00%> (-16.49%) ⬇️
augment 46.67% <ø> (ø) Carriedforward from 2696305
boost 84.97% <ø> (ø) Carriedforward from 2696305
bulk-import 73.12% <ø> (ø) Carriedforward from 2696305
cost-management 13.53% <ø> (ø) Carriedforward from 2696305
dcm 73.47% <ø> (ø) Carriedforward from 2696305
e2e-adoption-insights 60.00% <ø> (ø) Carriedforward from 2696305
e2e-extensions 62.31% <ø> (ø) Carriedforward from 2696305
e2e-global-header 51.82% <ø> (ø) Carriedforward from 2696305
e2e-homepage 61.11% <ø> (ø) Carriedforward from 2696305
e2e-intelligent-assistant 46.01% <ø> (ø) Carriedforward from 2696305
e2e-orchestrator 49.49% <ø> (ø) Carriedforward from 2696305
e2e-orchestrator-plugin 49.48% <ø> (ø) Carriedforward from 2696305
e2e-quickstart 55.21% <ø> (ø) Carriedforward from 2696305
e2e-scorecard 50.05% <ø> (ø) Carriedforward from 2696305
e2e-theme 16.36% <ø> (ø) Carriedforward from 2696305
extensions 58.30% <ø> (ø) Carriedforward from 2696305
global-floating-action-button 71.18% <ø> (ø) Carriedforward from 2696305
global-header 67.76% <ø> (ø) Carriedforward from 2696305
homepage 48.48% <ø> (ø) Carriedforward from 2696305
install-dynamic-plugins 71.77% <ø> (ø) Carriedforward from 2696305
intelligent-assistant 77.99% <ø> (ø) Carriedforward from 2696305
konflux 91.98% <ø> (ø) Carriedforward from 2696305
lightspeed 69.02% <ø> (ø) Carriedforward from 2696305
mcp-integrations 84.46% <ø> (ø) Carriedforward from 2696305
orchestrator 77.32% <ø> (ø) Carriedforward from 2696305
quickstart 63.74% <ø> (ø) Carriedforward from 2696305
sandbox 79.56% <ø> (ø) Carriedforward from 2696305
scorecard 88.44% <ø> (ø) Carriedforward from 2696305
theme 87.91% <ø> (ø) Carriedforward from 2696305
translations 5.12% <ø> (ø) Carriedforward from 2696305
x2a 78.44% <ø> (ø) Carriedforward from 2696305

*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 2696305...108f3e0. 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.

@rohitratannagar
rohitratannagar force-pushed the feat/RHIDP-16564-entity-overview-nfs branch from 1a9bccf to 6704e03 Compare September 16, 2026 22:59
rohitratannagar and others added 2 commits September 17, 2026 11:44
Complete RHIDP-16564: Dependencies and System Diagram tabs, card
attachments, split relations graphs by kind, hide API definition on
Overview, README/changeset, and plugin overrides without app.extensions.

Co-authored-by: Cursor <[email protected]>
Drop local dev catalog tweaks from RHIDP-16564; entity page behavior stays in the plugin only.

Co-authored-by: Cursor <[email protected]>
@rohitratannagar
rohitratannagar force-pushed the feat/RHIDP-16564-entity-overview-nfs branch from b239779 to 108f3e0 Compare September 17, 2026 06:14
@sonarqubecloud

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant