Commit Graph

75 Commits

Author SHA1 Message Date
Fredrik Adelöw d3b8c370e1 Update docs/tooling/cli/03-commands.md
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Fredrik Adelöw <freben@gmail.com>
2026-03-30 11:53:30 +02:00
Fredrik Adelöw 6cc48113fc remove some cli deprecation warnings
Signed-off-by: Fredrik Adelöw <freben@spotify.com>
2026-03-30 09:44:30 +02: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 35cd7a20b2 Fix typos in templates documentation
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-03-17 14:43:31 +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 22f101e208 Merge pull request #33368 from backstage/rugvip/add-frontend-dev-utils
frontend-dev-utils: add helper for plugin dev apps
2026-03-16 21:32:15 +01:00
David Festal c19c288541 review(cli): refine the bundle command output expectations
Signed-off-by: David Festal <dfestal@redhat.com>
Assisted-by: Cursor
2026-03-16 18:42:36 +01:00
David Festal 4074a227c2 fix(backend-dynamic-feature-service): improve package resolution for bundled dynamic plugins
Updated `resolvePackagePath` to correctly resolve `package.json` for dynamic plugins that bundle their own copy of `@backstage/backend-plugin-api`. This change ensures that the resolution works for both the host application and bundled dependencies, enhancing compatibility with plugins created using the `backstage-cli package bundle` command.

Signed-off-by: David Festal <dfestal@redhat.com>
Assisted-by: Cursor
2026-03-16 18:42:07 +01:00
David Festal 62d08492c7 feat(cli): contribute a bundle command for dynamic loading
for both frontend and backend plugins.

Signed-off-by: David Festal <dfestal@redhat.com>
Assisted-by: Cursor
2026-03-16 18:36:46 +01:00
Patrik Oldsberg 0b4ed8550d Document createDevApp pattern for frontend plugin development
Add documentation for the new `@backstage/frontend-dev-utils` package
across three docs pages: the frontend system building plugins guide,
the CLI build system reference, and the project structure overview.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Made-with: Cursor
2026-03-16 16:10:27 +01:00
Patrik Oldsberg ce676fea2f Merge pull request #32904 from backstage/rugvip/translation-export-import
cli: add translations export and import commands
2026-02-23 13:18:03 +01:00
Patrik Oldsberg 1dfc3436d9 cli: address review feedback from freben
Fix whitespace alignment in CLI command summary, improve export command
description to clarify it operates from an app context, and update the
corresponding docs section.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-23 01:05:15 +01:00
Patrik Oldsberg dd5f052017 cli: make messages/ part of the configurable --pattern flag
Moves the messages/ path segment from being hardcoded into the export
and import commands to being part of the pattern itself. The default
pattern is now messages/{id}.{lang}.json, giving full control over the
directory structure under the translations output directory.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-18 12:32:51 +01:00
Patrik Oldsberg a808c9ef3f cli: use PackageRoles for role detection and remove redundant import --pattern
Uses PackageRoles.getRoleInfo from cli-node to determine frontend packages
by platform instead of a hardcoded role list. Removes the --pattern option
from the import command since the pattern is always read from the manifest.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-18 12:22:26 +01:00
Patrik Oldsberg fd50cb3401 docs: add changeset and documentation for translations CLI commands
Adds a changeset for the new translations export/import CLI commands.
Updates the internationalization docs with the CLI-based workflow as
the recommended approach for managing translations, and adds the
commands to the CLI reference. Also adds the internationalization
page to the mkdocs navigation.

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-18 00:47:14 +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 a21f50fc57 docs: apply minor fixes from feedback
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2026-01-30 11:36:09 +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
Fredrik Adelöw 05fb5f23aa Merge pull request #32275 from meganide/feat/cli-pattern
feat: add --include and --output-file to backstage-cli-info
2026-01-20 15:34:30 +01:00
Renas 4399328c37 feat: replace --output-file with --format
Signed-off-by: Renas <renash@spotify.com>
2026-01-19 15:43:04 +01:00
Renas cc8e5f52b5 docs: update cli info docs
Signed-off-by: Renas <renash@spotify.com>
2026-01-19 15:43:04 +01:00
Andre Wanlin f1fe6fe90d Updated to use Node 24 and Debian Trixie
Signed-off-by: Andre Wanlin <awanlin@spotify.com>
2026-01-05 12:25:52 -06:00
Fredrik Adelöw 7076f21475 Merge pull request #31559 from TobZip/patch-1
Revise VS Code Jest setup and update paths
2025-12-13 19:46:07 +01:00
aramissennyeydd 0def824b4d remove --no-node-snapshots flag
Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>
2025-12-08 17:28:19 -05:00
Tobias Zipfel c49c5a3201 Revise VS Code Jest setup and update paths
Updated VS Code Jest configuration instructions and corrected the path for the backstage-cli program.

