platformchangelog.dev
44 tools
feedrelease

Backstage v1.57.0

security+++++++++++++-!!!!

Backstage v1.57.0 ships 62 changes, including security fixes across 13 backend, scaffolder, catalog, events, TechDocs and CLI packages. Breaking frontend changes include removing the /alpha entry point, replacing createSpecializedApp with prepareSpecializedApp, and moving from IconComponent to IconElement. Smaller additions include a github:repo:rulesets:create scaffolder action and per-plugin keying for the Valkey cache store.

What changes for platform teams

Platform teams running Backstage must review frontend plugin migrations and update imports before upgrading, and should apply the security fixes in the listed backend packages. Teams using the Valkey cache store should plan for cache rebuilds and manual cleanup of entries without a time to live.

Changes

  • @backstage/backend-defaultssecurity
  • @backstage/plugin-auth-backendsecurity
  • @backstage/plugin-catalog-backendsecurity
  • @backstage/plugin-catalog-backend-module-gitlabsecurity
  • @backstage/plugin-events-backend-module-azuresecurity
  • @backstage/plugin-events-backend-module-githubsecurity
  • @backstage/plugin-events-backend-module-gitlabsecurity
  • @backstage/plugin-scaffolder-backendsecurity
  • @backstage/plugin-scaffolder-reactsecurity
  • @backstage/plugin-techdocs-backendsecurity
  • @backstage/plugin-techdocs-backend-module-zensicalsecurity
  • @backstage/plugin-techdocs-nodesecurity
