frontend-plugin-api: deprecate multiple attachment points and document api pattern

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
This commit is contained in:
Patrik Oldsberg
2026-01-26 01:48:40 +01:00
parent 467aa1d58d
commit 9554c36e4c
7 changed files with 203 additions and 18 deletions
@@ -165,6 +165,12 @@ export function resolveAppTree(
if (spec.id === rootNodeId) {
rootNode = node;
} else if (Array.isArray(spec.attachTo)) {
// eslint-disable-next-line no-console
console.warn(
`Extension '${spec.id}' is using multiple attachment points which is deprecated and will be removed in a future release. ` +
`Use a Utility API instead to share functionality across multiple locations. ` +
`See https://backstage.io/docs/frontend-system/architecture/27-sharing-extensions for migration guidance.`,
);
let foundFirstParent = false;
for (const origAttachTo of spec.attachTo) {
let attachTo = origAttachTo;