Signed-off-by: Tobias Zipfel <tobiz@axis.com>
2025-11-01 18:50:36 +01: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
Patrik Oldsberg d14ef24882 cli: add Backstage Yarn plugin support for templating
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-10-01 15:11:46 +02:00
Camila Belo 8a16781eba refactor: apply review suggestions
Signed-off-by: Camila Belo <camilaibs@gmail.com>
2025-09-26 12:16:32 +02:00
Camila Belo ab96bb770f feat: add package start entry dir option
Signed-off-by: Camila Belo <camilaibs@gmail.com>
2025-09-26 12:16:32 +02:00
Patrik Oldsberg fbb84fbc8c cli: add support for passing package paths to repo start
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-04-08 13:14:46 +02:00
Patrik Oldsberg fd4fddad77 cli: enable forwarding of backend flags for repo start
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-04-08 13:14:46 +02:00
Patrik Oldsberg b8a675df4b docs/tooling: add docs for new repo start command
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-04-08 13:14:45 +02:00
Paul Schultz 5b7067966c feat: set lint --max-warnings to -1
Signed-off-by: Paul Schultz <pschultz@pobox.com>
2025-03-04 09:50:10 -06:00
Andre Wanlin 3cf3634162 Small Corrections to the CLI Template Globals
Signed-off-by: Andre Wanlin <awanlin@spotify.com>
2025-02-13 08:24:38 -06:00
Patrik Oldsberg 712f96a86f Merge pull request #27934 from minkimcello/mk/cli-templates
Declarative CLI Templates
2025-02-11 14:47:55 +01:00
Patrik Oldsberg 40208a4bd6 docs/tooling/cli: review fixes
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-02-11 14:05:31 +01:00
Patrik Oldsberg 9b82dabd50 docs/tooling/cli: review fixes
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-02-11 13:23:22 +01:00
Patrik Oldsberg 9fd9004d0f cli/new: rename template.yaml -> portable-template.yaml
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-02-11 11:47:33 +01:00
Patrik Oldsberg 8ff50542cd cli/new: hardcode template file name and always point to dir
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-02-11 11:44:09 +01:00
Patrik Oldsberg 10c419cc0c cli/new: merge parameters and templateValues
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-02-11 11:26:32 +01:00
Patrik Oldsberg 82107cd9a5 cli/new: remove ability to load template contents from a separate dir
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-02-11 11:15:25 +01:00
Patrik Oldsberg 9385cdf77c docs/tooling: mention parameters field in templating docs
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-02-11 10:29:28 +01:00
Patrik Oldsberg b5f489aa79 docs/tooling: update cli templating docs to reflect new design
Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
2025-02-10 17:25:40 +01:00
Fredrik Adelöw 713c3b0d8a Merge pull request #28586 from gusega/patch-2
Update 02-build-system.md
2025-01-29 14:51:13 +01:00
Gasan 182120afd5 Update docs/tooling/cli/02-build-system.md
Co-authored-by: Fredrik Adelöw <freben@gmail.com>
Signed-off-by: Gasan <465806+gusega@users.noreply.github.com>
2025-01-28 16:16:05 +01:00
Gasan 7e61019465 Update docs/tooling/cli/02-build-system.md
Co-authored-by: Fredrik Adelöw <freben@gmail.com>
Signed-off-by: Gasan <465806+gusega@users.noreply.github.com>
2025-01-28 16:15:46 +01:00
Gasan Guseinov 87f2f3862c update doc
Signed-off-by: Gasan Guseinov <gasan.guseinov@ing.com>
2025-01-28 13:35:50 +01:00
Gasan f6c927fa7c Update docs/tooling/cli/02-build-system.md
Co-authored-by: Fredrik Adelöw <freben@gmail.com>
Signed-off-by: Gasan <465806+gusega@users.noreply.github.com>
2025-01-28 13:09:52 +01:00
Gasan 75defba1e8 Update 02-build-system.md
Signed-off-by: Gasan <465806+gusega@users.noreply.github.com>
2025-01-24 14:27:11 +01:00
Min Kim 9b06500d3f Apply feedback to documentation
Signed-off-by: Min Kim <minkimcello@gmail.com>
2025-01-23 22:35:21 -05:00