50 more lines
  • @techdocs/clisecurity
  • Remove the ignored anchorOrigin option from built-in alert display configuration and toast display props.removed
  • API reference IDs now use the plugin ID format for each dot-separated component, accepting mixed case and numeric dash groups such as plugin.example-2.todos.added
  • Test rendering helpers preserve their test extensions when a plugin named test is included in features.added
  • Backend startup results include optional beginAt timestamps for plugin and module initialization, separating initialization time from time spent waiting for dependencies. Contributed by @hudsonb in #36326.added
  • CoreServices and mockServices are now frozen objects. Existing calls and types remain available, but runtime mutation and spying on the mock service helpers themselves are no longer supported; the mocks they create are unaffected.added
  • The Valkey cache store now separates keys by plugin. Existing cache values are rebuilt under new keys, and old entries without a time to live need manual cleanup. Contributed by @pavstev in #36584.added
  • App backend startup uses less memory and database traffic when checking cached assets. Contributed by @hudsonb in #36458.added
  • MarkdownContent loads its renderer on first use, reducing the app startup bundle. Tests that immediately assert on rendered Markdown may need asynchronous queries.added
  • Apps no longer remount when deferred root elements are added during finalization, and swappable components preserve mounted state when their props change.added
  • Dismissed toasts no longer reappear when the toast display remounts, such as after a theme change. Contributed by @abdul-karim-mia in #36813.added
  • Dynamic frontend plugins can export a FrontendFeatureLoader. Contributed by @hopehadfield in #35687.added
  • Dynamic backend plugins can resolve shared packages with the isolated pnpm linker. Contributed by @sebdanielsson in #36229.added
  • TechDocs releases storage connections when browsers disconnect early, including a fix for S3 connection pool exhaustion. Contributed in part by @lvthillo in #36468.added
  • The TechDocs table of contents stays aligned with the documentation on wide screens. Contributed by @bhargavikvmpl-2001 in #36216.added
  • Software Templates supports GitLab branch autocompletion in RepoBranchPicker. Contributed by @ebarault in #36086.added
  • The new github:repo:rulesets:create action lets Software Templates create GitHub repository rulesets, including rules and bypass actors in the GitHub REST API format. Contributed by @rbstp in #36776.added
  • Scaffolder task controls retain their chosen visibility after completion, log redaction preserves public values, and custom task permission rules are honored. Contributed by @ebarault in #36472, #36477, and #36210.added
  • BUI template forms have clearer array item headings, more accessible item controls, and working enum multi-select fields. Contributed by @ebarault in #36469, and @Dasmat13 in #36423 and #36331.added
  • GitLab publish actions check individual files if listing the repository tree fails, avoiding incorrect file-creation attempts. Contributed by @leneti in #36486.added
  • Confluence attachment download failures now fail the task rather than leaving it hanging, and downloaded files are closed correctly. Contributed by @rowmanempire in #36745.added
  • Broadcast notifications preserve their read and saved states independently. Contributed by @FayezBast in #36535.added
  • DevTools displays backend errors and loading progress for scheduled tasks. Contributed by @Dasmat13 in #36533.added
  • GitHub organization providers can request public emails when authenticating with a GitHub App using fetchEmailForGithubApps. Enable it only after checking that your GitHub instance supports the query. Contributed by @vinzscam in #36736.added
  • AWS Kubernetes clusters can use configured account credentials directly through kubernetes.io/aws-account-id. The S3 URL reader also avoids assuming an account's already-assumed role a second time. Contributed in part by @hudsonb in #35963.added
  • Incremental ingestion tolerates repeated entity references within a page or event, avoiding PostgreSQL upsert failures. Catalog placeholder processing also waits for all reads to settle before reporting an error.added
  • PostgreSQL unique constraint violations are detected correctly when database error messages are localized, allowing catalog ingestion to fall back to individual updates for duplicate entity references. Contributed by @harshitsharmaaaa in #36921.added
  • PostgreSQL search indexing skips full-text vector computation for unchanged documents. Contributed by @Sriram-Nambiar in #36473.added
  • Search autocomplete with multiple selection no longer clears typed text after each keystroke. Contributed by @dfl-aeb in #35967.added
  • The World Clock home widget now uses Backstage UI. Contributed by @jzhn in #36781.added
  • CLI commands preserve their exit codes, and package startup supports repeated --import and --require flags. Flag support contributed by @dotboris in #36647.added
  • The CLI handles JavaScript ES modules in packages without a type field correctly. Contributed by @vibbix in #36604.added
  • Package scaffolding preserves existing CODEOWNERS content, reuses newer compatible dependency ranges, and fixes corrupted nested filenames on Windows. The Windows fix was contributed by @HLoc26 in #35242.added
  • New apps apply their selected light or dark theme before loading, avoiding an initial light background for dark themes. Contributed by @carlerikjohan in #36162.added
  • Event request validators receive parsed query parameters and can specify a response content type when rejecting a request. Contributed by @stanislav-c in #36488.added
  • Generated API reference pages no longer overwrite declarations whose names collide by case or declaration kind.added
  • ResolvePackagePath accepts file URL strings such as import.meta.url, and backend plugins resolve their database migrations relative to their own package without requiring package-name resolution.added
  • RegisterMswTestHooks also fails tests on unhandled requests when used with MSW 3.added
  • OpenAPI client and server generation commands exit with a non-zero status when generation fails, allowing CI to detect failures. Watch mode keeps watching after errors. Contributed by @aksharprabhudesai in #36854.added
  • The GitHub URL reader releases connections after failed requests with large error bodies, avoiding connection and memory leaks during outages. Contributed by @dddimcha in #36830.added
  • @backstage/cli-module-package-manager-yarn makes its Yarn dependencies optional peers to avoid an upstream installation failure. Until fixed upstream, users of pm verify-patches must add @yarnpkg/cli, @yarnpkg/core, and @yarnpkg/plugin-patch as root development dependencies, along with the resolution "@yarnpkg/core/got": "npm:^11.8.6".added
  • Use DialogApi.open with your own dialog presentation instead of show or showModal, and IconsApi.icon instead of getIcon. Upgrade @backstage/plugin-app alongside @backstage/frontend-plugin-api; the API references are now core.dialog.v2 and core.icons.v2.other
  • Replace imports from @backstage/frontend-plugin-api/alpha with imports from the main entry point. The /alpha entry point has been removed; its exports retain the same behavior and identity at their new location.other
  • Use IconElement instead of the removed IconComponent type. IconBundleBlueprint now requires elements such as icons: { user: <MyIcon /> } rather than components. For Material UI icons, use <MyIcon fontSize="inherit" />. Icons passed through convertLegacyAppOptions are converted automatically, and auth provider icons continue to accept components.other
  • Use prepareSpecializedApp(options).finalize() instead of createSpecializedApp. Apps with sign-in or asynchronous session preparation must render the bootstrap app and subscribe through onFinalized(). Use advanced.sessionState to reuse a finalized session, and ApiBlueprint extensions to register custom APIs.other
  • Custom navigation components now receive navItems instead of the flat items collection. Use navItems.rest(), item.href, and item.title, and render item.icon as a React element.other
  • Import AnalyticsImplementation, AnalyticsImplementationBlueprint, and AnalyticsImplementationFactory from @backstage/plugin-app-react, and ExtensionFactoryMiddleware from @backstage/frontend-app-api.other
  • Replace withApis with a function component using useApi. Use FrontendPlugin.pluginId, PageLayoutTab, and CreateFrontendPluginOptions instead of the removed id, PageTab, and PluginOptions aliases.other
  • Replace ExtensionAttachTo with Extension<unknown>['attachTo'], and ProgressProps with its existing shape, {}.other
  • AnyApiRef and AnyApiFactory are deprecated in favor of ApiRef and ApiFactory without type arguments. The deprecated aliases remain available for compatibility.other
62 lines13 security1 removed39 added9 othertyped from the source notes

Full release notes ↗ · all Backstage releases

written by claude-haiku-5-5, prompt 7cbe154, checked by publish rules

Report a mistake

context

Tools

Backstage

Other Backstage releases

How this was written

The change list is the project's own release notes, sorted into change types by fixed rules. The summary was written from the original by the model named above, checked by fixed publishing rules, and read by an editor after publication. See the methodology.

Back to the feed

Backstage v1.57.0 release notes | Platform Changelog