Skip to content

feat(firehydrant): add New Frontend System support - #9722

Merged
awanlin merged 10 commits into
backstage:mainfrom
melindadeng:fix-issue-firehydrant
Jul 24, 2026
Merged

feat(firehydrant): add New Frontend System support#9722
awanlin merged 10 commits into
backstage:mainfrom
melindadeng:fix-issue-firehydrant

Conversation

@melindadeng

@melindadeng melindadeng commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Hey, I just made a Pull Request!

Resolves #7537

This PR adds New Frontend System support to the FireHydrant plugin. The plugin can now
be used with the new frontend system by importing from the /alpha entrypoint.

Changes:

  • Created src/alpha.tsx with the plugin reimplemented using createFrontendPlugin,
    ApiBlueprint, and EntityCardBlueprint
  • Updated package.json to export the ./alpha entrypoint
  • Updated README.md with setup instructions for the new frontend system
  • Updated the compatibility table in docs/compatibility/new-frontend-system.md

All legacy code is untouched — users on the old frontend system are unaffected.

✔️ Checklist

  • A changeset describing the change and affected packages. (more info)
  • Added or updated documentation
  • Tests for new functionality and regression tests for bug fixes
  • Screenshots attached (for UI changes)
  • All your commits have a Signed-off-by line in the message. (more info)

Copilot AI review requested due to automatic review settings July 1, 2026 03:15
@melindadeng
melindadeng requested a review from a team as a code owner July 1, 2026 03:15
@melindadeng
melindadeng requested a review from 04kash July 1, 2026 03:15

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds New Frontend System (NFS) support for the FireHydrant frontend plugin by introducing an /alpha entrypoint and updating package exports + documentation so the plugin can be consumed via the new frontend system.

Changes:

  • Added src/alpha.tsx implementing the plugin using createFrontendPlugin, ApiBlueprint, and EntityCardBlueprint.
  • Exposed the /alpha entrypoint via exports + typesVersions and documented NFS usage in the plugin README.
  • Updated the repo-wide NFS compatibility table and added a changeset.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
workspaces/firehydrant/reproduction-notes.md Adds a note about NFS support status (currently incorrect as written).
workspaces/firehydrant/plugins/firehydrant/src/alpha.tsx New NFS plugin implementation via frontend system blueprints.
workspaces/firehydrant/plugins/firehydrant/README.md Adds NFS setup instructions (needs extension-enablement details).
workspaces/firehydrant/plugins/firehydrant/package.json Exports the new ./alpha entrypoint and its types mapping.
workspaces/firehydrant/.changeset/sharp-turkeys-joke.md Changeset for releasing the new alpha entrypoint support.
docs/compatibility/new-frontend-system.md Marks FireHydrant as supported (and updates the generated table).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@@ -0,0 +1 @@
alpha.tsx is absent from workspaces/firehydrant/plugins/firehydrant/src/ confirming New Frontend System support is not implemented
Comment on lines +68 to +85
## New Frontend System Setup

Follow this section if you are using Backstage's new frontend system.

Import the plugin in your `App.tsx` and add it to your app's features array:

```ts
import firehydrantPlugin from '@backstage-community/plugin-firehydrant/alpha';

// ...

export const app = createApp({
features: [
// ... other features
firehydrantPlugin,
],
});
```
Comment on lines +66 to +69
export default createFrontendPlugin({
pluginId: 'firehydrant',
extensions: [firehydrantApi, entityFirehydrantCard],
});
@melindadeng
melindadeng force-pushed the fix-issue-firehydrant branch from 2aea7f0 to 6191542 Compare July 1, 2026 03:25
@backstage-goalie

backstage-goalie Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Changed Packages

Package Name Package Path Changeset Bump Current Version
@backstage-community/plugin-firehydrant workspaces/firehydrant/plugins/firehydrant patch v0.22.0

Copilot AI review requested due to automatic review settings July 1, 2026 03:33

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

@@ -0,0 +1 @@
alpha.tsx is absent from workspaces/firehydrant/plugins/firehydrant/src/ confirming New Frontend System support is not implemented
Comment on lines +66 to +69
export default createFrontendPlugin({
pluginId: 'firehydrant',
extensions: [firehydrantApi, entityFirehydrantCard],
});

@awanlin awanlin left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @melindadeng, if you can rebase and then regenerate the new-frontend-system.md file that would be great, that looks out of date. Also left a few comments, should be pretty easy to address them. 👍

Comment thread workspaces/firehydrant/reproduction-notes.md Outdated
firehydrant.com/service-name: <firehydrant-service-name>
```

## New Frontend System Setup

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please make sure to note that you can use auto discovery or the manual option mentioned below, example: https://github.com/backstage/community-plugins/tree/main/workspaces/linguist/plugins/linguist#new-frontend-system-alpha

Comment thread workspaces/firehydrant/plugins/firehydrant/src/alpha.tsx Outdated
Comment thread workspaces/firehydrant/plugins/firehydrant/src/alpha.tsx Outdated
Comment thread workspaces/firehydrant/.changeset/sharp-turkeys-joke.md Outdated
Melinda Deng and others added 9 commits July 21, 2026 23:12
…ng alpha.tsx

Signed-off-by: Melinda Deng <200534829+melindadeng@users.noreply.github.com>
Signed-off-by: Melinda Deng <200534829+melindadeng@users.noreply.github.com>
Signed-off-by: Melinda Deng <200534829+melindadeng@users.noreply.github.com>
Signed-off-by: Melinda Deng <200534829+melindadeng@users.noreply.github.com>
Signed-off-by: Melinda Deng <200534829+melindadeng@users.noreply.github.com>
Signed-off-by: Melinda Deng <200534829+melindadeng@users.noreply.github.com>
Signed-off-by: Melinda Deng <200534829+melindadeng@users.noreply.github.com>
Signed-off-by: Melinda Deng <200534829+melindadeng@users.noreply.github.com>
backstage#7537

Signed-off-by: Melinda Deng <200534829+melindadeng@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 22, 2026 05:29
@melindadeng
melindadeng force-pushed the fix-issue-firehydrant branch from 1935d0e to b40c115 Compare July 22, 2026 05:29

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Comment thread workspaces/firehydrant/plugins/firehydrant/src/alpha.tsx Outdated
Copilot AI review requested due to automatic review settings July 22, 2026 05:41
…ge#7537

Signed-off-by: Melinda Deng <200534829+melindadeng@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated no new comments.

@melindadeng

Copy link
Copy Markdown
Contributor Author

Thanks @awanlin for the feedback -- addressed all the comments and added tests for the /alpha entrypoint. Also rebased on latest main and regenerated new-frontend-system.md. Ready for another look :)

@melindadeng
melindadeng requested a review from awanlin July 22, 2026 05:49

@awanlin awanlin left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks again @melindadeng 🚀

@awanlin
awanlin merged commit 970c5fc into backstage:main Jul 24, 2026
13 checks passed
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.

🚀 Firehydrant: Add New Frontend System Support

4 participants