From d2091c6fe0ebc298f7afd6530c74354b15b73320 Mon Sep 17 00:00:00 2001 From: Patrik Oldsberg Date: Sun, 6 Apr 2025 12:35:48 +0200 Subject: [PATCH] changesets: add changeset for new repo start command Signed-off-by: Patrik Oldsberg --- .changeset/twelve-hornets-smell.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 .changeset/twelve-hornets-smell.md diff --git a/.changeset/twelve-hornets-smell.md b/.changeset/twelve-hornets-smell.md new file mode 100644 index 0000000000..a9845e2547 --- /dev/null +++ b/.changeset/twelve-hornets-smell.md @@ -0,0 +1,30 @@ +--- +'@backstage/cli': patch +--- + +Added a new `repo start` command to replace the existing pattern of using `yarn dev` scripts. The `repo start` command runs the app and/or backend package in the repo by default, but will also fall back to running other individual frontend or backend packages or even plugin dev entry points if the can be uniquely selected. + +The goal of this change is to reduce the number of different necessary scripts and align on `yarn start` being the only command needed for local development, similar to how `repo test` handles testing in the repo. It also opens up for more powerful options, like the `--plugin ` flag that runs the dev entry point of the selected plugin. + +The new script is installed as follows, replacing the existing `yarn start` script: + +```json +{ + "scripts": { + "start": "backstage-cli repo start" + } +} +``` + +In order to help users migrate in existing projects, it is recommended to add the following scripts to the root `package.json`: + +```json +{ + "scripts": { + "dev": "echo \"Use 'yarn start' instead\"", + "start-backend": "echo \"Use 'yarn start backend' instead\"" + } +} +``` + +For more information, run `yarn start --help` once the new command is installed.