91 Commits

Author SHA1 Message Date
Patrik Oldsberg b5032acd83 docs: remove legacy items input row from app nav table
The items input is internal backward compatibility, not public API.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-19 11:23:03 +02:00
Patrik Oldsberg 10e5d6f8aa Remove NavItemBlueprint in favor of page-based nav discovery
Drop the deprecated NavItemBlueprint from the public API and migrate core
plugins to set title and icon on PageBlueprint instead. AppNav keeps
backward compatibility for legacy nav-item extensions via an internal
core.nav-item.target data ref.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-19 11:00:46 +02:00
Ali c336308f65 docs: expand app-visualizer plugin documentation in migration guide
Add detailed usage documentation for the app-visualizer plugin in the
troubleshooting section of the migration guide. Includes installation
steps, descriptions of all three views (Tree, Detailed, Text), and
practical guidance for using the plugin during migration.

Closes #32715

Signed-off-by: Ali <ali@kscope.ai>
2026-04-13 04:58:47 +05:00
Patrik Oldsberg 4a01a66da3 docs: document app/routes redirect configuration
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-03-30 01:36:07 +02:00
Patrik Oldsberg 683e49ca32 Potential fix for pull request finding
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-03-17 19:41:44 +01:00
Patrik Oldsberg 08d9770715 cli: Rename frontend plugin templates and add auto-detection
Renamed the CLI templates for frontend plugins:
- new-frontend-plugin → frontend-plugin
- new-frontend-plugin-module → frontend-plugin-module
- frontend-plugin (legacy) → legacy-frontend-plugin

Added auto-detection logic that checks packages/app/package.json to
determine which frontend system the app uses. When using default
templates, only the appropriate frontend plugin template is shown:
- Apps with @backstage/frontend-defaults see the new system templates
- Apps with @backstage/app-defaults see the legacy template

Both templates display as "frontend-plugin" to users, so existing
workflows are preserved while automatically using the correct template.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-03-17 16:17:17 +01:00
Patrik Oldsberg a6735c33b1 create-app: Make new frontend system the default
The new frontend system is now the default template when creating a new
Backstage app. The previous `--next` flag has been replaced with a
`--legacy` flag that can be used to create an app using the old frontend
system instead.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-03-17 16:12:27 +01:00
Patrik Oldsberg 8e559b427d Merge pull request #33393 from backstage/rugvip/move-cli-new-templates
cli-module-new: move yarn new templates from @backstage/cli
2026-03-17 15:32:09 +01:00
Patrik Oldsberg ea90ab0590 Move yarn new templates from @backstage/cli to @backstage/cli-module-new
The built-in templates used by `yarn new` are moved from `packages/cli/templates/`
to `packages/cli-module-new/templates/`, colocating them with the code that
consumes them.

A backwards compatibility rewrite in the template resolution ensures that
existing `@backstage/cli/templates/*` references in root `package.json`
configurations continue to work by transparently resolving them to
`@backstage/cli-module-new/templates/*`.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-03-17 13:10:24 +01:00
Patrik Oldsberg 5fec07d083 docs: cover phased frontend app setup
This documents the new phased app preparation flow and conditional feature behavior in the frontend-system docs, and adds the missing changeset coverage for related published package changes.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-03-17 13:03:11 +01:00
Patrik Oldsberg 17dff0ba25 docs: rename package discovery to feature discovery and reduce duplication
Rename "package discovery" to "feature discovery" across all plugin
READMEs and docs to match the established terminology. Slim down the
Feature Discovery section in the architecture docs to avoid duplicating
the configuration details now covered in the installing plugins page.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-03-04 12:57:49 +01:00
Patrik Oldsberg 67723818b5 docs: improve cross-references for installing plugins page
Update the Building Apps overview to reference the new installing
plugins page instead of duplicating feature discovery content. Add
cross-references between the installing plugins page, the architecture
feature discovery docs, the plugin conversion page, and the extension
configuration page.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-03-04 12:14:48 +01:00
Patrik Oldsberg 5a463b320c docs: update frontend plugin docs to default to new frontend system
Restructure plugin documentation so that the new frontend system is
the default, unlabeled installation path. Old frontend system
instructions are moved to a dedicated "Old Frontend System" section.

Add a new "Installing Plugins" page to the frontend system docs
covering package discovery, manual installation, and configuration.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-03-04 11:24:35 +01:00
Patrik Oldsberg 5920062fcc app-react: API cleanup and component utility for nav items
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-02-17 11:55:34 +01:00
Patrik Oldsberg a2133bebd4 docs: document new nav content extensibility
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-02-17 11:55:31 +01:00
Patrik Oldsberg fdbd40488e module-federation-common: followup to initial implementation
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-02-13 13:47:35 +01:00
Patrik Oldsberg 903a854ebc Merge branch 'master' into runtime-module-federation-enablement
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-02-12 23:46:00 +01:00
Patrik Oldsberg 94e05532be Apply suggestions from code review
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-02-12 23:20:05 +01:00
aramissennyeydd efbf232bfa fix: update more /docs/references links
Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>
2026-02-04 10:11:36 -06:00
David Festal 00638e4145 Fix review comment on 07-module-federation.md
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: David Festal <dfestal@redhat.com>
2026-01-27 14:54:21 +01:00
David Festal 95693a951b Complete docs
Signed-off-by: David Festal <dfestal@redhat.com>
2026-01-27 14:54:20 +01:00
David Festal 86bb4321a9 Add and update documentation
Signed-off-by: David Festal <dfestal@redhat.com>
Assisted-by: Cursor
2026-01-27 14:54:19 +01:00
Patrik Oldsberg 872cecb902 docs: updates for app and plugin wrapper blueprint changes
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-01-16 17:08:55 +01:00
Patrik Oldsberg 9ccf84e219 frontend-plugin-api: move app blueprints to new app-react package
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-01-16 11:59:49 +01:00
Nguyễn Nhật Thành fc63723560 fix(frontend-system-doc): use PascalCase for SidebarContent in migration guide (#32228)
* fix(frontend-system-doc): update import statement for sidebar content in migration guide

Signed-off-by: Thanh Nguyen <thanh.nguyen35@mservice.com.vn>

* fix(frontend-system-doc): update capitalization for SidebarContent naming in migration guide

Signed-off-by: Thanh Nguyen <thanh.nguyen35@mservice.com.vn>

---------

Signed-off-by: Thanh Nguyen <thanh.nguyen35@mservice.com.vn>
Co-authored-by: Thanh Nguyen <thanh.nguyen35@mservice.com.vn>
2026-01-01 13:20:19 -07:00
Andre Wanlin be6b8aa2af docs - New Frontend System - Add missing --next flag (#32041)
Signed-off-by: Andre Wanlin <awanlin@spotify.com>
2025-12-05 20:42:16 -05:00
Patrik Oldsberg e5a1b33b0b docs/frontend-system: remove use of compatWrapper
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-11-23 13:04:53 +01:00
Patrik Oldsberg 83439b1539 core-plugin-api: add forwards compatibility for route refs
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-11-18 10:26:20 +01:00
Vincenzo Scamporlino 9c522d79bf Merge pull request #31449 from backstage/vinzscam-patch-2
Import Backstage UI CSS styles in index.ts
2025-10-21 21:35:25 +02:00
Vincenzo Scamporlino 713dcd21ff Add catalogPlugin to app features
Signed-off-by: Vincenzo Scamporlino <vincenzos@spotify.com>
2025-10-20 21:17:16 +02:00
Patrik Oldsberg fc7cbfced9 cli: add template for catalog provider
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-10-20 19:58:19 +02:00
Vincenzo Scamporlino cf56a5c357 Update comment for app configuration clarity
Signed-off-by: Vincenzo Scamporlino <vincenzos@spotify.com>
2025-10-16 20:43:45 +02:00
Vincenzo Scamporlino e2fc34c0e6 Clarify plugin installation in index.md
Updated comments to clarify plugin installation and features.

Signed-off-by: Vincenzo Scamporlino <vincenzos@spotify.com>
2025-10-16 20:42:54 +02:00
Vincenzo Scamporlino 9467690f40 Import Backstage UI CSS styles in index.ts
Added import statement for Backstage UI styles.

Signed-off-by: Vincenzo Scamporlino <vincenzos@spotify.com>
2025-10-16 20:23:29 +02:00
secustor cc1c6f98b6 docs: fix diff for building apps guide
Signed-off-by: secustor <sebastian@poxhofer.at>
2025-08-31 22:47:33 +02:00
Camila Belo 70f2331e2d docs: fix migrating app examples
Signed-off-by: Camila Belo <camilaibs@gmail.com>
2025-08-20 11:59:16 +02:00
benjdlambert 536b76f405 chore: clenaup docs again
Signed-off-by: benjdlambert <ben@blam.sh>
2025-08-19 14:15:06 +02:00
Camila Belo ac70f769e2 refactor: fix vale errors
Signed-off-by: Camila Belo <camilaibs@gmail.com>
2025-08-19 11:12:29 +02:00
Camila Belo 06a0db26ba refactor: apply review suggestions
Signed-off-by: Camila Belo <camilaibs@gmail.com>
2025-08-19 11:12:29 +02:00
Camila Belo 90541a8195 refactor: restructure the application migration guide
Signed-off-by: Camila Belo <camilaibs@gmail.com>
2025-08-19 11:12:25 +02:00
benjdlambert 400089ddc2 chore: small migration
Signed-off-by: benjdlambert <ben@blam.sh>
2025-08-19 10:53:18 +02:00
Camila Belo f83372b4c4 Merge pull request #30898 from backstage/rename-rename-connvert-legacy-app
[NFS] Rename convert legacy app helper
2025-08-19 09:45:43 +02:00
benjdlambert 0af3042e0e chore: rewrod
Signed-off-by: benjdlambert <ben@blam.sh>
2025-08-18 15:04:42 +02:00
benjdlambert d848226f63 chore: added some more help
Signed-off-by: benjdlambert <ben@blam.sh>
2025-08-18 15:01:40 +02:00
Ben Lambert 00423d7579 Apply suggestions from code review
Co-authored-by: Fredrik Adelöw <freben@gmail.com>
Signed-off-by: Ben Lambert <ben@blam.sh>
2025-08-18 13:29:30 +02:00
benjdlambert 194525a2a9 feat: updating the sidebar navigation docs
Signed-off-by: benjdlambert <ben@blam.sh>
2025-08-18 11:58:10 +02:00
Camila Belo 62c3628b27 refactor: rename convert legacy app helper
Signed-off-by: Camila Belo <camilaibs@gmail.com>
2025-08-15 14:40:11 +02:00
benjdlambert d274e0c90e feat: updating name for default swappable refs
Signed-off-by: benjdlambert <ben@blam.sh>
2025-08-11 13:41:27 +02:00
benjdlambert 0be714921d feat: added some docs around swappable
Signed-off-by: benjdlambert <ben@blam.sh>
2025-08-11 12:03:05 +02:00
Fredrik Adelöw 8b1bf6e069 elevate app.packages to no longer be experimental
Signed-off-by: Fredrik Adelöw <freben@gmail.com>
2025-08-07 17:02:05 +02:00