paulononato/backstage

Fork 0

Files

T

github-actions[bot] 68db890456 Version Packages (next)

2026-05-26 15:26:38 +00:00

301 KiB

Raw Blame History

@backstage/create-app

0.8.4-next.0

Patch Changes

Bumped create-app version.

0.8.3

Patch Changes

7295193: Bumped create-app version.
b0bc1e5: Bumped create-app version.
14e2056: Pinned the Jest version range in app templates to ~30.2.0 to prevent automatic upgrades to Jest 30.4.x, which requires Node.js v24.9+ and breaks tests on Node 22.
927c003: Replaced internal error utilities with shared ones from @backstage/cli-common.
Updated dependencies
- @backstage/cli-common@0.2.2

0.8.3-next.3

Patch Changes

14e2056: Pinned the Jest version range in app templates to ~30.2.0 to prevent automatic upgrades to Jest 30.4.x, which requires Node.js v24.9+ and breaks tests on Node 22.

0.8.3-next.2

Patch Changes

Bumped create-app version.

0.8.3-next.1

Patch Changes

Bumped create-app version.

0.8.3-next.0

Patch Changes

927c003: Replaced internal error utilities with shared ones from @backstage/cli-common.
Updated dependencies
- @backstage/cli-common@0.2.2-next.0

0.8.2

Patch Changes

a2cb332: Bumped create-app version.
6c10d88: Bumped create-app version.
e8ffac1: Various fixes for the create-app template: reorganizing sidebar items, removing redundant config and code, and adding a documentation example.
72a493a: Added the mcp-actions-backend and plugin-auth plugins
4cf9f3a: Removed the unnecessary @backstage/cli-module-new dependency from the next-app template, since it is already included through @backstage/cli-defaults.
2541837: Renamed the built-in template directories from next-app to default-app and default-app to legacy-app.
Updated dependencies
- @backstage/cli-common@0.2.1

0.8.2-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.2.1-next.1

0.8.2-next.1

Patch Changes

Bumped create-app version.

0.8.2-next.0

Patch Changes

e8ffac1: Various fixes for the create-app template: reorganizing sidebar items, removing redundant config and code, and adding a documentation example.
4cf9f3a: Removed the unnecessary @backstage/cli-module-new dependency from the next-app template, since it is already included through @backstage/cli-defaults.
Updated dependencies
- @backstage/cli-common@0.2.1-next.0

0.8.0

Minor Changes

a6735c3: BREAKING: 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.

Patch Changes

d806b0c: The create-app templates now include @backstage/cli-defaults as a devDependency, enabling the CLI's automatic module discovery for newly created projects.
d14b6e0: BREAKING: Migrated MembersListCard, OwnershipCard, and CatalogGraphCard to use BUI card primitives via EntityInfoCard.
- OwnershipCard: Removed variant and maxScrollHeight props. Card height and scrolling are now controlled by the parent container — the card fills its container and the body scrolls automatically when content overflows.
- CatalogGraphCard: Removed variant prop.
- MembersListCard: Translation keys subtitle, paginationLabel, aggregateMembersToggle.directMembers, aggregateMembersToggle.aggregatedMembers, and aggregateMembersToggle.ariaLabel have been removed. The title key now includes {{groupName}}. New keys added: cardLabel, noSearchResult, aggregateMembersToggle.label.
- OwnershipCard: Translation keys aggregateRelationsToggle.directRelations, aggregateRelationsToggle.aggregatedRelations, and aggregateRelationsToggle.ariaLabel have been removed. New key added: aggregateRelationsToggle.label.
- Removed MemberComponentClassKey export, and root and cardContent from MembersListCardClassKey, card from OwnershipCardClassKey, and card from CatalogGraphCardClassKey.
Migration:
```
- <EntityOwnershipCard variant="gridItem" />
+ <EntityOwnershipCard />
```
```
- <EntityCatalogGraphCard variant="gridItem" height={400} />
+ <EntityCatalogGraphCard height={400} />
```
70fc178: Migrated from deprecated findPaths to targetPaths and findOwnPaths from @backstage/cli-common.
ea90ab0: Updated the next-app template to reference @backstage/cli-module-new/templates/* instead of @backstage/cli/templates/* for the built-in yarn new templates.
de62a9d: Upgraded commander dependency from ^12.0.0 to ^14.0.3 across all CLI packages.
a9d23c4: Properly support package.json workspaces field
ebd4630: Replace deprecated workspaces.packages with workspaces in package.json

This change is not required, but you can edit your main package.json, to fit the more modern & more common pattern:
```
-  "workspaces": {
-    "packages": [
   "workspaces": [
     "packages/*",
     "plugins/*"
-     ]
-   },
  ],
```
Updated dependencies
- @backstage/cli-common@0.2.0

0.7.10-next.2

Patch Changes

d14b6e0: BREAKING: Migrated MembersListCard, OwnershipCard, and CatalogGraphCard to use BUI card primitives via EntityInfoCard.
- OwnershipCard: Removed variant and maxScrollHeight props. Card height and scrolling are now controlled by the parent container — the card fills its container and the body scrolls automatically when content overflows.
- CatalogGraphCard: Removed variant prop.
- MembersListCard: Translation keys subtitle, paginationLabel, aggregateMembersToggle.directMembers, aggregateMembersToggle.aggregatedMembers, and aggregateMembersToggle.ariaLabel have been removed. The title key now includes {{groupName}}. New keys added: cardLabel, noSearchResult, aggregateMembersToggle.label.
- OwnershipCard: Translation keys aggregateRelationsToggle.directRelations, aggregateRelationsToggle.aggregatedRelations, and aggregateRelationsToggle.ariaLabel have been removed. New key added: aggregateRelationsToggle.label.
- Removed MemberComponentClassKey export, and root and cardContent from MembersListCardClassKey, card from OwnershipCardClassKey, and card from CatalogGraphCardClassKey.
Migration:
```
- <EntityOwnershipCard variant="gridItem" />
+ <EntityOwnershipCard />
```
```
- <EntityCatalogGraphCard variant="gridItem" height={400} />
+ <EntityCatalogGraphCard height={400} />
```
Updated dependencies
- @backstage/cli-common@0.2.0-next.2

0.7.10-next.1

Patch Changes

a9d23c4: Properly support package.json workspaces field
ebd4630: Replace deprecated workspaces.packages with workspaces in package.json

This change is not required, but you can edit your main package.json, to fit the more modern & more common pattern:
```
-  "workspaces": {
-    "packages": [
   "workspaces": [
     "packages/*",
     "plugins/*"
-     ]
-   },
  ],
```
Updated dependencies
- @backstage/cli-common@0.2.0-next.1

0.7.10-next.0

Patch Changes

70fc178: Migrated from deprecated findPaths to targetPaths and findOwnPaths from @backstage/cli-common.
de62a9d: Upgraded commander dependency from ^12.0.0 to ^14.0.3 across all CLI packages.
Updated dependencies
- @backstage/cli-common@0.2.0-next.0

0.7.9

Patch Changes

40f2720: Updated to include the missing core plugins in the template used with the --next flag. Also updated react-router* versions and added Jest 30-related dependencies. Finally, moved the order of @playwright/test so it won't trigger a file change during the creation process.
1ea737c: Bumped create-app version.
7c41134: Bumped create-app version.
65ba820: Updated the app template sidebar to use the new NavContentBlueprint API for page-based navigation.
7455dae: Use node prefix on native imports
c38b74d: Switched next-app template to use blueprint from @backstage/plugin-app-react.
Updated dependencies
- @backstage/cli-common@0.1.18

0.7.9-next.2

Patch Changes

Bumped create-app version.

0.7.9-next.1

Patch Changes

Bumped create-app version.

0.7.9-next.0

Patch Changes

7455dae: Use node prefix on native imports
c38b74d: Switched next-app template to use blueprint from @backstage/plugin-app-react.
Updated dependencies
- @backstage/cli-common@0.1.18-next.0

0.7.8

Patch Changes

fea3e39: Bumped create-app version.
9f1ee3e: Bumped create-app version.
880310b: Bumped create-app version.
f1fe6fe: Updated Dockerfile to use Node 24 and Debian Trixie
Updated dependencies
- @backstage/cli-common@0.1.17

0.7.8-next.3

Patch Changes

Bumped create-app version.

0.7.8-next.2

Patch Changes

f1fe6fe: Updated Dockerfile to use Node 24 and Debian Trixie

0.7.8-next.1

Patch Changes

Bumped create-app version.

0.7.8-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.16

0.7.7

Patch Changes

336db00: Bumped create-app version.
2bae83a: Updated engines to support Node 22 or 24
c8c2329: Add proxy configuration from env-vars to create-app tasks
2bae83a: Bumped dev dependencies @types/node
Updated dependencies
- @backstage/cli-common@0.1.16

0.7.7-next.2

Patch Changes

2bae83a: Updated engines to support Node 22 or 24
2bae83a: Bumped dev dependencies @types/node
Updated dependencies
- @backstage/cli-common@0.1.16-next.2

0.7.7-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.16-next.1

0.7.7-next.0

Patch Changes

c8c2329: Add proxy configuration from env-vars to create-app tasks
Updated dependencies
- @backstage/cli-common@0.1.16-next.0

0.7.6

Patch Changes

2c1fe37: Bumped create-app version.
20fae88: Bumped create-app version.
9f939a6: Added @backstage/plugin-app-visualizer to the app in the --next template.
fc7cbfc: Added the new @backstage/cli/templates/catalog-provider-module template to the explicit template configuration for the next-app template.

0.7.6-next.3

Patch Changes

Bumped create-app version.

0.7.6-next.2

Patch Changes

9f939a6: Added @backstage/plugin-app-visualizer to the app in the --next template.

0.7.6-next.1

Patch Changes

Bumped create-app version.

0.7.6-next.0

Patch Changes

fc7cbfc: Added the new @backstage/cli/templates/catalog-provider-module template to the explicit template configuration for the next-app template.
Updated dependencies
- @backstage/cli-common@0.1.15

0.7.5

Patch Changes

c73bfa4: Bumped create-app version.
c2c6054: Bumped create-app version.
ffb5b44: Bumped create-app version.
316d077: Bumped create-app version.
7dcedff: Bump better-sqlite3 to the latest version

0.7.5-next.3

Patch Changes

Bumped create-app version.

0.7.5-next.2

Patch Changes

Bumped create-app version.

0.7.5-next.1

Patch Changes

Bumped create-app version.

0.7.5-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.7.4

Patch Changes

b2d9fc1: Creates a plugin that redirects from the Home page to the Catalog index page to avoid seeing a not found page error when starting the app.
020d484: Bumped create-app version.
02dbe8e: Add missing dependency to @backstage/cli, @backstage/core-plugin-api and @backstage/integration-react

0.7.4-next.2

Patch Changes

Bumped create-app version.

0.7.4-next.1

Patch Changes

02dbe8e: Add missing dependency to @backstage/cli, @backstage/core-plugin-api and @backstage/integration-react

0.7.4-next.0

Patch Changes

b2d9fc1: Creates a plugin that redirects from the Home page to the Catalog index page to avoid seeing a not found page error when starting the app.
Updated dependencies
- @backstage/cli-common@0.1.15

0.7.2

Patch Changes

d7a3d04: Created a flag for scaffolding apps using the new frontend system.
4704160: Bumped create-app version.
1e8a013: Bumped create-app version.
e33fce1: Added Notifications and Signals to be installed by default
8b1bf6e: Updated the app.packages config setting now that it no longer is experimental
2a156e0: Updated the better-sqlite dependency from v9.0.0 to v13.0.0. You can apply this change to your instance by applying the following change to your packages/backend/package.json and running yarn install.
```
  "dependencies": {
    "app": "link:../app",
-    "better-sqlite3": "^9.0.0",
+    "better-sqlite3": "^12.0.0",
    "node-gyp": "^10.0.0",
    "pg": "^8.11.3"
  }
```

0.7.2-next.3

Patch Changes

8b1bf6e: Updated the app.packages config setting now that it no longer is experimental

0.7.2-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.7.2-next.1

Patch Changes

d7a3d04: Created a flag for scaffolding apps using the new frontend system.
2a156e0: Updated the better-sqlite dependency from v9.0.0 to v13.0.0. You can apply this change to your instance by applying the following change to your packages/backend/package.json and running yarn install.
```
  "dependencies": {
    "app": "link:../app",
-    "better-sqlite3": "^9.0.0",
+    "better-sqlite3": "^12.0.0",
    "node-gyp": "^10.0.0",
    "pg": "^8.11.3"
  }
```
Updated dependencies
- @backstage/cli-common@0.1.15

0.7.2-next.0

Patch Changes

Bumped create-app version.

0.7.1

Patch Changes

952cefe: Bumped create-app version.
2339363: BREAKING: The experimental catalog.useUrlReadersSearch configuration flag (introduced in v1.36) has been removed.

The UrlReaderProcessor now always uses the search method of UrlReaders. Built-in UrlReaderService implementations have been updated accordingly. If you use custom UrlReaderService implementations, you need to adapt their search method to correctly handle both specific URLs and potential search patterns (see changes on built-in readers in the original PR).

Previous behavior was to call the search method only if the parsed Git URL's filename contained a wildcard and use readUrl otherwise. Each UrlReaderService must implement this logic in the search method instead.

This allows each UrlReaderService implementation to check whether it's a search URL (that contains a wildcard pattern) or not using logic that is specific to each provider.
c4a0830: Removed deprecated 'allowedHosts' field from GitHub Publish action input in default template files to fix validation errors with strict Zod validation.

0.7.1-next.2

Patch Changes

c4a0830: Removed deprecated 'allowedHosts' field from GitHub Publish action input in default template files to fix validation errors with strict Zod validation.

0.7.1-next.1

Patch Changes

Bumped create-app version.

0.7.1-next.0

Patch Changes

2339363: BREAKING: The experimental catalog.useUrlReadersSearch configuration flag (introduced in v1.36) has been removed.

The UrlReaderProcessor now always uses the search method of UrlReaders. Built-in UrlReaderService implementations have been updated accordingly. If you use custom UrlReaderService implementations, you need to adapt their search method to correctly handle both specific URLs and potential search patterns (see changes on built-in readers in the original PR).

Previous behavior was to call the search method only if the parsed Git URL's filename contained a wildcard and use readUrl otherwise. Each UrlReaderService must implement this logic in the search method instead.

This allows each UrlReaderService implementation to check whether it's a search URL (that contains a wildcard pattern) or not using logic that is specific to each provider.
Updated dependencies
- @backstage/cli-common@0.1.15

0.7.0

Minor Changes

30474c4: Add .cache directory to shipped gitignore.

Patch Changes

d57a6f7: Bumped create-app version.
f628f44: Bumped create-app version.
9c9faf2: Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.7.0-next.3

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.7.0-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.7.0-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.7.0-next.0

Minor Changes

30474c4: Add .cache directory to shipped gitignore.

0.6.2

Patch Changes

8448948: Removed lerna-debug.log* pattern from .gitignore as Lerna was removed from the package in version @backstage/create-app@0.5.19.
ce2cf32: Bumped create-app version.
125d096: Bumped create-app version.
1c0cb7b: Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.6.2-next.3

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.6.2-next.2

Patch Changes

8448948: Removed lerna-debug.log* pattern from .gitignore as Lerna was removed from the package in version @backstage/create-app@0.5.19.
Updated dependencies
- @backstage/cli-common@0.1.15

0.6.2-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.6.2-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.6.1

Patch Changes

5590536: Bumped create-app version.
2fc663a: Bumped create-app version.
edabbd6: Updated the root package.json in the template to use the new backstage-cli repo start command.

The yarn dev command is now redundant and has been removed from the template. We recommend existing projects to add these or similar scripts to help redirect users:
```
{
  "scripts": {
    "dev": "echo \"Use 'yarn start' instead\"",
    "start-backend": "echo \"Use 'yarn start backend' instead\""
  }
}
```
a47fd39: Removes instances of default React imports, a necessary update for the upcoming React 19 migration.

https://legacy.reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html
c761cf5: BREAKING The publish:github scaffolder action now defaults to initializing with a branch named "main" instead of "master" when creating new repositories.

If you or your organization have relied on all new github repositories having a default branch name of "master" you must set the defaultBranch: 'master' in your existing templates that feature the publish:github scaffolder action.

To keep using the name "master" for your new github repos, these are the required changes:
```
    - id: publish
      name: Publish
      action: publish:github
      input:
        allowedHosts: ['github.com']
        description: This is ${{ parameters.name }}
        repoUrl: ${{ parameters.repoUrl }}
+       defaultBranch: 'master'
```
Updated dependencies
- @backstage/cli-common@0.1.15

0.6.1-next.2

Patch Changes

edabbd6: Updated the root package.json in the template to use the new backstage-cli repo start command.

The yarn dev command is now redundant and has been removed from the template. We recommend existing projects to add these or similar scripts to help redirect users:
```
{
  "scripts": {
    "dev": "echo \"Use 'yarn start' instead\"",
    "start-backend": "echo \"Use 'yarn start backend' instead\""
  }
}
```
a47fd39: Removes instances of default React imports, a necessary update for the upcoming React 19 migration.

https://legacy.reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html
Updated dependencies
- @backstage/cli-common@0.1.15

0.6.1-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.6.1-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.6.0

Minor Changes

31731b0: Upgraded the TypeScript version in the template to 5.8.

Patch Changes

7d083ce: Canon is now ready to be used in Alpha. We are adding a custom CSS file at the root of the app to make all styles available for Canon components.
aed536a: Bumped create-app version.
f9fb465: Bumped create-app version.
19e5c3f: Added link to multi-stage Dockerfile documentation as alternative option
Updated dependencies
- @backstage/cli-common@0.1.15

0.6.0-next.2

Minor Changes

31731b0: Upgraded the TypeScript version in the template to 5.8.

Patch Changes

19e5c3f: Added link to multi-stage Dockerfile documentation as alternative option
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.26-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.26-next.0

Patch Changes

Bumped create-app version.

0.5.25

Patch Changes

132173b: Bumped create-app version.
84fdc40: Bumped create-app version.
5aa499b: Bumped create-app version.
bfa4ea9: Enable catalog.useUrlReadersSearch configuration by default in newly created Backstage installations.

This parameter makes UrlReaderProcessor always use the search method. New adopters are encouraged to enable it as this behavior will be the default in a future release.
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.25-next.3

Patch Changes

bfa4ea9: Enable catalog.useUrlReadersSearch configuration by default in newly created Backstage installations.

This parameter makes UrlReaderProcessor always use the search method. New adopters are encouraged to enable it as this behavior will be the default in a future release.
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.25-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.25-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.25-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.24

Patch Changes

2e3fbc1: Bumped create-app version.
0980e40: Bumped create-app version.
828c993: Added --jobs unlimited to dev script to help cases where the backend does not start up during local development
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.24-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.24-next.1

Patch Changes

828c993: Added -j 2 to dev script to help cases where the backend does not start up during local development

0.5.24-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.23

Patch Changes

5819f8d: Updated Dockerfile to include backstage.json file
583f3d4: Updated the template to use @backstage/cli/config/prettier instead of @spotify/prettier-config.
e913fdf: Add github backend module to create-app and improve error messages
5c9cc05: Use native fetch instead of node-fetch
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.23-next.2

Patch Changes

e913fdf: Add github backend module to create-app and improve error messages
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.23-next.1

Patch Changes

5c9cc05: Use native fetch instead of node-fetch
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.23-next.0

Patch Changes

5819f8d: Updated Dockerfile to include backstage.json file
583f3d4: Updated the template to use @backstage/cli/config/prettier instead of @spotify/prettier-config.
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.22

Patch Changes

7907e3b: Bumped create-app version.
42386c2: Bumped create-app version.
702f41d: Updated engines to support Node 20 or 22
a917f86: This update adds the @backstage/repo-tools package to the versions.ts file, enabling proper version resolution for templates. The {{version '@backstage/repo-tools'}} placeholder now works as expected in the create-app process.
5872964: Use the main entrypoint for create-app installs
702f41d: Bumped dev dependencies @types/node
Updated dependencies
- @backstage/cli-common@0.1.15

0.5.22-next.3

Patch Changes

5872964: Use the main entrypoint for create-app installs
Updated dependencies
- @backstage/cli-common@0.1.15-next.0

0.5.22-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.15-next.0

0.5.22-next.1

Patch Changes

702f41d: Updated engines to support Node 20 or 22
702f41d: Bumped dev dependencies @types/node
Updated dependencies
- @backstage/cli-common@0.1.15-next.0

0.5.22-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.21

Patch Changes

c42c710: Bumped create-app version.
56a8118: Bumped create-app version.
a7674d6: Fixed lack of .yarnrc.yml in the template.
ab89e45: Remove some dependencies that aren't required anymore
b452088: Tweak Dockerfile to fix deprecated syntax.
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.21-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.21-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.21-next.0

Patch Changes

a7674d6: Fixed lack of .yarnrc.yml in the template.
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.19

Patch Changes

d2d2313: Add config.d.ts files to the list of included file in tsconfig.json.

This allows ESLint to detect issues or deprecations in those files.
4975e63: Yarn 4 is now the default for create-app. Also updated yarn dev script to use yarn workspaces foreach and removed unused Lerna and Concurrently dependencies.
4735881: Bumped create-app version.
97422b0: Update templates to not refer to backend-common
019d9ad: Minor dockerfile syntax update
e03acd8: Updated Dockerfile base image to node:20-bookworm-slim from node:18-bookworm-slim
bf370c2: Remove references to the @backstage/backend-tasks in versions of the create-app package, as it has been deprecated.
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.19-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.19-next.1

Patch Changes

d2d2313: Add config.d.ts files to the list of included file in tsconfig.json.

This allows ESLint to detect issues or deprecations in those files.
97422b0: Update templates to not refer to backend-common
bf370c2: Remove references to the @backstage/backend-tasks in versions of the create-app package, as it has been deprecated.
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.19-next.0

Patch Changes

019d9ad: Minor dockerfile syntax update
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.18

Patch Changes

c0a705d: Added the Kubernetes plugin to create-app
d7a0aa3: Bumped create-app version.
93095ee: Make sure node-fetch is version 2.7.0 or greater
6c1081c: Updated dockerfile and app-config.production.yaml to make it easier to get started with example data
bfeba46: Included permission config and enabled it out of the box
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.18-next.4

Patch Changes

bfeba46: Included permission config and enabled it out of the box
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.18-next.3

Patch Changes

93095ee: Make sure node-fetch is version 2.7.0 or greater
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.18-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.18-next.1

Patch Changes

6c1081c: Updated dockerfile and app-config.production.yaml to make it easier to get started with example data
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.18-next.0

Patch Changes

c0a705d: Added the Kubernetes plugin to create-app
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.17

Patch Changes

780d994: Added MyGroupsSidebarItem to the sidebar in the create-app template
f03d12a: Bumped create-app version.
e90a2cd: Added the Catalog logs module to the create-app template
3ac2a6a: Added the Postgres Search Engine to the create-app template
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.17-next.2

Patch Changes

e90a2cd: Added the Catalog logs module to the create-app template

0.5.17-next.1

Patch Changes

780d994: Added MyGroupsSidebarItem to the sidebar in the create-app template
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.17-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.16

Patch Changes

cce0495: Bumped create-app version.
77da22e: Bumped create-app version.
2110d76: Removed dockerode dependency.
34daaea: Fixed a broken link to the node-postgres documentation
78363f6: Bumped TypeScript to version 5.4.
1a212f9: Remove Tech Radar menu item from sidebar of scaffolded app to align with removal of tech-radar plugin from backend
81507c8: Updated node-gyp to v10
Updated dependencies
- @backstage/cli-common@0.1.14

0.5.16-next.3

Patch Changes

34daaea: Fixed a broken link to the node-postgres documentation
1a212f9: Remove Tech Radar menu item from sidebar of scaffolded app to align with removal of tech-radar plugin from backend
Updated dependencies
- @backstage/cli-common@0.1.14-next.0

0.5.16-next.2

Patch Changes

78363f6: Bumped TypeScript to version 5.4.
81507c8: Updated node-gyp to v10
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.16-next.1

Patch Changes

Bumped create-app version.

0.5.16-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.15

Patch Changes

c066c88: Removed packages/backend/src/types.ts from the template as it is unused. It was mistakenly left in after moving the template to the new backend system.
5d99272: Update local development dependencies.
0478509: Bumped create-app version.
d85dd88: Bumped create-app version.
8105aad: Removed the Tech Radar and GitHub Actions plugins from the template, which have been moved to the community plugins repository.

0.5.15-next.2

Patch Changes

Bumped create-app version.

0.5.15-next.1

Patch Changes

Bumped create-app version.

0.5.15-next.0

Patch Changes

c066c88: Removed packages/backend/src/types.ts from the template as it is unused. It was mistakenly left in after moving the template to the new backend system.
5d99272: Update local development dependencies.
8105aad: Removed the Tech Radar and GitHub Actions plugins from the template, which have been moved to the community plugins repository.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.14

Patch Changes

366cf07: Bumped create-app version.
036b9b3: Bumped create-app version.
2e1218c: Fix docs reference
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.14-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.14-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.13

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.12

Patch Changes

4cca80f: Bumped create-app version.
8db51ca: Bumped create-app version.
778bc48: Bumped create-app version.
1bd4596: Removed the ts-node dev dependency.
829a249: Migrated the backend of the create app template to use the new backend system. For information on how to migrate your existing backend, see the migration guide.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.12-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.12-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.12-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.11

Patch Changes

c70c3dc: Bumped create-app version.
c420081: Add a seed file for yarn.lock in newly created apps. This file is downloaded directly from https://github.com/backstage/backstage at the time of creating a new project, ensuring that users always receive the latest version. The purpose of the seed file is to initialize the lock file with known good versions of individual dependencies that have had bad new releases published. The seed file will have no effect if the dependency is not present, it can not be used to install additional packages.
f71352c: Bumped TypeScript to version 5.3.
03e55b1: Updated the default app index template at packages/app/public/index.html to have a fallback value for the app.title config.
6bb6f3e: Updated dependency fs-extra to ^11.2.0. Updated dependency @types/fs-extra to ^11.0.0.
6ba64c4: Updated dependency commander to ^12.0.0.
aeec29c: Updated packages/app as well as the root package.json type resolutions to use React v18.

The @testing-library/* dependencies have also been updated to the ones compatible with React v18, and the test at packages/app/src/App.test.tsx had been updated to use more modern patterns that work better with these new versions.

For information on how to migrate existing apps to React v18, see the migration guide
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.11-next.3

Patch Changes

03e55b1: Updated the default app index template at packages/app/public/index.html to have a fallback value for the app.title config.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.11-next.2

Patch Changes

c420081: Add a seed file for yarn.lock in newly created apps. This file is downloaded directly from https://github.com/backstage/backstage at the time of creating a new project, ensuring that users always receive the latest version. The purpose of the seed file is to initialize the lock file with known good versions of individual dependencies that have had bad new releases published. The seed file will have no effect if the dependency is not present, it can not be used to install additional packages.
f71352c: Bumped TypeScript to version 5.3.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.11-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.11-next.0

Patch Changes

aeec29c: Updated packages/app as well as the root package.json type resolutions to use React v18.

The @testing-library/* dependencies have also been updated to the ones compatible with React v18, and the test at packages/app/src/App.test.tsx had been updated to use more modern patterns that work better with these new versions.

For information on how to migrate existing apps to React v18, see the migration guide
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.9

Patch Changes

c9f71fb: Bumped create-app version.
ac277f3: Bumped create-app version.
7acbb5a: Removed mock-fs dev dependency.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.9-next.2

Patch Changes

Bumped create-app version.

0.5.9-next.1

Patch Changes

7acbb5a: Removed mock-fs dev dependency.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.9-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.8

Patch Changes

8ece804: Bumped create-app version.
0351e09: Bumped create-app version.
3f1192f: Bumped create-app version.
a96c2d4: Include the <EntityLinksCard /> for group entities by default
375b6f7: CircelCI plugin moved permanently
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.8-next.4

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.8-next.3

Patch Changes

a96c2d4: Include the <EntityLinksCard /> for group entities by default
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.8-next.2

Patch Changes

375b6f7d68: CircelCI plugin moved permanently
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.8-next.1

Patch Changes

Bumped create-app version.

0.5.8-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.7

Patch Changes

770763487a: Cleaned up cases where deprecated code was being used but had a new location they should be imported from
013611b42e: knex has been bumped to major version 3 and better-sqlite3 to major version 9, which deprecate node 16 support.

You can do the same in your own Backstage repository to ensure that you get future node 18+ relevant updates, by having the following lines in your packages/backend/package.json:
```
"dependencies": {
  // ...
  "knex": "^3.0.0"
},
"devDependencies": {
  // ...
  "better-sqlite3": "^9.0.0",
```
f577e1176f: Bumped create-app version.
6c2b872153: Add official support for React 18.
ae1602e54d: If create app installs dependencies, don't suggest to user that they also need to do it.
e6b7ab8d2b: Added missing node-gyp dependency to fix Docker image build
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.7-next.2

Patch Changes

#20771 770763487a Thanks @awanlin! - Cleaned up cases where deprecated code was being used but had a new location they should be imported from
#20570 013611b42e Thanks @freben! - knex has been bumped to major version 3 and better-sqlite3 to major version 9, which deprecate node 16 support.

You can do the same in your own Backstage repository to ensure that you get future node 18+ relevant updates, by having the following lines in your packages/backend/package.json:
```
"dependencies": {
  // ...
  "knex": "^3.0.0"
},
"devDependencies": {
  // ...
  "better-sqlite3": "^9.0.0",
```
#20695 e6b7ab8d2b Thanks @fjudith! - Added missing node-gyp dependency to fix Docker image build

0.5.7-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.7-next.0

Patch Changes

6c2b872153: Add official support for React 18.
ae1602e54d: If create app installs dependencies, don't suggest to user that they also need to do it.
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.6

Patch Changes

ba6a3b59c1: Removed duplicate apple-touch-icon link from packages/app/public/index.html that linked to nonexistent icon.
c8ec0dea4a: Create unique temp directory for each create-app execution.
e43d3eb1b7: Bumped create-app version.
b665f2ce65: Change base node image from node:18-bullseye-slim to node:18-bookworm-slim due to Docker build error on bullseye.

You can apply these change to your own Dockerfile by replacing node:18-bullseye-slim with node:18-bookworm-slim
deed089a3d: Bump cypress to fix the end-to-end tests
de42eebaaf: Bumped dev dependencies @types/node and mock-fs.
04a3f65e15: Bump Docker base images to node:18-bookworm-slim to fix node compatibility issues raised during image build.

You can apply these change to your own Dockerfile by replacing node:16-bullseye-slim with node:18-bookworm-slim
9864f263ba: Bump dev dependencies lerna@7.3.0 on the template
5eacd5d213: The E2E test setup based on Cypress has been replaced with one based on Playwright. Migrating existing apps is not required as this is a standalone setup, only do so if you also want to switch from Cypress to Playwright.

The scripts to run the E2E tests have been removed from packages/app/package.json, as they are now instead run from the root. Instead, a new script has been added to the root package.json, yarn test:e2e, which runs the E2E tests in development mode, unless CI is set in the environment.

The Playwright setup uses utilities from the new @backstage/e2e-test-utils package to find and include all packages in the monorepo that have an e2e-tests folder.
8d2e640af4: Added missing .eslintignore file

To apply this change to an existing app, create a new .eslintignore file at the root of your project with the following content:
```
+ playwright.config.ts
```
Updated dependencies
- @backstage/cli-common@0.1.13

0.5.6-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.13-next.0

0.5.6-next.1

Patch Changes

8d2e640af4: Added missing .eslintignore file

To apply this change to an existing app, create a new .eslintignore file at the root of your project with the following content:
```
+ playwright.config.ts
```
Updated dependencies
- @backstage/cli-common@0.1.13-next.0

0.5.6-next.0

Patch Changes

ba6a3b59c1: Removed duplicate apple-touch-icon link from packages/app/public/index.html that linked to nonexistent icon.
c8ec0dea4a: Create unique temp directory for each create-app execution.
b665f2ce65: Change base node image from node:18-bullseye-slim to node:18-bookworm-slim due to Docker build error on bullseye.

You can apply these change to your own Dockerfile by replacing node:18-bullseye-slim with node:18-bookworm-slim
deed089a3d: Bump cypress to fix the end-to-end tests
de42eebaaf: Bumped dev dependencies @types/node and mock-fs.
04a3f65e15: Bump Docker base images to node:18-bookworm-slim to fix node compatibility issues raised during image build.

You can apply these change to your own Dockerfile by replacing node:16-bullseye-slim with node:18-bookworm-slim
5eacd5d213: The E2E test setup based on Cypress has been replaced with one based on Playwright. Migrating existing apps is not required as this is a standalone setup, only do so if you also want to switch from Cypress to Playwright.

The scripts to run the E2E tests have been removed from packages/app/package.json, as they are now instead run from the root. Instead, a new script has been added to the root package.json, yarn test:e2e, which runs the E2E tests in development mode, unless CI is set in the environment.

The Playwright setup uses utilities from the new @backstage/e2e-test-utils package to find and include all packages in the monorepo that have an e2e-tests folder.
Updated dependencies
- @backstage/cli-common@0.1.13-next.0

0.5.5

Patch Changes

05508a9757: Updated the backend template to no longer create duplicate connection pools to plugins that use the task scheduler.

To apply this change in your own repository, perform the following small update:
```
// in packages/backend/src/index.ts
-  const taskScheduler = TaskScheduler.fromConfig(config);
+  const taskScheduler = TaskScheduler.fromConfig(config, { databaseManager });
```
a4c08241ad: Switched the template to use TypeScript 5.2 by default.
f8c8e8de37: Bumped create-app version.
fc1a38bc57: Bumped create-app version.

4606e005df: Added a fix scripts that calls the new backstage-cli repo fix command.

To apply this change to an existing app, make the following change to your root package.json:

     "test": "backstage-cli repo test",
     "test:all": "backstage-cli repo test --coverage",
+    "fix": "backstage-cli repo fix",
     "lint": "backstage-cli repo lint --since origin/master",

6125940222: Add a notification when yarn install is taking a long time.
8db70ecbb3: Updated Dockerfile to include apt-get update when installing the SQLite dependency
8cec7664e1: Removed @types/node dependency
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.5-next.3

Patch Changes

4606e005df: Added a fix scripts that calls the new backstage-cli repo fix command.

To apply this change to an existing app, make the following change to your root package.json:

     "test": "backstage-cli repo test",
     "test:all": "backstage-cli repo test --coverage",
+    "fix": "backstage-cli repo fix",
     "lint": "backstage-cli repo lint --since origin/master",

6125940222: Add a notification when yarn install is taking a long time.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.5-next.2

Patch Changes

8db70ecbb3: Updated Dockerfile to include apt-get update when installing the SQLite dependency
8cec7664e1: Removed @types/node dependency
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.5-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.5-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.4

Patch Changes

b441642fbe: Bumped create-app version.
572abc7edf: Bumped create-app version.
74f77f151a: Bumped create-app version.
5cc0ac5ef3: Bump to a newer version of the concurrently library
46c9a798e4: Updated the app-config.yaml template to use proxy.endpoints.
971bdd6a47: Bumped internal nodemon dependency.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.4-next.2

Patch Changes

Bumped create-app version.

0.5.4-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.4-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.3

Patch Changes

76b83a4422: Post-create message - added instruction to run yarn install when app was created with --skip-install
d72e2eeba6: Bumped create-app version.
e3ce5dd3f8: add cy.**.should to cypress eslintrc
f920a61031: Enable specifying an external application template when using the create-app CLI command.
294b1629de: Display a warning alert if relations are defined, which don't exist in the catalog.
4f7292c74d: Updated included Dockerfile to include g++. Also updated the comments to note that some of the dependencies are also needed by isolated-vm
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.3-next.2

Patch Changes

4f7292c74d: Updated included Dockerfile to include g++. Also updated the comments to note that some of the dependencies are also needed by isolated-vm
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.3-next.1

Patch Changes

76b83a4422: Post-create message - added instruction to run yarn install when app was created with --skip-install
e3ce5dd3f8: add cy.**.should to cypress eslintrc
294b1629de: Display a warning alert if relations are defined, which don't exist in the catalog.

0.5.3-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.2

Patch Changes

08f177b910: Add link from Template entity to the scaffolder launch page for the template in the AboutCard.
75a1c93784: Bumped create-app version.
e37573d60e: Bumped create-app version.
320ed50274: Bumped create-app version.
52d5998176: Changed the default backend CacheClient to an in-memory cache when not explicitly configured.

Explicit configuration of an in-memory cache can be removed from app-config.yaml, as this is now the default:
```
backend:
-  cache:
-    store: memory
```
68a21956ef: Remove reference to deprecated import
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.2-next.3

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.2-next.2

Patch Changes

Bumped create-app version.

0.5.2-next.1

Patch Changes

08f177b910: Add link from Template entity to the scaffolder launch page for the template in the AboutCard.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.2-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.1

Patch Changes

1d5e42655c: Correct command to create new plugins
e04bb20bdc: Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.1-next.2

Patch Changes

1d5e42655c: Correct command to create new plugins

0.5.1-next.1

Patch Changes

4027aa9e75: Pin some octokit dependencies to avoid failing typescript build under tsc:full

0.5.1-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.12

0.5.0

Minor Changes

10744537bf: Renamed permissionApi to permissions when passed as dependency of the scaffolder-backend plugin

Patch Changes

5af2c4f412: Bumped create-app version.
ab75a16da7: Bumped create-app version.
71fd0966d1: Add permissionApi as dependency of the scaffolder-backend plugin
2945923b13: Upgraded the TypeScript version to 5.0

To apply this change in your own project, switch the TypeScript version in your root package.json:
```
-    "typescript": "~4.6.4",
+    "typescript": "~5.0.0",
```
e0c6e8b9c3: Update peer dependencies
Updated dependencies
- @backstage/cli-common@0.1.12

0.4.39-next.3

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.12

0.4.39-next.2

Patch Changes

2945923b13: Upgraded the TypeScript version to 5.0

To apply this change in your own project, switch the TypeScript version in your root package.json:
```
-    "typescript": "~4.6.4",
+    "typescript": "~5.0.0",
```
Updated dependencies
- @backstage/cli-common@0.1.12

0.4.39-next.1

Patch Changes

71fd0966d1: Add permissionApi as dependency of the scaffolder-backend plugin
e0c6e8b9c3: Update peer dependencies
Updated dependencies
- @backstage/cli-common@0.1.12

0.4.39-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.12

0.4.38

Patch Changes

b4627f23b2: Bumped create-app version.
0eceadb950: Bumped create-app version.
482dae5de1: Updated link to docs.
6ace2dd2c5: Added to the template packages/app/.eslintignore file to packages to ignore the contents of packages/app/public.
Updated dependencies
- @backstage/cli-common@0.1.12

0.4.38-next.2

Patch Changes

Bumped create-app version.

0.4.38-next.1

Patch Changes

482dae5de1: Updated link to docs.
Updated dependencies
- @backstage/cli-common@0.1.12-next.0

0.4.38-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.11

0.4.37

Patch Changes

12a7b316ee: Bumped create-app version.
86a8dfd7b0: Added a check to ensure that Yarn v1 is used when creating new projects.
0eaa579f89: Update SearchPage template to use SearchResult extensions.
02f1316e57: Updated packages/app/cypress/.eslintrc.json to remove the unnecessary import/no-extraneous-dependencies rule.
Updated dependencies
- @backstage/cli-common@0.1.11

0.4.37-next.2

Patch Changes

02f1316e57: Updated packages/app/cypress/.eslintrc.json to remove the unnecessary import/no-extraneous-dependencies rule.
Updated dependencies
- @backstage/cli-common@0.1.11

0.4.37-next.1

Patch Changes

86a8dfd7b0: Added a check to ensure that Yarn v1 is used when creating new projects.
0eaa579f89: Update SearchPage template to use SearchResult extensions.
Updated dependencies
- @backstage/cli-common@0.1.11

0.4.37-next.0

Patch Changes

Bumped create-app version.

0.4.36

Patch Changes

f834622f56: Bumped create-app version.
724b55689b: Avoid potential temporary directory conflict.
a2a70504e3: Remove deprecated create-plugin script from the default-app template's package.json.hbs. Also, update the documentation to not mention the create-plugin script and instead mention the new script.
016a52c28f: Bumped the minimum version of better-sqlite3. You can make the following change to your packages/backend/package.json to keep your instance of Backstage updated.
```
- "better-sqlite3": "^7.5.0",
+ "better-sqlite3": "^8.0.0",
```
Updated dependencies
- @backstage/cli-common@0.1.11

0.4.36-next.2

Patch Changes

016a52c28f: Bumped the minimum version of better-sqlite3. You can make the following change to your packages/backend/package.json to keep your instance of Backstage updated.
```
- "better-sqlite3": "^7.5.0",
+ "better-sqlite3": "^8.0.0",
```
Updated dependencies
- @backstage/cli-common@0.1.11

0.4.36-next.1

Patch Changes

724b55689b: Avoid potential temporary directory conflict.
a2a70504e3: Remove deprecated create-plugin script from the default-app template's package.json.hbs. Also, update the documentation to not mention the create-plugin script and instead mention the new script.
Updated dependencies
- @backstage/cli-common@0.1.11

0.4.36-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.11

0.4.35

Patch Changes

c4788dbb58: Fix dependency ordering in templated packages.
83d3167594: Bumped create-app version.
2cb6963f9b: Bumped create-app version.
6465ab3686: Bumped create-app version.
af1358bb07: added default project name for CI job compatibility
935b66a646: Change step output template examples to use square bracket syntax.
dfb269fab2: Updated the template to have the '/test' proxy endpoint in app-config.yaml be commented out by default.

d9b3753f87: Updated the app template to use the new AppRouter component instead of app.getRouter(), as well as app.createRoot() instead of app.getProvider().

To apply this change to an existing app, make the following change to packages/app/src/App.tsx:

-import { FlatRoutes } from '@backstage/core-app-api';
+import { AppRouter, FlatRoutes } from '@backstage/core-app-api';

 ...

-const AppProvider = app.getProvider();
-const AppRouter = app.getRouter();

 ...

-const App = () => (
+export default app.createRoot(
-  <AppProvider>
+  <>
     <AlertDisplay />
     <OAuthRequestDialog />
     <AppRouter>
       <Root>{routes}</Root>
     </AppRouter>
-  </AppProvider>
+  </>,
 );

The final export step should end up looking something like this:

export default app.createRoot(
  <>
    <AlertDisplay />
    <OAuthRequestDialog />
    <AppRouter>
      <Root>{routes}</Root>
    </AppRouter>
  </>,
);

Note that app.createRoot() accepts a React element, rather than a component.

71e75c0b70: Removed the react-router dependency from the app package, using only react-router-dom instead.

This change is just a bit of cleanup and is optional. If you want to apply it to your app, remove the react-router dependency from packages/app/package.json, and replace any imports from react-router with react-router-dom instead.
Updated dependencies
- @backstage/cli-common@0.1.11

0.4.35-next.4

Patch Changes

935b66a646: Change step output template examples to use square bracket syntax.
dfb269fab2: Updated the template to have the '/test' proxy endpoint in app-config.yaml be commented out by default.

d9b3753f87: Updated the app template to use the new AppRouter component instead of app.getRouter(), as well as app.createRoot() instead of app.getProvider().

To apply this change to an existing app, make the following change to packages/app/src/App.tsx:

-import { FlatRoutes } from '@backstage/core-app-api';
+import { AppRouter, FlatRoutes } from '@backstage/core-app-api';

 ...

-const AppProvider = app.getProvider();
-const AppRouter = app.getRouter();

 ...

-const App = () => (
+export default app.createRoot(
-  <AppProvider>
+  <>
     <AlertDisplay />
     <OAuthRequestDialog />
     <AppRouter>
       <Root>{routes}</Root>
     </AppRouter>
-  </AppProvider>
+  </>,
 );

The final export step should end up looking something like this:

export default app.createRoot(
  <>
    <AlertDisplay />
    <OAuthRequestDialog />
    <AppRouter>
      <Root>{routes}</Root>
    </AppRouter>
  </>,
);

Note that app.createRoot() accepts a React element, rather than a component.

71e75c0b70: Removed the react-router dependency from the app package, using only react-router-dom instead.

This change is just a bit of cleanup and is optional. If you want to apply it to your app, remove the react-router dependency from packages/app/package.json, and replace any imports from react-router with react-router-dom instead.
Updated dependencies
- @backstage/cli-common@0.1.11-next.0

0.4.35-next.3

Patch Changes

c4788dbb58: Fix dependency ordering in templated packages.
af1358bb07: added default project name for CI job compatibility
Updated dependencies
- @backstage/cli-common@0.1.11-next.0

0.4.35-next.2

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.11-next.0

0.4.35-next.1

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.10

0.4.35-next.0

Patch Changes

Bumped create-app version.
Updated dependencies
- @backstage/cli-common@0.1.10

0.4.34

Patch Changes

f1c3cdfb2d: Bumped create-app version.

df21bbd4ad: The Analytics API is the recommended way to track usage in Backstage; an optionally installable Google Analytics module has superseded the old app.googleAnalyticsTrackingId config and its corresponding script tags in packages/app/public/index.html.

For an existing installation where you want to remove the redundant app.googleAnalyticsTrackingId, you should make the following adjustment to packages/app/public/index.html:

    <title><%= config.getString('app.title') %></title>
-   <% if (config.has('app.googleAnalyticsTrackingId')) { %>
-   <script
-       async
-       src="https://www.googletagmanager.com/gtag/js?id=<%= config.getString('app.googleAnalyticsTrackingId') %>"
-   ></script>
-   <script>
-       window.dataLayer = window.dataLayer || [];
-       function gtag() {
-       dataLayer.push(arguments);
-       }
-       gtag('js', new Date());
-       gtag(
-       'config',
-       '<%= config.getString("app.googleAnalyticsTrackingId") %>',
-       );
-   </script>
-   <% } %>
</head>

Additionally, you should make the following adjustment to app-config.yaml:

app:
  title: Backstage Example App
  baseUrl: http://localhost:3000
- googleAnalyticsTrackingId: # UA-000000-0

4091c73e68: Updated @swc/core to v1.3.9 which fixes a .tsx parser bug. You may want to run yarn backstage-cli versions:bump to get on latest version including the CLI itself.
80bfac5266: Updated the create-app command to no longer require Git to be installed and configured. A git repository will only be initialized if possible and if not already in an git repository.
286d474675: The build script in the root package.json has been split into two separate scripts, build:backend and build:all. This is to more accurately reflect what is being built, to avoid confusion.

If you want to build the project for a production deployment, you will want to use build:backend, as this builds both the frontend and backend package. If you are not using the app-backend plugin you will want to add your own build:frontend script, to which you can pass additional configuration parameters if needed.

The build:all script is useful if you simply want to check that it is possible to build all packages in the project. This might be useful as a CI check, but is generally unnecessary.

If you want to publish the packages in your repository you can add a build:packages script that calls backstage-cli repo build. This will skip the frontend and backend packages builds, as those are quite time consuming.

To apply these changes to an existing project, make the following change to the root package.json file:
```
-    "build": "backstage-cli repo build --all",
+    "build:backend": "yarn workspace backend build",
+    "build:all": "backstage-cli repo build --all",
```
There are also a couple of places where documentation has been updated, see the upgrade helper for a full list of changes.
384eaa2307: Switched Node.js version to support version 16 & 18, rather than 14 & 16. To switch the Node.js version in your own project, apply the following change to the root package.json:
```
   "engines": {
-    "node": "14 || 16"
+    "node": "16 || 18"
   },
```
As well as the following change to packages/app/package.json:
```
-    "@types/node": "^14.14.32",
+    "@types/node": "^16.11.26",
```
f905853ad6: Prefer using Link from @backstage/core-components rather than material-UI.

864c876e57: Fixed incorrect comments in the templated app-config.yaml and app-config.production.yaml. The backend.listen directive is not in fact needed to override the backend.baseUrl, the backend listens to all interfaces by default. The configuration has also been updated to listen to all interfaces, rather than just IPv4 ones, as this is required for Node.js v18. The production configuration now also shows the option to specify backend.listen as a single string.

To apply this changes to an existing app, make the following change to app-config.yaml:

-    # Uncomment the following host directive to bind to all IPv4 interfaces and
-    # not just the baseUrl hostname.
-    # host: 0.0.0.0
+    # Uncomment the following host directive to bind to specific interfaces
+    # host: 127.0.0.1

And the following change to app-config.production.yaml:

-  listen:
-    port: 7007
-    # The following host directive binds to all IPv4 interfaces when its value
-    # is "0.0.0.0". This is the most permissive setting. The right value depends
-    # on your specific deployment. If you remove the host line entirely, the
-    # backend will bind on the interface that corresponds to the backend.baseUrl
-    # hostname.
-    host: 0.0.0.0
+  # The listener can also be expressed as a single <host>:<port> string. In this case we bind to
+  # all interfaces, the most permissive setting. The right value depends on your specific deployment.
+  listen: ':7007'

Updated dependencies
- @backstage/cli-common@0.1.10

0.4.34-next.2

Patch Changes

384eaa2307: Switched Node.js version to support version 16 & 18, rather than 14 & 16. To switch the Node.js version in your own project, apply the following change to the root package.json:
```
   "engines": {
-    "node": "14 || 16"
+    "node": "16 || 18"
   },
```
As well as the following change to packages/app/package.json:
```
-    "@types/node": "^14.14.32",
+    "@types/node": "^16.11.26",
```

To apply this changes to an existing app, make the following change to app-config.yaml:

-    # Uncomment the following host directive to bind to all IPv4 interfaces and
-    # not just the baseUrl hostname.
-    # host: 0.0.0.0
+    # Uncomment the following host directive to bind to specific interfaces
+    # host: 127.0.0.1

And the following change to app-config.production.yaml:

-  listen:
-    port: 7007
-    # The following host directive binds to all IPv4 interfaces when its value
-    # is "0.0.0.0". This is the most permissive setting. The right value depends
-    # on your specific deployment. If you remove the host line entirely, the
-    # backend will bind on the interface that corresponds to the backend.baseUrl
-    # hostname.
-    host: 0.0.0.0
+  # The listener can also be expressed as a single <host>:<port> string. In this case we bind to
+  # all interfaces, the most permissive setting. The right value depends on your specific deployment.
+  listen: ':7007'

Updated dependencies
- @backstage/cli-common@0.1.10

0.4.33-next.1

Patch Changes

Bumped create-app version.

0.4.33-next.0

Patch Changes

4091c73e68: Updated @swc/core to v1.3.9 which fixes a .tsx parser bug. You may want to run yarn backstage-cli versions:bump to get on latest version including the CLI itself.
80bfac5266: Updated the create-app command to no longer require Git to be installed and configured. A git repository will only be initialized if possible and if not already in an git repository.
f905853ad6: Prefer using Link from @backstage/core-components rather than material-UI.
Updated dependencies
- @backstage/cli-common@0.1.10

0.4.32

Patch Changes

58c2264325: Newly created Backstage repositories now use the stable version 6 of react-router, just like the main repo does. Please let us know if you find any issues with this.

Migrating to the stable version of react-router is optional for the time being. But if you want to do the same for your existing repository, please follow this guide.
e05e0f021b: Update versions of packages used in the create-app template, to match those in the main repo
01dff06be4: Leverage cache mounts in Dockerfile during yarn install ... and apt-get ... commands to speed up repeated builds.
90616bcaa6: Add the new search pagination component to the search page template.
7c6306fc8a: Initializes a git repository when creating an app using @packages/create-app
52f25858a8: Added *.session.sql Visual Studio Code database functionality files to .gitignore in the default template. This is optional but potentially helpful if your developers use Visual Studio Code; you can add a line with that exact value to your own root .gitignore if you want the same.

6d00e80146: Updated the root test scripts to use backstage-cli repo test.

To apply this change to an existing app, make the following change to the root package.json:

-    "test": "backstage-cli test",
-    "test:all": "lerna run test -- --coverage",
+    "test": "backstage-cli repo test",
+    "test:all": "backstage-cli repo test --coverage",

Updated dependencies
- @backstage/cli-common@0.1.10

0.4.32-next.2

Patch Changes

01dff06be4: Leverage cache mounts in Dockerfile during yarn install ... and apt-get ... commands to speed up repeated builds.
Updated dependencies
- @backstage/cli-common@0.1.10

0.4.32-next.1

Patch Changes

7c6306fc8a: Initializes a git repository when creating an app using @packages/create-app
Updated dependencies
- @backstage/cli-common@0.1.10

0.4.32-next.0

Patch Changes

58c2264325: Newly created Backstage repositories now use the stable version 6 of react-router, just like the main repo does. Please let us know if you find any issues with this.

Migrating to the stable version of react-router is optional for the time being. But if you want to do the same for your existing repository, please follow this guide.
e05e0f021b: Update versions of packages used in the create-app template, to match those in the main repo
52f25858a8: Added *.session.sql Visual Studio Code database functionality files to .gitignore in the default template. This is optional but potentially helpful if your developers use Visual Studio Code; you can add a line with that exact value to your own root .gitignore if you want the same.

6d00e80146: Updated the root test scripts to use backstage-cli repo test.

To apply this change to an existing app, make the following change to the root package.json:

-    "test": "backstage-cli test",
-    "test:all": "lerna run test -- --coverage",
+    "test": "backstage-cli repo test",
+    "test:all": "backstage-cli repo test --coverage",

Updated dependencies
- @backstage/cli-common@0.1.10

0.4.31

Patch Changes

6ff94d60d5: Removed usage of the deprecated diff command in the root package.json.

To make this change in an existing app, make the following change in the root package.json:
```
-    "diff": "lerna run diff --",
```
c1f1a4c760: The Backstage packages and plugins have all been updated to support React Router v6 stable. The create-app template has not been migrated yet, but if you want to migrate your own app or plugins, check out the migration guide.
e83de28e36: Fix typo in the documentation
7d47def9c4: Removed dependency on @types/jest.

208d6780c9: The packages/backend/Dockerfile received a couple of updates, it now looks as follows:

FROM node:16-bullseye-slim

# Install sqlite3 dependencies. You can skip this if you don't use sqlite3 in the image,
# in which case you should also move better-sqlite3 to "devDependencies" in package.json.
RUN apt-get update && \
    apt-get install -y --no-install-recommends libsqlite3-dev python3 build-essential && \
    rm -rf /var/lib/apt/lists/* && \
    yarn config set python /usr/bin/python3

# From here on we use the least-privileged `node` user to run the backend.
USER node
WORKDIR /app

# This switches many Node.js dependencies to production mode.
ENV NODE_ENV production

# Copy repo skeleton first, to avoid unnecessary docker cache invalidation.
# The skeleton contains the package.json of each package in the monorepo,
# and along with yarn.lock and the root package.json, that's enough to run yarn install.
COPY --chown=node:node yarn.lock package.json packages/backend/dist/skeleton.tar.gz ./
RUN tar xzf skeleton.tar.gz && rm skeleton.tar.gz

RUN yarn install --frozen-lockfile --production --network-timeout 300000 && rm -rf "$(yarn cache dir)"

# Then copy the rest of the backend bundle, along with any other files we might want.
COPY --chown=node:node packages/backend/dist/bundle.tar.gz app-config*.yaml ./
RUN tar xzf bundle.tar.gz && rm bundle.tar.gz

CMD ["node", "packages/backend", "--config", "app-config.yaml", "--config", "app-config.production.yaml"]

The two notable changes are that a USER node instruction has been added and the ordering of instructions has been changed accordingly. This means that the app will now be running using the least-privileged node user. In order for this to work we now need to make sure that all app files are owned by the node user, which we do by adding the --chown=node:node option to the COPY instructions.

The second change is the addition of ENV NODE_ENV production, which ensured that all Node.js modules run in production mode. If you apply this change to an existing app, note that one of the more significant changes is that this switches the log formatting to use the default production format, JSON. Rather than your log lines looking like this:

2022-08-10T11:36:05.478Z catalog info Performing database migration type=plugin

They will now look like this:

{"level":"info","message":"Performing database migration","plugin":"catalog","service":"backstage","type":"plugin"}

If you wish to keep the existing format, you can override this change by applying the following change to packages/backend/src/index.ts:

   getRootLogger,
+  setRootLogger,
+  createRootLogger,
+  coloredFormat,
   useHotMemoize,
 ...
   ServerTokenManager,
 } from '@backstage/backend-common';

 ...

 async function main() {
+  setRootLogger(createRootLogger({ format: coloredFormat }));
+
   const config = await loadBackendConfig({

49416194e8: Adds IdentityApi configuration to create-app scaffolding templates.

To migrate to the new IdentityApi, edit the packages/backend/src/index.ts adding the following import:

import { DefaultIdentityClient } from '@backstage/plugin-auth-node';

Use the factory function to create an IdentityApi in the makeCreateEnv function and return it from the function as follows:

function makeCreateEnv(config: Config) {
...
  const identity = DefaultIdentityClient.create({
    discovery,
  });
...

  return {
    ...,
    identity
  }
}

Backend plugins can be upgraded to work with this new IdentityApi.

Add identity to the RouterOptions type.

export interface RouterOptions {
  ...
  identity: IdentityApi;
}

Then you can use the IdentityApi from the plugin.

export async function createRouter(
  options: RouterOptions,
): Promise<express.Router> {
  const { identity } = options;

  router.get('/user', async (req, res) => {
    const user = await identity.getIdentity({ request: req });
    ...

8d886dd33e: Added yarn new as one of the scripts installed by default, which calls backstage-cli new. This script replaces create-plugin, which you can now remove if you want to. It is kept in the create-app template for backwards compatibility.

The remove-plugin command has been removed, as it has been removed from the Backstage CLI.

To apply these changes to an existing app, make the following change to the root package.json:
```
-    "remove-plugin": "backstage-cli remove-plugin"
+    "new": "backstage-cli new --scope internal"
```
c3c90280be: The options part of DatabaseManager.fromConfig now accepts an optional logger field. You may want to supply that logger in your backend initialization code to ensure that you can get relevant logging data when things happen related to the connection pool.

In packages/backend/src/index.ts:
```
 function makeCreateEnv(config: Config) {
   const root = getRootLogger();
   ...
-  const databaseManager = DatabaseManager.fromConfig(config);
+  const databaseManager = DatabaseManager.fromConfig(config, { logger: root });
```
a578558180: Updated the root package.json to use the new backstage-cli repo clean command.

To apply this change to an existing project, make the following change to the root package.json:
```
-    "clean": "backstage-cli clean && lerna run clean",
+    "clean": "backstage-cli repo clean",
```

c0a08fd08c: Added EntityLinksCard to the system EntityPage.

For an existing installation where you want to display the links card for entity pages of kind system you should make the following adjustment to packages/app/src/components/catalog/EntityPage.tsx

const systemPage = (
  ...
        <Grid item md={6} xs={12}>
          <EntityCatalogGraphCard variant="gridItem" height={400} />
        </Grid>
+       <Grid item md={4} xs={12}>
+         <EntityLinksCard />
+       </Grid>
-      <Grid item md={6}>
+      <Grid item md={8}>
          <EntityHasComponentsCard variant="gridItem" />
        </Grid>
  ...
);

Updated dependencies
- @backstage/cli-common@0.1.10

0.4.31-next.3

Patch Changes

7d47def9c4: Removed dependency on @types/jest.
Updated dependencies
- @backstage/cli-common@0.1.10-next.0

0.4.31-next.2

Patch Changes

6ff94d60d5: Removed usage of the deprecated diff command in the root package.json.

To make this change in an existing app, make the following change in the root package.json:
```
-    "diff": "lerna run diff --",
```

49416194e8: Adds IdentityApi configuration to create-app scaffolding templates.

To migrate to the new IdentityApi, edit the packages/backend/src/index.ts adding the following import:

import { DefaultIdentityClient } from '@backstage/plugin-auth-node';

Use the factory function to create an IdentityApi in the makeCreateEnv function and return it from the function as follows:

function makeCreateEnv(config: Config) {
...
  const identity = DefaultIdentityClient.create({
    discovery,
  });
...

  return {
    ...,
    identity
  }
}

Backend plugins can be upgraded to work with this new IdentityApi.

Add identity to the RouterOptions type.

export interface RouterOptions {
  ...
  identity: IdentityApi;
}

Then you can use the IdentityApi from the plugin.

export async function createRouter(
  options: RouterOptions,
): Promise<express.Router> {
  const { identity } = options;

  router.get('/user', async (req, res) => {
    const user = await identity.getIdentity({ request: req });
    ...

8d886dd33e: Added yarn new as one of the scripts installed by default, which calls backstage-cli new. This script replaces create-plugin, which you can now remove if you want to. It is kept in the create-app template for backwards compatibility.

The remove-plugin command has been removed, as it has been removed from the Backstage CLI.

To apply these changes to an existing app, make the following change to the root package.json:
```
-    "remove-plugin": "backstage-cli remove-plugin"
+    "new": "backstage-cli new --scope internal"
```
a578558180: Updated the root package.json to use the new backstage-cli repo clean command.

To apply this change to an existing project, make the following change to the root package.json:
```
-    "clean": "backstage-cli clean && lerna run clean",
+    "clean": "backstage-cli repo clean",
```

0.4.31-next.1

Patch Changes

c1f1a4c760: The Backstage packages and plugins have all been updated to support React Router v6 stable. The create-app template has not been migrated yet, but if you want to migrate your own app or plugins, check out the migration guide.
c3c90280be: The options part of DatabaseManager.fromConfig now accepts an optional logger field. You may want to supply that logger in your backend initialization code to ensure that you can get relevant logging data when things happen related to the connection pool.

In packages/backend/src/index.ts:
```
 function makeCreateEnv(config: Config) {
   const root = getRootLogger();
   ...
-  const databaseManager = DatabaseManager.fromConfig(config);
+  const databaseManager = DatabaseManager.fromConfig(config, { logger: root });
```

0.4.31-next.0

Patch Changes

e83de28e36: Fix typo in the documentation

208d6780c9: The packages/backend/Dockerfile received a couple of updates, it now looks as follows:

FROM node:16-bullseye-slim

# Install sqlite3 dependencies. You can skip this if you don't use sqlite3 in the image,
# in which case you should also move better-sqlite3 to "devDependencies" in package.json.
RUN apt-get update && \
    apt-get install -y --no-install-recommends libsqlite3-dev python3 build-essential && \
    rm -rf /var/lib/apt/lists/* && \
    yarn config set python /usr/bin/python3

# From here on we use the least-privileged `node` user to run the backend.
USER node
WORKDIR /app

# This switches many Node.js dependencies to production mode.
ENV NODE_ENV production

# Copy repo skeleton first, to avoid unnecessary docker cache invalidation.
# The skeleton contains the package.json of each package in the monorepo,
# and along with yarn.lock and the root package.json, that's enough to run yarn install.
COPY --chown=node:node yarn.lock package.json packages/backend/dist/skeleton.tar.gz ./
RUN tar xzf skeleton.tar.gz && rm skeleton.tar.gz

RUN yarn install --frozen-lockfile --production --network-timeout 300000 && rm -rf "$(yarn cache dir)"

# Then copy the rest of the backend bundle, along with any other files we might want.
COPY --chown=node:node packages/backend/dist/bundle.tar.gz app-config*.yaml ./
RUN tar xzf bundle.tar.gz && rm bundle.tar.gz

CMD ["node", "packages/backend", "--config", "app-config.yaml", "--config", "app-config.production.yaml"]

2022-08-10T11:36:05.478Z catalog info Performing database migration type=plugin

They will now look like this:

{"level":"info","message":"Performing database migration","plugin":"catalog","service":"backstage","type":"plugin"}

If you wish to keep the existing format, you can override this change by applying the following change to packages/backend/src/index.ts:

   getRootLogger,
+  setRootLogger,
+  createRootLogger,
+  coloredFormat,
   useHotMemoize,
 ...
   ServerTokenManager,
 } from '@backstage/backend-common';

 ...

 async function main() {
+  setRootLogger(createRootLogger({ format: coloredFormat }));
+
   const config = await loadBackendConfig({

c0a08fd08c: Added EntityLinksCard to the system EntityPage.

const systemPage = (
  ...
        <Grid item md={6} xs={12}>
          <EntityCatalogGraphCard variant="gridItem" height={400} />
        </Grid>
+       <Grid item md={4} xs={12}>
+         <EntityLinksCard />
+       </Grid>
-      <Grid item md={6}>
+      <Grid item md={8}>
          <EntityHasComponentsCard variant="gridItem" />
        </Grid>
  ...
);

0.4.30

Patch Changes

73cee58fc2: Bumped create-app version.
f762386d48: Bumped create-app version.
b162bbf464: Bumped create-app version.
db76fc6255: The better-sqlite3 dependency has been moved back to production "dependencies" in packages/backend/package.json, with instructions in the Dockerfile to move it to "devDependencies" if desired. There is no need to apply this change to existing apps, unless you want your production image to have SQLite available as a database option.
ab9edd8b58: Updated backend to write stack trace when the backend fails to start up.

To apply this change to your Backstage installation, make the following change to packages/backend/src/index.ts
```
    cors:
    origin: http://localhost:3000
-    console.error(`Backend failed to start up, ${error}`);
+    console.error('Backend failed to start up', error);
```
0174a0a022: Add PATCH and HEAD to the Access-Control-Allow-Methods.

To apply this change to your Backstage installation make the following change to your app-config.yaml
```
   cors:
     origin: http://localhost:3000
-    methods: [GET, POST, PUT, DELETE]
+    methods: [GET, POST, PUT, DELETE, PATCH, HEAD]
```

0.4.30-next.3

Patch Changes

Bumped create-app version.

0.4.30-next.2

Patch Changes

0174a0a022: Add PATCH and HEAD to the Access-Control-Allow-Methods.

To apply this change to your Backstage installation make the following change to your app-config.yaml
```
   cors:
     origin: http://localhost:3000
-    methods: [GET, POST, PUT, DELETE]
+    methods: [GET, POST, PUT, DELETE, PATCH, HEAD]
```

0.4.30-next.1

Patch Changes

Bumped create-app version.

0.4.30-next.0

Patch Changes

Bumped create-app version.

0.4.29

Patch Changes

f281ad17c0: Adds the ability to define the Backstage app name using a BACKSTAGE_APP_NAME environment variable when running create-app.
c92deffe39: Bumped create-app version.
0e967f188b: Bumped create-app version.
bc87604c26: Added an explicit node-gyp dependency to the root package.json. This is to work around a bug in older versions of node-gyp that causes Python execution to fail on macOS.

You can add this workaround to your existing project by adding node-gyp as a devDependency in your root package.json file:
```
   "devDependencies": {
+    "node-gyp": "^9.0.0"
   },
```

0.4.29-next.3

Patch Changes

Bumped create-app version.

0.4.29-next.2

Patch Changes

f281ad17c0: Adds the ability to define the Backstage app name using a BACKSTAGE_APP_NAME environment variable when running create-app.

0.4.29-next.1

Patch Changes

Bumped create-app version.

0.4.29-next.0

Patch Changes

bc87604c26: Added an explicit node-gyp dependency to the root package.json. This is to work around a bug in older versions of node-gyp that causes Python execution to fail on macOS.

You can add this workaround to your existing project by adding node-gyp as a devDependency in your root package.json file:
```
   "devDependencies": {
+    "node-gyp": "^9.0.0"
   },
```

0.4.28

Patch Changes

881fbd7e8d: Register TechDocs addons on catalog entity pages, follow the steps below to add them manually:

// packages/app/src/components/catalog/EntityPage.tsx

+ import { TechDocsAddons } from '@backstage/plugin-techdocs-react';
+ import {
+   ReportIssue,
+ } from '@backstage/plugin-techdocs-module-addons-contrib';

+ const techdocsContent = (
+   <EntityTechdocsContent>
+     <TechDocsAddons>
+       <ReportIssue />
+     </TechDocsAddons>
+   </EntityTechdocsContent>
+ );

const defaultEntityPage = (
  ...
  <EntityLayout.Route path="/docs" title="Docs">
+    {techdocsContent}
  </EntityLayout.Route>
  ...
);

const serviceEntityPage = (
  ...
  <EntityLayout.Route path="/docs" title="Docs">
+    {techdocsContent}
  </EntityLayout.Route>
  ...
);

const websiteEntityPage = (
  ...
  <EntityLayout.Route path="/docs" title="Docs">
+    {techdocsContent}
  </EntityLayout.Route>
  ...
);

0e870fe0ac: Removed peer dependencies, as they are no longer needed.

bff65e6958: Use of SidebarContext has been deprecated and will be removed in a future release. Instead, useSidebarOpenState() should be used to consume the context and <SidebarOpenStateProvider> should be used to provide it.

To prepare your app, update packages/app/src/components/Root/Root.tsx as follows:

import {
  Sidebar,
  sidebarConfig,
- SidebarContext
  SidebarDivider,
  // ...
  SidebarSpace,
+ useSidebarOpenState,
} from '@backstage/core-components';

// ...

const SidebarLogo = () => {
  const classes = useSidebarLogoStyles();
- const { isOpen } = useContext(SidebarContext);
+ const { isOpen } = useSidebarOpenState();

  // ...
};

935d8515da: Updated the --version flag to output the version of the current backstage release instead of the version of create-app.
18d4c3e50a: Updated app-config.production.yaml to specify an empty list of catalog locations. This is done to prevent example locations stored in app-config.yaml from being loaded as these are examples.

1f70704580: Accessibility updates:

Added aria-label to the sidebar Logo link. To enable this for an existing app, please make the following changes:

packages/app/src/components/Root/Root.tsx

const SidebarLogo = () => {
  const classes = useSidebarLogoStyles();
  const { isOpen } = useContext(SidebarContext);

  return (
    <div className={classes.root}>
      <Link
        component={NavLink}
        to="/"
        underline="none"
        className={classes.link}
+       aria-label="Home"
      >
        {isOpen ? <LogoFull /> : <LogoIcon />}
      </Link>
    </div>
  );
};

30f04d1497: Components <DefaultResultListItem>, <SearchBar>, <SearchFilter>, and <SearchResult> are now deprecated in @backstage/plugin-search and should be imported from @backstage/plugin-search-react instead.

To upgrade your App, update the following in packages/app/src/components/search/SearchPage.tsx:
```
import {
  DefaultResultListItem
  SearchBar
  SearchFilter
  SearchResult
- } from `@backstage/plugin-search`;
+ } from `@backstage/plugin-search-react`;
```

f7f5a6c6a3: It's now possible to pass result item components a rank, which is captured by the analytics API when a user clicks on a search result. To apply this change, update your /packages/app/src/components/search/SearchPage.tsx in the following way:

// ...
<SearchResult>
  {({ results }) => (
    <List>
-     {results.map(({ type, document, highlight }) => {
+     {results.map(({ type, document, highlight, rank }) => {
        switch (type) {
          case 'software-catalog':
            return (
              <CatalogSearchResultListItem
                key={document.location}
                result={document}
                highlight={highlight}
+               rank={rank}
              />
            );
          case 'techdocs':
            return (
              <TechDocsSearchResultListItem
                key={document.location}
                result={document}
                highlight={highlight}
+               rank={rank}
              />
            );
          default:
            return (
              <DefaultResultListItem
                key={document.location}
                result={document}
                highlight={highlight}
+               rank={rank}
              />
            );
        }
      })}
    </List>
  )}
</SearchResult>
// ...

If you have implemented a custom Search Modal or other custom search experience, you will want to make similar changes in those components.

aaf7652084: Bump version of cypress in newly scaffolded Backstage Applications. To apply this change to your own instance, please make the following change to packages/app/package.json under devDependencies.
```
-   "cypress": "^7.3.0",
+   "cypress": "^9.7.0",
```
141a1caebe: Updated the auth backend setup in the template to include a guest sign-in resolver in order to make it quicker to get up and running with a basic sign-in setup. There is no need to update existing apps to match this change, but in case you want to use the guest sign-in resolver you can find it at https://backstage.io/docs/auth/identity-resolver#guest-sign-in-resolver

0.4.28-next.2

Patch Changes

aaf7652084: Bump version of cypress in newly scaffolded Backstage Applications. To apply this change to your own instance, please make the following change to packages/app/package.json under devDependencies.
```
-   "cypress": "^7.3.0",
+   "cypress": "^9.7.0",
```

0.4.28-next.1

Patch Changes

To prepare your app, update packages/app/src/components/Root/Root.tsx as follows:

import {
  Sidebar,
  sidebarConfig,
- SidebarContext
  SidebarDivider,
  // ...
  SidebarSpace,
+ useSidebarOpenState,
} from '@backstage/core-components';

// ...

const SidebarLogo = () => {
  const classes = useSidebarLogoStyles();
- const { isOpen } = useContext(SidebarContext);
+ const { isOpen } = useSidebarOpenState();

  // ...
};

0.4.28-next.0

Patch Changes

881fbd7e8d: Register TechDocs addons on catalog entity pages, follow the steps below to add them manually:

// packages/app/src/components/catalog/EntityPage.tsx

+ import { TechDocsAddons } from '@backstage/plugin-techdocs-react';
+ import {
+   ReportIssue,
+ } from '@backstage/plugin-techdocs-module-addons-contrib';

+ const techdocsContent = (
+   <EntityTechdocsContent>
+     <TechDocsAddons>
+       <ReportIssue />
+     </TechDocsAddons>
+   </EntityTechdocsContent>
+ );

const defaultEntityPage = (
  ...
  <EntityLayout.Route path="/docs" title="Docs">
+    {techdocsContent}
  </EntityLayout.Route>
  ...
);

const serviceEntityPage = (
  ...
  <EntityLayout.Route path="/docs" title="Docs">
+    {techdocsContent}
  </EntityLayout.Route>
  ...
);

const websiteEntityPage = (
  ...
  <EntityLayout.Route path="/docs" title="Docs">
+    {techdocsContent}
  </EntityLayout.Route>
  ...
);

935d8515da: Updated the --version flag to output the version of the current backstage release instead of the version of create-app.

1f70704580: Accessibility updates:

Added aria-label to the sidebar Logo link. To enable this for an existing app, please make the following changes:

packages/app/src/components/Root/Root.tsx

const SidebarLogo = () => {
  const classes = useSidebarLogoStyles();
  const { isOpen } = useContext(SidebarContext);

  return (
    <div className={classes.root}>
      <Link
        component={NavLink}
        to="/"
        underline="none"
        className={classes.link}
+       aria-label="Home"
      >
        {isOpen ? <LogoFull /> : <LogoIcon />}
      </Link>
    </div>
  );
};

0.4.27

Patch Changes

73480846dd: Simplified the search collator scheduling by removing the need for the luxon dependency.

For existing installations the scheduling can be simplified by removing the luxon dependency and using the human friendly duration object instead. Please note that this only applies if luxon is not used elsewhere in your installation.

packages/backend/package.json

     "express": "^4.17.1",
     "express-promise-router": "^4.1.0",
-    "luxon": "^2.0.2",

packages/backend/src/plugins/search.ts

 import { Router } from 'express';
-import { Duration } from 'luxon';

 // omitted other code

   const schedule = env.scheduler.createScheduledTaskRunner({
-    frequency: Duration.fromObject({ minutes: 10 }),
-    timeout: Duration.fromObject({ minutes: 15 }),
+    frequency: { minutes: 10 },
+    timeout: { minutes: 15 },
     // A 3 second delay gives the backend server a chance to initialize before
     // any collators are executed, which may attempt requests against the API.
-    initialDelay: Duration.fromObject({ seconds: 3 }),
+    initialDelay: { seconds: 3 },
   });

7cda923c16: Tweaked the .dockerignore file so that it's easier to add additional backend packages if desired.

To apply this change to an existing app, make the following change to .dockerignore:
```
 cypress
 microsite
 node_modules
-packages
-!packages/backend/dist
+packages/*/src
+packages/*/node_modules
 plugins
```
3983940a21: Optimized the command order in packages/backend/Dockerfile as well as added the --no-install-recommends to the apt-get install and tweaked the installed packages.

To apply this change to an existing app, update your packages/backend/Dockerfile to match the documented Dockerfile at https://backstage.io/docs/deployment/docker#host-build.
28bbf5aff6: Added some instruction comments to the generated config files, to clarify the usage of backend.baseUrl and backend.listen.host. Importantly, it also per default now listens on all IPv4 interfaces, to make it easier to take the step over to production. If you want to do the same, update your app-config.production.yaml as follows:
```
 backend:
   listen:
     port: 7007
+    host: 0.0.0.0
```
Also, updated the builtin backend Dockerfile to honor the app-config.production.yaml file. If you want to do the same, change packages/backend/Dockerfile as follows:
```
-COPY packages/backend/dist/bundle.tar.gz app-config.yaml ./
+COPY packages/backend/dist/bundle.tar.gz app-config*.yaml ./
 RUN tar xzf bundle.tar.gz && rm bundle.tar.gz

-CMD ["node", "packages/backend", "--config", "app-config.yaml"]
+CMD ["node", "packages/backend", "--config", "app-config.yaml", "--config", "app-config.production.yaml"]
```
If you look carefully, this adds a glob match on app-config files. For those that try out the build flows locally, you also want to make sure that the docker daemon does NOT pick up any local/private config files that might contain secrets. You should therefore also update your local .dockerignore file at the same time:
```
+*.local.yaml
```
7b253072c6: Tweaked template to provide an example and guidance for how to configure sign-in in packages/backend/src/plugins/auth.ts. There is no need to add this to existing apps, but for more information about sign-in configuration, see https://backstage.io/docs/auth/identity-resolver.
cfc0f19699: Updated dependency fs-extra to 10.1.0.
f55414f895: Added sample catalog data to the template under a top-level examples directory. This includes some simple entities, org data, and a template. You can find the sample data at https://github.com/backstage/backstage/tree/master/packages/create-app/templates/default-app/examples.
344ea56acc: Bump commander to version 9.1.0
00fa0dada0: Removed the database choice from the create-app command.

This reduces the step from development to production by always installing the dependencies and templating the production configuration in app-config.production.yaml.

Added app-config.local.yaml to allow for local configuration overrides. To replicate this behavior in an existing installation simply touch app-config.local.yaml in the project root and apply your local configuration.

better-sqlite3 has been moved to devDependencies, for existing installations using postgres in production and SQLite in development it's recommended to move SQLite into the devDependencies section to avoid unnecessary dependencies during builds.

in packages/backend/package.json
```
  "dependencies": {
    ...
    "pg": "^8.3.0",
-   "better-sqlite3": "^7.5.0",
    "winston": "^3.2.1"
  },
  "devDependencies": {
    ...
    "@types/luxon": "^2.0.4",
+   "better-sqlite3": "^7.5.0"
  }
```

10d86dedc0: Integrates TechDocs add-ons with the app package so add-ons are configured when creating an app using the Backstage CLI. To apply these changes to an existing application do the following:

Add the @backstage/plugin-techdocs-react and @backstage/plugin-techdocs-module-addons-contrib packages to your app's dependencies;
And then register the <ReportIssue/ > Addon in your packages/app/src/App.tsx file, there where you define a route to <TechDocsReaderPage />:

import {
  DefaultTechDocsHome,
  TechDocsIndexPage,
  TechDocsReaderPage,
} from '@backstage/plugin-techdocs';
+ import { TechDocsAddons } from '@backstage/plugin-techdocs-react';
+ import { ReportIssue } from '@backstage/plugin-techdocs-module-addons-contrib';

// ...

const AppRoutes = () => {
  <FlatRoutes>
    // ... other plugin routes
    <Route path="/docs" element={<TechDocsIndexPage />}>
      <DefaultTechDocsHome />
    </Route>
    <Route
      path="/docs/:namespace/:kind/:name/*"
      element={<TechDocsReaderPage />}
    >
+     <TechDocsAddons>
+       <ReportIssue />
+     </TechDocsAddons>
    </Route>
  </FlatRoutes>;
};

806427545f: Added a link to the ${GITHUB_TOKEN} to document how to generate a token

3a74e203a8: Implement highlighting matching terms in search results. To enable this for an existing app, make the following changes:

// packages/app/src/components/search/SearchPage.tsx
...
-  {results.map(({ type, document }) => {
+  {results.map(({ type, document, highlight }) => {
     switch (type) {
       case 'software-catalog':
         return (
           <CatalogSearchResultListItem
             key={document.location}
             result={document}
+            highlight={highlight}
           />
         );
       case 'techdocs':
         return (
           <TechDocsSearchResultListItem
             key={document.location}
             result={document}
+            highlight={highlight}
           />
         );
       default:
         return (
           <DefaultResultListItem
             key={document.location}
             result={document}
+            highlight={highlight}
           />
         );
     }
   })}
...

d41f19ca2a: Bumped the typescript version in the template to ~4.6.4.

To apply this change to an existing app, make the following change to the root package.json:
```
   dependencies: {
     ...
-    "typescript": "~4.5.4"
+    "typescript": "~4.6.4"
   },
```
Updated dependencies
- @backstage/cli-common@0.1.9

0.4.27-next.2

Patch Changes

73480846dd: Simplified the search collator scheduling by removing the need for the luxon dependency.

packages/backend/package.json

     "express": "^4.17.1",
     "express-promise-router": "^4.1.0",
-    "luxon": "^2.0.2",

packages/backend/src/plugins/search.ts

 import { Router } from 'express';
-import { Duration } from 'luxon';

 // omitted other code

   const schedule = env.scheduler.createScheduledTaskRunner({
-    frequency: Duration.fromObject({ minutes: 10 }),
-    timeout: Duration.fromObject({ minutes: 15 }),
+    frequency: { minutes: 10 },
+    timeout: { minutes: 15 },
     // A 3 second delay gives the backend server a chance to initialize before
     // any collators are executed, which may attempt requests against the API.
-    initialDelay: Duration.fromObject({ seconds: 3 }),
+    initialDelay: { seconds: 3 },
   });

7cda923c16: Tweaked the .dockerignore file so that it's easier to add additional backend packages if desired.

To apply this change to an existing app, make the following change to .dockerignore:
```
 cypress
 microsite
 node_modules
-packages
-!packages/backend/dist
+packages/*/src
+packages/*/node_modules
 plugins
```
f55414f895: Added sample catalog data to the template under a top-level examples directory. This includes some simple entities, org data, and a template. You can find the sample data at https://github.com/backstage/backstage/tree/master/packages/create-app/templates/default-app/examples.

3a74e203a8: Implement highlighting matching terms in search results. To enable this for an existing app, make the following changes:

// packages/app/src/components/search/SearchPage.tsx
...
-  {results.map(({ type, document }) => {
+  {results.map(({ type, document, highlight }) => {
     switch (type) {
       case 'software-catalog':
         return (
           <CatalogSearchResultListItem
             key={document.location}
             result={document}
+            highlight={highlight}
           />
         );
       case 'techdocs':
         return (
           <TechDocsSearchResultListItem
             key={document.location}
             result={document}
+            highlight={highlight}
           />
         );
       default:
         return (
           <DefaultResultListItem
             key={document.location}
             result={document}
+            highlight={highlight}
           />
         );
     }
   })}
...

Updated dependencies
- @backstage/cli-common@0.1.9-next.0

0.4.27-next.1

Patch Changes

7b253072c6: Tweaked template to provide an example and guidance for how to configure sign-in in packages/backend/src/plugins/auth.ts. There is no need to add this to existing apps, but for more information about sign-in configuration, see https://backstage.io/docs/auth/identity-resolver.
00fa0dada0: Removed the database choice from the create-app command.

This reduces the step from development to production by always installing the dependencies and templating the production configuration in app-config.production.yaml.

Added app-config.local.yaml to allow for local configuration overrides. To replicate this behavior in an existing installation simply touch app-config.local.yaml in the project root and apply your local configuration.

better-sqlite3 has been moved to devDependencies, for existing installations using postgres in production and SQLite in development it's recommended to move SQLite into the devDependencies section to avoid unnecessary dependencies during builds.

in packages/backend/package.json
```
  "dependencies": {
    ...
    "pg": "^8.3.0",
-   "better-sqlite3": "^7.5.0",
    "winston": "^3.2.1"
  },
  "devDependencies": {
    ...
    "@types/luxon": "^2.0.4",
+   "better-sqlite3": "^7.5.0"
  }
```
d41f19ca2a: Bumped the typescript version in the template to ~4.6.4.

To apply this change to an existing app, make the following change to the root package.json:
```
   dependencies: {
     ...
-    "typescript": "~4.5.4"
+    "typescript": "~4.6.4"
   },
```

0.4.27-next.0

Patch Changes

3983940a21: Optimized the command order in packages/backend/Dockerfile as well as added the --no-install-recommends to the apt-get install and tweaked the installed packages.

To apply this change to an existing app, update your packages/backend/Dockerfile to match the documented Dockerfile at https://backstage.io/docs/deployment/docker#host-build.
28bbf5aff6: Added some instruction comments to the generated config files, to clarify the usage of backend.baseUrl and backend.listen.host. Importantly, it also per default now listens on all IPv4 interfaces, to make it easier to take the step over to production. If you want to do the same, update your app-config.production.yaml as follows:
```
 backend:
   listen:
     port: 7007
+    host: 0.0.0.0
```
Also, updated the builtin backend Dockerfile to honor the app-config.production.yaml file. If you want to do the same, change packages/backend/Dockerfile as follows:
```
-COPY packages/backend/dist/bundle.tar.gz app-config.yaml ./
+COPY packages/backend/dist/bundle.tar.gz app-config*.yaml ./
 RUN tar xzf bundle.tar.gz && rm bundle.tar.gz

-CMD ["node", "packages/backend", "--config", "app-config.yaml"]
+CMD ["node", "packages/backend", "--config", "app-config.yaml", "--config", "app-config.production.yaml"]
```
If you look carefully, this adds a glob match on app-config files. For those that try out the build flows locally, you also want to make sure that the docker daemon does NOT pick up any local/private config files that might contain secrets. You should therefore also update your local .dockerignore file at the same time:
```
+*.local.yaml
```
cfc0f19699: Updated dependency fs-extra to 10.1.0.
344ea56acc: Bump commander to version 9.1.0
806427545f: Added a link to the ${GITHUB_TOKEN} to document how to generate a token

0.4.26

Patch Changes

1691c6c5c2: Made User and Group entity kinds not permitted by the default catalog.rules config.

The effect of this is that after creating a new Backstage repository, its catalog no longer permits regular users to register User or Group entities using the Backstage interface. Additionally, if you have config locations that result in User or Group entities, you need to add those kinds to its own specific rules:
```
catalog:
  locations:
    # This applies for example to url type locations
    - type: url
      target: https://example.com/org.yaml
      rules:
        - allow: [User, Group]
    # But also note that this applies to ALL org location types!
    - type: github-org
      target: https://github.com/my-org-name
      rules:
        - allow: [User, Group]
```
This rule change does NOT affect entity providers, only things that are emitted by entity processors.

We recommend that this change is applied to your own Backstage repository, since it makes it impossible for regular end users to affect your org data through e.g. YAML files. To do so, remove the two kinds from the default rules in your config:
```
 catalog:
   rules:
-    - allow: [Component, System, API, Group, User, Resource, Location]
+    - allow: [Component, System, API, Resource, Location]
```
And for any location that in any way results in org data being ingested, add the corresponding rule to it:
```
 catalog:
   locations:
     - type: github-org
       target: https://github.com/my-org-name
+      rules:
+        - allow: [User, Group]
```

0e911394d2: Remove the knex package that is installed in the packages/backend as it's provided by the @backstage/* packages for you automatically. You can make the following change in your packages/backend/package.json if you wish to apply this change.

    "lint": "backstage-cli package lint",
    "test": "backstage-cli package test",
    "clean": "backstage-cli package clean",
-   "migrate:create": "knex migrate:make -x ts"

    "express": "^4.17.1",
    "express-promise-router": "^4.1.0",
-   "knex": "^0.21.6",
    "pg": "^8.3.0",

520e21aaea: imports useSearch hook from new @backstage/plugin-search-react package.

To upgrade existing Apps:
1. Change the import to the following:
packages/app/src/components/search/SearchPage.tsx
```
import {
...
SearchType,
- useSearch,
} from '@backstage/plugin-search';
+import { useSearch } from '@backstage/plugin-search-react';
```
1. Add @backstage/plugin-search-react as a dependency to the app.
43759dd789: Removed @octokit/rest and @gitbeaker/node from backend dependencies as these are unused in the default app.

To apply these changes to your existing app, remove the following lines from the dependencies section of packages/backend/package.json
```
     "@backstage/plugin-techdocs-backend": "^1.0.0",
-    "@gitbeaker/node": "^34.6.0",
-    "@octokit/rest": "^18.5.3",
```
e838a7060a: Add type resolutions for @types/react and types/react-dom.

The reason for this is the usage of "@types/react": "*" as a dependency which is very common practice in react packages. This recently resolves to react 18 which introduces several breaking changes in both internal and external packages.

To apply these changes to your existing installation, add a resolutions block to your package.json
```
  "resolutions": {
    "@types/react": "^17",
    "@types/react-dom": "^17"
  },
```
If your existing app depends on react 16, use this resolution block instead.
```
  "resolutions": {
    "@types/react": "^16",
    "@types/react-dom": "^16"
  },
```

0a63e99a26: BREAKING: IndexBuilder.addCollator() now requires a schedule parameter (replacing defaultRefreshIntervalSeconds) which is expected to be a TaskRunner that is configured with the desired search indexing schedule for the given collator.

Scheduler.addToSchedule() now takes a new parameter object (ScheduleTaskParameters) with two new options id and scheduledRunner in addition to the migrated task argument.

NOTE: The search backend plugin now creates a dedicated database for coordinating indexing tasks.

To make this change to an existing app, make the following changes to packages/backend/src/plugins/search.ts:

+import { Duration } from 'luxon';

/* ... */

+  const schedule = env.scheduler.createScheduledTaskRunner({
+    frequency: Duration.fromObject({ minutes: 10 }),
+    timeout: Duration.fromObject({ minutes: 15 }),
+    initialDelay: Duration.fromObject({ seconds: 3 }),
+  });

   indexBuilder.addCollator({
-    defaultRefreshIntervalSeconds: 600,
+    schedule,
     factory: DefaultCatalogCollatorFactory.fromConfig(env.config, {
      discovery: env.discovery,
      tokenManager: env.tokenManager,
     }),
   });

   indexBuilder.addCollator({
-    defaultRefreshIntervalSeconds: 600,
+    schedule,
     factory: DefaultTechDocsCollatorFactory.fromConfig(env.config, {
      discovery: env.discovery,
      tokenManager: env.tokenManager,
     }),
   });

   const { scheduler } = await indexBuilder.build();
-  setTimeout(() => scheduler.start(), 3000);
+  scheduler.start();
/* ... */

NOTE: For scenarios where the lunr search engine is used in a multi-node configuration, a non-distributed TaskRunner like the following should be implemented to ensure consistency across nodes (alternatively, you can configure the search plugin to use a non-distributed DB such as SQLite):

+import { TaskInvocationDefinition, TaskRunner } from '@backstage/backend-tasks';

/* ... */

+  const schedule: TaskRunner = {
+    run: async (task: TaskInvocationDefinition) => {
+      const startRefresh = async () => {
+        while (!task.signal?.aborted) {
+          try {
+            await task.fn(task.signal);
+          } catch {
+            // ignore intentionally
+          }
+
+          await new Promise(resolve => setTimeout(resolve, 600 * 1000));
+        }
+      };
+      startRefresh();
+    },
+  };

   indexBuilder.addCollator({
-    defaultRefreshIntervalSeconds: 600,
+    schedule,
     factory: DefaultCatalogCollatorFactory.fromConfig(env.config, {
      discovery: env.discovery,
      tokenManager: env.tokenManager,
     }),
   });

/* ... */

c07d9f9e1c: Add helpful README.md files in the original packages and plugins folders
230ad0826f: Bump to using @types/node v16

1882dbda2b: Accept PermissionEvaluator instead of the deprecated PermissionAuthorizer.

Apply the following to packages/backend/src/types.ts:

- import { PermissionAuthorizer } from '@backstage/plugin-permission-common';
+ import { PermissionEvaluator } from '@backstage/plugin-permission-common';

  export type PluginEnvironment = {
    ...
    discovery: PluginEndpointDiscovery;
    tokenManager: TokenManager;
    scheduler: PluginTaskScheduler;
-   permissions: PermissionAuthorizer;
+   permissions: PermissionEvaluator;
  };

e80cca164d: Tweaked .eslintrc.js files in the template to avoid having them apply during development. This change does not affect create apps.

0.4.26-next.2

Patch Changes

43759dd789: Removed @octokit/rest and @gitbeaker/node from backend dependencies as these are unused in the default app.

To apply these changes to your existing app, remove the following lines from the dependencies section of packages/backend/package.json
```
     "@backstage/plugin-techdocs-backend": "^1.0.0",
-    "@gitbeaker/node": "^34.6.0",
-    "@octokit/rest": "^18.5.3",
```
e838a7060a: Add type resolutions for @types/react and types/react-dom.

The reason for this is the usage of "@types/react": "*" as a dependency which is very common practice in react packages. This recently resolves to react 18 which introduces several breaking changes in both internal and external packages.

To apply these changes to your existing installation, add a resolutions block to your package.json
```
  "resolutions": {
    "@types/react": "^17",
    "@types/react-dom": "^17"
  },
```
If your existing app depends on react 16, use this resolution block instead.
```
  "resolutions": {
    "@types/react": "^16",
    "@types/react-dom": "^16"
  },
```

Scheduler.addToSchedule() now takes a new parameter object (ScheduleTaskParameters) with two new options id and scheduledRunner in addition to the migrated task argument.

NOTE: The search backend plugin now creates a dedicated database for coordinating indexing tasks.

To make this change to an existing app, make the following changes to packages/backend/src/plugins/search.ts:

+import { Duration } from 'luxon';

/* ... */

+  const schedule = env.scheduler.createScheduledTaskRunner({
+    frequency: Duration.fromObject({ minutes: 10 }),
+    timeout: Duration.fromObject({ minutes: 15 }),
+    initialDelay: Duration.fromObject({ seconds: 3 }),
+  });

   indexBuilder.addCollator({
-    defaultRefreshIntervalSeconds: 600,
+    schedule,
     factory: DefaultCatalogCollatorFactory.fromConfig(env.config, {
      discovery: env.discovery,
      tokenManager: env.tokenManager,
     }),
   });

   indexBuilder.addCollator({
-    defaultRefreshIntervalSeconds: 600,
+    schedule,
     factory: DefaultTechDocsCollatorFactory.fromConfig(env.config, {
      discovery: env.discovery,
      tokenManager: env.tokenManager,
     }),
   });

   const { scheduler } = await indexBuilder.build();
-  setTimeout(() => scheduler.start(), 3000);
+  scheduler.start();
/* ... */

+import { TaskInvocationDefinition, TaskRunner } from '@backstage/backend-tasks';

/* ... */

+  const schedule: TaskRunner = {
+    run: async (task: TaskInvocationDefinition) => {
+      const startRefresh = async () => {
+        while (!task.signal?.aborted) {
+          try {
+            await task.fn(task.signal);
+          } catch {
+            // ignore intentionally
+          }
+
+          await new Promise(resolve => setTimeout(resolve, 600 * 1000));
+        }
+      };
+      startRefresh();
+    },
+  };

   indexBuilder.addCollator({
-    defaultRefreshIntervalSeconds: 600,
+    schedule,
     factory: DefaultCatalogCollatorFactory.fromConfig(env.config, {
      discovery: env.discovery,
      tokenManager: env.tokenManager,
     }),
   });

/* ... */

230ad0826f: Bump to using @types/node v16

1882dbda2b: Accept PermissionEvaluator instead of the deprecated PermissionAuthorizer.

Apply the following to packages/backend/src/types.ts:

- import { PermissionAuthorizer } from '@backstage/plugin-permission-common';
+ import { PermissionEvaluator } from '@backstage/plugin-permission-common';

  export type PluginEnvironment = {
    ...
    discovery: PluginEndpointDiscovery;
    tokenManager: TokenManager;
    scheduler: PluginTaskScheduler;
-   permissions: PermissionAuthorizer;
+   permissions: PermissionEvaluator;
  };

0.4.25-next.1

Patch Changes

e80cca164d: Tweaked .eslintrc.js files in the template to avoid having them apply during development. This change does not affect create apps.

0.4.25-next.0

Patch Changes

1691c6c5c2: Made User and Group entity kinds not permitted by the default catalog.rules config.

The effect of this is that after creating a new Backstage repository, its catalog no longer permits regular users to register User or Group entities using the Backstage interface. Additionally, if you have config locations that result in User or Group entities, you need to add those kinds to its own specific rules:
```
catalog:
  locations:
    # This applies for example to url type locations
    - type: url
      target: https://example.com/org.yaml
      rules:
        - allow: [User, Group]
    # But also note that this applies to ALL org location types!
    - type: github-org
      target: https://github.com/my-org-name
      rules:
        - allow: [User, Group]
```
This rule change does NOT affect entity providers, only things that are emitted by entity processors.

We recommend that this change is applied to your own Backstage repository, since it makes it impossible for regular end users to affect your org data through e.g. YAML files. To do so, remove the two kinds from the default rules in your config:
```
 catalog:
   rules:
-    - allow: [Component, System, API, Group, User, Resource, Location]
+    - allow: [Component, System, API, Resource, Location]
```
And for any location that in any way results in org data being ingested, add the corresponding rule to it:
```
 catalog:
   locations:
     - type: github-org
       target: https://github.com/my-org-name
+      rules:
+        - allow: [User, Group]
```

    "lint": "backstage-cli package lint",
    "test": "backstage-cli package test",
    "clean": "backstage-cli package clean",
-   "migrate:create": "knex migrate:make -x ts"

    "express": "^4.17.1",
    "express-promise-router": "^4.1.0",
-   "knex": "^0.21.6",
    "pg": "^8.3.0",

c07d9f9e1c: Add helpful README.md files in the original packages and plugins folders

0.4.24

Patch Changes

89c7e47967: Minor README update
a422d7ce5e: chore(deps): bump @testing-library/react from 11.2.6 to 12.1.3
efc73db10c: The main repo has switched from @vscode/sqlite3 to better-sqlite3 as its preferred SQLite installation. This decision was triggered by a number of issues with the former that arose because it needs build infrastructure in place and functional in order to be installed. The main drawback of this is that the new package uses the database client ID better-sqlite3 instead of the plain sqlite3.

If you want to perform the same switch in your own repository,
- Replace all of your package.json dependencies on @vscode/sqlite3 with the latest version of better-sqlite3 instead
```
 "dependencies": {
-  "@vscode/sqlite3": "^5.0.7",
+  "better-sqlite3": "^7.5.0",
```
- In your app-config and tests, wherever you supply client: 'sqlite3', instead supply client: 'better-sqlite3
```
  backend:
    database:
-    client: sqlite3
+    client: better-sqlite3
```

0.4.23

Patch Changes

f9c7bdd899: Builtin support for cookiecutter based templates has been removed from @backstage/plugin-scaffolder-backend. Due to this, the containerRunner argument to its createRouter has also been removed.

If you do not use cookiecutter templates and are fine with removing support from it in your own installation, update your packages/backend/src/plugins/scaffolder.ts file as follows:

-import { DockerContainerRunner } from '@backstage/backend-common';
 import { CatalogClient } from '@backstage/catalog-client';
 import { createRouter } from '@backstage/plugin-scaffolder-backend';
-import Docker from 'dockerode';
 import { Router } from 'express';
 import type { PluginEnvironment } from '../types';

 export default async function createPlugin({
   reader,
   discovery,
 }: PluginEnvironment): Promise<Router> {
-  const dockerClient = new Docker();
-  const containerRunner = new DockerContainerRunner({ dockerClient });
-
   const catalogClient = new CatalogClient({ discoveryApi: discovery });
-
   return await createRouter({
-    containerRunner,
     logger,
     config,
  // ...

If you want to retain cookiecutter support, please use the @backstage/plugin-scaffolder-backend-module-cookiecutter package explicitly (see its README for installation instructions).

8a57b6595b: Removed the cookiecutter-golang template from the default create-app install as we no longer provide cookiecutter action out of the box.

You can remove the template by removing the following lines from your app-config.yaml under catalog.locations:
```
-    - type: url
-      target: https://github.com/spotify/cookiecutter-golang/blob/master/template.yaml
-      rules:
-        - allow: [Template]
```
e0a69ba49f: build(deps): bump fs-extra from 9.1.0 to 10.0.1
1201383b60: Updated the template to write the Backstage release version to backstage.json, rather than the version of @backstage/create-app. This change is applied automatically when running backstage-cli versions:bump in the latest version of the Backstage CLI.
c543fe3ff2: Postgres-based search is now installed when PG is chosen as the desired database for Backstage.

There is no need to make this change in an existing Backstage backend. See supported search engines for details about production-ready search engines.
55150919ed: - BREAKING: Support for backstage.io/v1beta2 Software Templates has been removed. Please migrate your legacy templates to the new scaffolder.backstage.io/v1beta3 apiVersion by following the migration guide

bde30664c4: Updated template to use package roles. To apply this change to an existing app, check out the migration guide.

Specifically the following scripts in the root package.json have also been updated:

-    "build": "lerna run build",
+    "build": "backstage-cli repo build --all",

...

-    "lint": "lerna run lint --since origin/master --",
-    "lint:all": "lerna run lint --",
+    "lint": "backstage-cli repo lint --since origin/master",
+    "lint:all": "backstage-cli repo lint",

0.4.23-next.0

Patch Changes

If you do not use cookiecutter templates and are fine with removing support from it in your own installation, update your packages/backend/src/plugins/scaffolder.ts file as follows:

-import { DockerContainerRunner } from '@backstage/backend-common';
 import { CatalogClient } from '@backstage/catalog-client';
 import { createRouter } from '@backstage/plugin-scaffolder-backend';
-import Docker from 'dockerode';
 import { Router } from 'express';
 import type { PluginEnvironment } from '../types';

 export default async function createPlugin({
   reader,
   discovery,
 }: PluginEnvironment): Promise<Router> {
-  const dockerClient = new Docker();
-  const containerRunner = new DockerContainerRunner({ dockerClient });
-
   const catalogClient = new CatalogClient({ discoveryApi: discovery });
-
   return await createRouter({
-    containerRunner,
     logger,
     config,
  // ...

If you want to retain cookiecutter support, please use the @backstage/plugin-scaffolder-backend-module-cookiecutter package explicitly (see its README for installation instructions).

8a57b6595b: Removed the cookiecutter-golang template from the default create-app install as we no longer provide cookiecutter action out of the box.

You can remove the template by removing the following lines from your app-config.yaml under catalog.locations:
```
-    - type: url
-      target: https://github.com/spotify/cookiecutter-golang/blob/master/template.yaml
-      rules:
-        - allow: [Template]
```
e0a69ba49f: build(deps): bump fs-extra from 9.1.0 to 10.0.1
1201383b60: Updated the template to write the Backstage release version to backstage.json, rather than the version of @backstage/create-app. This change is applied automatically when running backstage-cli versions:bump in the latest version of the Backstage CLI.
c543fe3ff2: Postgres-based search is now installed when PG is chosen as the desired database for Backstage.

There is no need to make this change in an existing Backstage backend. See supported search engines for details about production-ready search engines.
55150919ed: - BREAKING: Support for backstage.io/v1beta2 Software Templates has been removed. Please migrate your legacy templates to the new scaffolder.backstage.io/v1beta3 apiVersion by following the migration guide

bde30664c4: Updated template to use package roles. To apply this change to an existing app, check out the migration guide.

Specifically the following scripts in the root package.json have also been updated:

-    "build": "lerna run build",
+    "build": "backstage-cli repo build --all",

...

-    "lint": "lerna run lint --since origin/master --",
-    "lint:all": "lerna run lint --",
+    "lint": "backstage-cli repo lint --since origin/master",
+    "lint:all": "backstage-cli repo lint",

0.4.22

Patch Changes

ee3d6c6f10: Update the template to reflect the renaming of DocsResultListItem to TechDocsSearchResultListItem from @backstage/plugin-techdocs.

To apply this change to an existing app, make the following change to packages/app/src/components/search/SearchPage.tsx:

-import { DocsResultListItem } from '@backstage/plugin-techdocs';
+import { TechDocsSearchResultListItem } from '@backstage/plugin-techdocs';

   case 'techdocs':
     return (
-      <DocsResultListItem
+      <TechDocsSearchResultListItem
         key={document.location}
         result={document}
       />

The TechDocsIndexPage now uses DefaultTechDocsHome as fall back if no children is provided as LegacyTechDocsHome is marked as deprecated. If you do not use a custom techdocs homepage, you can therefore update your app to the following:

-  <Route path="/docs" element={<TechDocsIndexPage />}>
-    <DefaultTechDocsHome />
-  </Route>
+  <Route path="/docs" element={<TechDocsIndexPage />} />

617a132871: Update import location of catalogEntityCreatePermission.

To apply this change to an existing app, make the following change to packages/app/src/App.tsx:

-import { catalogEntityCreatePermission } from '@backstage/plugin-catalog-common';
+import { catalogEntityCreatePermission } from '@backstage/plugin-catalog-common/alpha';

022507c860: The Backstage Search Platform's indexing process has been rewritten as a stream pipeline in order to improve efficiency and performance on large document sets.

To take advantage of this, upgrade to the latest version of @backstage/plugin-search-backend-node, as well as any backend plugins whose collators you are using. Then, make the following changes to your /packages/backend/src/plugins/search.ts file:

-import { DefaultCatalogCollator } from '@backstage/plugin-catalog-backend';
-import { DefaultTechDocsCollator } from '@backstage/plugin-techdocs-backend';
+import { DefaultCatalogCollatorFactory } from '@backstage/plugin-catalog-backend';
+import { DefaultTechDocsCollatorFactory } from '@backstage/plugin-techdocs-backend';

// ...

  const indexBuilder = new IndexBuilder({ logger, searchEngine });

  indexBuilder.addCollator({
    defaultRefreshIntervalSeconds: 600,
-    collator: DefaultCatalogCollator.fromConfig(config, { discovery }),
+    factory: DefaultCatalogCollatorFactory.fromConfig(config, { discovery }),
  });

  indexBuilder.addCollator({
    defaultRefreshIntervalSeconds: 600,
-    collator: DefaultTechDocsCollator.fromConfig(config, {
+    factory: DefaultTechDocsCollatorFactory.fromConfig(config, {
      discovery,
      logger,
    }),
  });

If you've written custom collators, decorators, or search engines in your Backstage backend instance, you will need to re-implement them as readable, transform, and writable streams respectively (including factory classes for instantiating them). A how-to guide for refactoring existing implementations is available.

0.4.21

Patch Changes

a686702dbe: Update the template to reflect the renaming of CatalogResultListItem to CatalogSearchResultListItem from @backstage/plugin-catalog.

To apply this change to an existing app, make the following change to packages/app/src/components/search/SearchPage.tsx:

-import { CatalogResultListItem } from '@backstage/plugin-catalog';
+import { CatalogSearchResultListItem } from '@backstage/plugin-catalog';

   case 'software-catalog':
     return (
-      <CatalogResultListItem
+      <CatalogSearchResultListItem
         key={document.location}
         result={document}
       />

f39c1e6036: To reflect the updated knex and @vscode/sqlite3 dependencies introduced with v0.4.19, we update our example Dockerfile, adding @vscode/sqlite3 build dependencies to the image. Further on, we updated it to the node:16-bullseye-slim base image.

To apply this update to an existing app, make the following change to packages/backend/Dockerfile:
```
-FROM node:14-buster-slim
+FROM node:16-bullseye-slim
```
and, only if you are using sqlite3 in your app:
```
RUN tar xzf skeleton.tar.gz && rm skeleton.tar.gz
+
+# install sqlite3 dependencies
+RUN apt-get update && \
+   apt-get install -y libsqlite3-dev python3 cmake g++ && \
+   rm -rf /var/lib/apt/lists/* && \
+   yarn config set python /usr/bin/python3

RUN yarn install --frozen-lockfile --production --network-timeout 300000 && rm -rf "$(yarn cache dir)"
```
If you are using a multi-stage Docker build for your app, please refer to the updated examples in the documentation.

0.4.20

Patch Changes

e725bb812f: Remove SearchContextProvider from <Root />

The SidebarSearchModal exported from plugin-search internally renders SearchContextProvider, so it can be removed from Root.tsx:

-import {
-  SidebarSearchModal,
-  SearchContextProvider,
-} from '@backstage/plugin-search';
+import { SidebarSearchModal } from '@backstage/plugin-search';

... omitted ...

       <SidebarGroup label="Search" icon={<SearchIcon />} to="/search">
-        <SearchContextProvider>
-          <SidebarSearchModal />
-        </SearchContextProvider>
+        <SidebarSearchModal />
       </SidebarGroup>

c77c5c7eb6: Added backstage.role to package.json
Updated dependencies
- @backstage/cli-common@0.1.7

0.4.19

Patch Changes

22f4ecb0e6: Switched the file: dependency for a link: dependency in the backend package. This makes sure that the app package is linked in rather than copied.

To apply this update to an existing app, make the following change to packages/backend/package.json:
```
   "dependencies": {
-    "app": "file:../app",
+    "app": "link:../app",
     "@backstage/backend-common": "^{{version '@backstage/backend-common'}}",
```
1dd5a02e91: BREAKING: Updated knex to major version 1, which also implies changing out the underlying sqlite implementation.

The old sqlite3 NPM library has been abandoned by its maintainers, which has led to unhandled security reports and other issues. Therefore, in the knex 1.x release line they have instead switched over to the @vscode/sqlite3 library by default, which is actively maintained by Microsoft.

This means that as you update to this version of Backstage, there are two breaking changes that you will have to address in your own repository:

Bumping knex itself

All package.json files of your repo that used to depend on a 0.x version of knex, should now be updated to depend on the 1.x release line. This applies in particular to packages/backend, but may also occur in backend plugins or libraries.
```
-    "knex": "^0.95.1",
+    "knex": "^1.0.2",
```
Almost all existing database code will continue to function without modification after this bump. The only significant difference that we discovered in the main repo, is that the alter() function had a slightly different signature in migration files. It now accepts an object with alterType and alterNullable fields that clarify a previous grey area such that the intent of the alteration is made explicit. This is caught by tsc and your editor if you are using the @ts-check and @param syntax in your migration files (example), which we strongly recommend.

See the knex documentation for more information about the alter syntax.

Also see the knex changelog for information about breaking changes in the 1.x line; if you are using RETURNING you may want to make some additional modifications in your code.

Switching out sqlite3

All package.json files of your repo that used to depend on sqlite3, should now be updated to depend on @vscode/sqlite3. This applies in particular to packages/backend, but may also occur in backend plugins or libraries.
```
-    "sqlite3": "^5.0.1",
+    "@vscode/sqlite3": "^5.0.7",
```
These should be functionally equivalent, except that the new library will have addressed some long standing problems with old transitive dependencies etc.

0.4.19-next.0

Patch Changes

22f4ecb0e6: Switched the file: dependency for a link: dependency in the backend package. This makes sure that the app package is linked in rather than copied.

To apply this update to an existing app, make the following change to packages/backend/package.json:
```
   "dependencies": {
-    "app": "file:../app",
+    "app": "link:../app",
     "@backstage/backend-common": "^{{version '@backstage/backend-common'}}",
```
1dd5a02e91: BREAKING: Updated knex to major version 1, which also implies changing out the underlying sqlite implementation.

The old sqlite3 NPM library has been abandoned by its maintainers, which has led to unhandled security reports and other issues. Therefore, in the knex 1.x release line they have instead switched over to the @vscode/sqlite3 library by default, which is actively maintained by Microsoft.

This means that as you update to this version of Backstage, there are two breaking changes that you will have to address in your own repository:

Bumping knex itself

All package.json files of your repo that used to depend on a 0.x version of knex, should now be updated to depend on the 1.x release line. This applies in particular to packages/backend, but may also occur in backend plugins or libraries.
```
-    "knex": "^0.95.1",
+    "knex": "^1.0.2",
```
Almost all existing database code will continue to function without modification after this bump. The only significant difference that we discovered in the main repo, is that the alter() function had a slightly different signature in migration files. It now accepts an object with alterType and alterNullable fields that clarify a previous grey area such that the intent of the alteration is made explicit. This is caught by tsc and your editor if you are using the @ts-check and @param syntax in your migration files (example), which we strongly recommend.

See the knex documentation for more information about the alter syntax.

Also see the knex changelog for information about breaking changes in the 1.x line; if you are using RETURNING you may want to make some additional modifications in your code.

Switching out sqlite3

All package.json files of your repo that used to depend on sqlite3, should now be updated to depend on @vscode/sqlite3. This applies in particular to packages/backend, but may also occur in backend plugins or libraries.
```
-    "sqlite3": "^5.0.1",
+    "@vscode/sqlite3": "^5.0.7",
```
These should be functionally equivalent, except that the new library will have addressed some long standing problems with old transitive dependencies etc.

0.4.18

Patch Changes

5bd0ce9e62: chore(deps): bump inquirer from 7.3.3 to 8.2.0
f27f5197e2: Apply the fix from 0.4.16, which is part of the v0.65.1 release of Backstage.
2687029a67: Update backend-to-backend auth link in configuration file comment

24ef62048c: Adds missing /catalog-graph route to <CatalogGraphPage/>.

To fix this problem for a recently created app please update your app/src/App.tsx

+ import { CatalogGraphPage } from '@backstage/plugin-catalog-graph';

 ... omitted ...

  </Route>
    <Route path="/settings" element={<UserSettingsPage />} />
+   <Route path="/catalog-graph" element={<CatalogGraphPage />} />
  </FlatRoutes>

ba59832aed: Permission the catalog-import route

The following changes are required if you intend to add permissions to your existing app.

Use the PermissionedRoute for CatalogImportPage instead of the normal Route:

// packages/app/src/App.tsx
...
+ import { PermissionedRoute } from '@backstage/plugin-permission-react';
+ import { catalogEntityCreatePermission } from '@backstage/plugin-catalog-common';

...

- <Route path="/catalog-import" element={<CatalogImportPage />} />
+ <PermissionedRoute
+   path="/catalog-import"
+   permission={catalogEntityCreatePermission}
+   element={<CatalogImportPage />}
+ />

cef64b1561: Added tokenManager as a required property for the auth-backend createRouter function. This dependency is used to issue server tokens that are used by the CatalogIdentityClient when looking up users and their group membership during authentication.

These changes are required to packages/backend/src/plugins/auth.ts:
```
export default async function createPlugin({
  logger,
  database,
  config,
  discovery,
+ tokenManager,
}: PluginEnvironment): Promise<Router> {
  return await createRouter({
    logger,
    config,
    database,
    discovery,
+   tokenManager,
  });
}
```
e39d88bd84: Switched the app dependency in the backend to use a file target rather than version.

To apply this change to an existing app, make the following change to packages/backend/package.json:
```
   "dependencies": {
-    "app": "0.0.0",
+    "app": "file:../app",
```

0.4.18-next.1

Patch Changes

5bd0ce9e62: chore(deps): bump inquirer from 7.3.3 to 8.2.0

ba59832aed: Permission the catalog-import route

The following changes are required if you intend to add permissions to your existing app.

Use the PermissionedRoute for CatalogImportPage instead of the normal Route:

// packages/app/src/App.tsx
...
+ import { PermissionedRoute } from '@backstage/plugin-permission-react';
+ import { catalogEntityCreatePermission } from '@backstage/plugin-catalog-common';

...

- <Route path="/catalog-import" element={<CatalogImportPage />} />
+ <PermissionedRoute
+   path="/catalog-import"
+   permission={catalogEntityCreatePermission}
+   element={<CatalogImportPage />}
+ />

0.4.18-next.0

Patch Changes

f27f5197e2: Apply the fix from 0.4.16, which is part of the v0.65.1 release of Backstage.
2687029a67: Update backend-to-backend auth link in configuration file comment

24ef62048c: Adds missing /catalog-graph route to <CatalogGraphPage/>.

To fix this problem for a recently created app please update your app/src/App.tsx

+ import { CatalogGraphPage } from '@backstage/plugin-catalog-graph';

 ... omitted ...

  </Route>
    <Route path="/settings" element={<UserSettingsPage />} />
+   <Route path="/catalog-graph" element={<CatalogGraphPage />} />
  </FlatRoutes>

cef64b1561: Added tokenManager as a required property for the auth-backend createRouter function. This dependency is used to issue server tokens that are used by the CatalogIdentityClient when looking up users and their group membership during authentication.

These changes are required to packages/backend/src/plugins/auth.ts:
```
export default async function createPlugin({
  logger,
  database,
  config,
  discovery,
+ tokenManager,
}: PluginEnvironment): Promise<Router> {
  return await createRouter({
    logger,
    config,
    database,
    discovery,
+   tokenManager,
  });
}
```
e39d88bd84: Switched the app dependency in the backend to use a file target rather than version.

To apply this change to an existing app, make the following change to packages/backend/package.json:
```
   "dependencies": {
-    "app": "0.0.0",
+    "app": "file:../app",
```

0.4.16

Patch Changes

c945cd9f7e: Adds missing /catalog-graph route to <CatalogGraphPage/>.

To fix this problem for a recently created app please update your app/src/App.tsx

+ import { CatalogGraphPage } from '@backstage/plugin-catalog-graph';

 ... omitted ...

  </Route>
    <Route path="/settings" element={<UserSettingsPage />} />
+   <Route path="/catalog-graph" element={<CatalogGraphPage />} />
  </FlatRoutes>

0.4.15

Patch Changes

01b27d547c: Added three additional required properties to the search-backend createRouter function to support filtering search results based on permissions. To make this change to an existing app, add the required parameters to the createRouter call in packages/backend/src/plugins/search.ts:

export default async function createPlugin({
  logger,
+  permissions,
  discovery,
  config,
  tokenManager,
}: PluginEnvironment) {
  /* ... */

  return await createRouter({
    engine: indexBuilder.getSearchEngine(),
+    types: indexBuilder.getDocumentTypes(),
+    permissions,
+    config,
    logger,
  });
}

The .fromConfig of the DefaultCatalogCollator also now takes a tokenManager as a parameter.

-   collator: DefaultCatalogCollator.fromConfig(config, { discovery }),
+   collator: DefaultCatalogCollator.fromConfig(config, { discovery, tokenManager }),

a0d446c8ec: Replaced EntitySystemDiagramCard with EntityCatalogGraphCard

To make this change to an existing app:

Add @backstage/plugin-catalog-graph as a dependency in packages/app/package.json or cd packages/app && yarn add @backstage/plugin-catalog-graph.

Apply the following changes to the packages/app/src/components/catalog/EntityPage.tsx file:

+ import {
+  Direction,
+  EntityCatalogGraphCard,
+ } from '@backstage/plugin-catalog-graph';
+ import {
+  RELATION_API_CONSUMED_BY,
+  RELATION_API_PROVIDED_BY,
+  RELATION_CONSUMES_API,
+  RELATION_DEPENDENCY_OF,
+  RELATION_DEPENDS_ON,
+  RELATION_HAS_PART,
+  RELATION_PART_OF,
+  RELATION_PROVIDES_API,
+ } from '@backstage/catalog-model';

    <EntityLayout.Route path="/diagram" title="Diagram">
-      <EntitySystemDiagramCard />
+      <EntityCatalogGraphCard
+        variant="gridItem"
+        direction={Direction.TOP_BOTTOM}
+        title="System Diagram"
+        height={700}
+        relations={[
+          RELATION_PART_OF,
+          RELATION_HAS_PART,
+          RELATION_API_CONSUMED_BY,
+          RELATION_API_PROVIDED_BY,
+          RELATION_CONSUMES_API,
+          RELATION_PROVIDES_API,
+          RELATION_DEPENDENCY_OF,
+          RELATION_DEPENDS_ON,
+        ]}
+        unidirectional={false}
+      />
    </EntityLayout.Route>

const cicdContent = (
    <Grid item md={6}>
      <EntityAboutCard variant="gridItem" />
    </Grid>
+    <Grid item md={6} xs={12}>
+      <EntityCatalogGraphCard variant="gridItem" height={400} />
+    </Grid>

Add the above component in overviewContent, apiPage , systemPage and domainPage` as well.

4aca2a5307: An example instance of a <SearchFilter.Select /> with asynchronously loaded values was added to the composed SearchPage.tsx, allowing searches bound to the techdocs type to be filtered by entity name.

This is an entirely optional change; if you wish to adopt it, you can make the following (or similar) changes to your search page layout:

--- a/packages/app/src/components/search/SearchPage.tsx
+++ b/packages/app/src/components/search/SearchPage.tsx
@@ -2,6 +2,10 @@ import React from 'react';
 import { makeStyles, Theme, Grid, List, Paper } from '@material-ui/core';

 import { CatalogResultListItem } from '@backstage/plugin-catalog';
+import {
+  catalogApiRef,
+  CATALOG_FILTER_EXISTS,
+} from '@backstage/plugin-catalog-react';
 import { DocsResultListItem } from '@backstage/plugin-techdocs';

 import {
@@ -10,6 +14,7 @@ import {
   SearchResult,
   SearchType,
   DefaultResultListItem,
+  useSearch,
 } from '@backstage/plugin-search';
 import {
   CatalogIcon,
@@ -18,6 +23,7 @@ import {
   Header,
   Page,
 } from '@backstage/core-components';
+import { useApi } from '@backstage/core-plugin-api';

 const useStyles = makeStyles((theme: Theme) => ({
   bar: {
@@ -36,6 +42,8 @@ const useStyles = makeStyles((theme: Theme) => ({

 const SearchPage = () => {
   const classes = useStyles();
+  const { types } = useSearch();
+  const catalogApi = useApi(catalogApiRef);

   return (
     <Page themeId="home">
@@ -65,6 +73,27 @@ const SearchPage = () => {
               ]}
             />
             <Paper className={classes.filters}>
+              {types.includes('techdocs') && (
+                <SearchFilter.Select
+                  className={classes.filter}
+                  label="Entity"
+                  name="name"
+                  values={async () => {
+                    // Return a list of entities which are documented.
+                    const { items } = await catalogApi.getEntities({
+                      fields: ['metadata.name'],
+                      filter: {
+                        'metadata.annotations.backstage.io/techdocs-ref':
+                          CATALOG_FILTER_EXISTS,
+                      },
+                    });
+
+                    const names = items.map(entity => entity.metadata.name);
+                    names.sort();
+                    return names;
+                  }}
+                />
+              )}
               <SearchFilter.Select
                 className={classes.filter}
                 name="kind"

1dbe63ec39: A label prop was added to <SearchFilter.* /> components in order to allow user-friendly label strings (as well as the option to omit a label). In order to maintain labels on your existing filters, add a label prop to them in your SearchPage.tsx.

--- a/packages/app/src/components/search/SearchPage.tsx
+++ b/packages/app/src/components/search/SearchPage.tsx
@@ -96,11 +96,13 @@ const SearchPage = () => {
               )}
               <SearchFilter.Select
                 className={classes.filter}
+                label="Kind"
                 name="kind"
                 values={['Component', 'Template']}
               />
               <SearchFilter.Checkbox
                 className={classes.filter}
+                label="Lifecycle"
                 name="lifecycle"
                 values={['experimental', 'production']}
               />

0.4.14

Patch Changes

d4941024bc: Rebind external route for catalog import plugin from scaffolderPlugin.routes.root to catalogImportPlugin.routes.importPage.

To make this change to an existing app, make the following change to packages/app/src/App.tsx

const App = createApp({
  ...
  bindRoutes({ bind }) {
    ...
    bind(apiDocsPlugin.externalRoutes, {
-     createComponent: scaffolderPlugin.routes.root,
+     registerApi: catalogImportPlugin.routes.importPage,
    });
    ...
  },
});

b5402d6d72: Migrated the app template to React 17.

To apply this change to an existing app, make sure you have updated to the latest version of @backstage/cli, and make the following change to packages/app/package.json:
```
     "history": "^5.0.0",
-    "react": "^16.13.1",
-    "react-dom": "^16.13.1",
+    "react": "^17.0.2",
+    "react-dom": "^17.0.2",
     "react-router": "6.0.0-beta.0",
```
Since we have recently moved over all react and react-dom dependencies to peerDependencies of all packages, and included React 17 in the version range, this should be all you need to do. If you end up with duplicate React installations, first make sure that all of your plugins are up-to-date, including ones for example from @roadiehq. If that doesn't work, you may need to fall back to adding Yarn resolutions in the package.json of your project root:
```
+  "resolutions": {
+    "react": "^17.0.2",
+    "react-dom": "^17.0.2"
+  },
```

5e8d278f8e: Added an external route binding from the org plugin to the catalog index page.

This change is needed because @backstage/plugin-org now has a required external route that needs to be bound for the app to start.

To apply this change to an existing app, make the following change to packages/app/src/App.tsx:

 import { ScaffolderPage, scaffolderPlugin } from '@backstage/plugin-scaffolder';
+import { orgPlugin } from '@backstage/plugin-org';
 import { SearchPage } from '@backstage/plugin-search';

And further down within the createApp call:

     bind(scaffolderPlugin.externalRoutes, {
       registerComponent: catalogImportPlugin.routes.importPage,
     });
+    bind(orgPlugin.externalRoutes, {
+      catalogIndex: catalogPlugin.routes.catalogIndex,
+    });
   },

fb08e2f285: Updated the configuration of the app-backend plugin to enable the static asset store by passing on database from the plugin environment to createRouter.

To apply this change to an existing app, make the following change to packages/backend/src/plugins/app.ts:
```
 export default async function createPlugin({
   logger,
   config,
+  database,
 }: PluginEnvironment): Promise<Router> {
   return await createRouter({
     logger,
     config,
+    database,
     appPackageName: 'app',
   });
 }
```

7ba416be78: You can now add SidebarGroups to the current Sidebar. This will not affect how the current sidebar is displayed, but allows a customization on how the MobileSidebar on smaller screens will look like. A SidebarGroup will be displayed with the given icon in the MobileSidebar.

A SidebarGroup can either link to an existing page (e.g. /search or /settings) or wrap components, which will be displayed in a full-screen overlay menu (e.g. Menu).

<Sidebar>
    <SidebarLogo />
+   <SidebarGroup label="Search" icon={<SearchIcon />} to="/search">
        <SidebarSearchModal />
+   </SidebarGroup>
    <SidebarDivider />
+   <SidebarGroup label="Menu" icon={<MenuIcon />}>
        <SidebarItem icon={HomeIcon} to="catalog" text="Home" />
        <SidebarItem icon={CreateComponentIcon} to="create" text="Create..." />
        <SidebarDivider />
        <SidebarScrollWrapper>
            <SidebarItem icon={MapIcon} to="tech-radar" text="Tech Radar" />
        </SidebarScrollWrapper>
+   </SidebarGroup>
    <SidebarSpace />
    <SidebarDivider />
+   <SidebarGroup
+       label="Settings"
+       icon={<UserSettingsSignInAvatar />}
+       to="/settings"
+   >
        <SidebarSettings />
+   </SidebarGroup>
</Sidebar>

Additionally, you can order the groups differently in the MobileSidebar than in the usual Sidebar simply by giving a group a priority. The groups will be displayed in descending order from left to right.

<SidebarGroup
    label="Settings"
    icon={<UserSettingsSignInAvatar />}
    to="/settings"
+   priority={1}
>
    <SidebarSettings />
</SidebarGroup>

If you decide against adding SidebarGroups to your Sidebar the MobileSidebar will contain one default menu item, which will open a full-screen overlay menu displaying all the content of the current Sidebar.

More information on the SidebarGroup & the MobileSidebar component can be found in the changeset for the core-components.

08fa6a604a: The app template has been updated to add an explicit dependency on typescript in the root package.json. This is because it was removed as a dependency of @backstage/cli in order to decouple the TypeScript versioning in Backstage projects.

To apply this change in an existing app, add a typescript dependency to your package.json in the project root:
```
  "dependencies": {
    ...
    "typescript": "~4.5.4",
  }
```
We recommend using a ~ version range since TypeScript releases do not adhere to semver.

It may be the case that you end up with errors if you upgrade the TypeScript version. This is because there was a change to TypeScript not long ago that defaulted the type of errors caught in catch blocks to unknown. You can work around this by adding "useUnknownInCatchVariables": false to the "compilerOptions" in your tsconfig.json:
```
  "compilerOptions": {
    ...
    "useUnknownInCatchVariables": false
  }
```
Another option is to use the utilities from @backstage/errors to assert the type of errors caught in catch blocks:
```
import { assertError, isError } from '@backstage/errors';

try {
  ...
} catch (error) {
  assertError(error);
  ...
  // OR
  if (isError(error)) {
    ...
  }
}
```
Yet another issue you might run into when upgrading TypeScript is incompatibilities in the types from react-use. The error you would run into looks something like this:
```
node_modules/react-use/lib/usePermission.d.ts:1:54 - error TS2304: Cannot find name 'DevicePermissionDescriptor'.

1 declare type PermissionDesc = PermissionDescriptor | DevicePermissionDescriptor | MidiPermissionDescriptor | PushPermissionDescriptor;
```
If you encounter this error, the simplest fix is to replace full imports of react-use with more specific ones. For example, the following:
```
import { useAsync } from 'react-use';
```
Would be converted into this:
```
import useAsync from 'react-use/lib/useAsync';
```

0.4.13

Patch Changes

fb08e2f285: Updated the configuration of the app-backend plugin to enable the static asset store by passing on database from the plugin environment to createRouter.

To apply this change to an existing app, make the following change to packages/backend/src/plugins/app.ts:
```
 export default async function createPlugin({
   logger,
   config,
+  database,
 }: PluginEnvironment): Promise<Router> {
   return await createRouter({
     logger,
     config,
+    database,
     appPackageName: 'app',
   });
 }
```

A SidebarGroup can either link to an existing page (e.g. /search or /settings) or wrap components, which will be displayed in a full-screen overlay menu (e.g. Menu).

<Sidebar>
    <SidebarLogo />
+   <SidebarGroup label="Search" icon={<SearchIcon />} to="/search">
        <SidebarSearchModal />
+   </SidebarGroup>
    <SidebarDivider />
+   <SidebarGroup label="Menu" icon={<MenuIcon />}>
        <SidebarItem icon={HomeIcon} to="catalog" text="Home" />
        <SidebarItem icon={CreateComponentIcon} to="create" text="Create..." />
        <SidebarDivider />
        <SidebarScrollWrapper>
            <SidebarItem icon={MapIcon} to="tech-radar" text="Tech Radar" />
        </SidebarScrollWrapper>
+   </SidebarGroup>
    <SidebarSpace />
    <SidebarDivider />
+   <SidebarGroup
+       label="Settings"
+       icon={<UserSettingsSignInAvatar />}
+       to="/settings"
+   >
        <SidebarSettings />
+   </SidebarGroup>
</Sidebar>

<SidebarGroup
    label="Settings"
    icon={<UserSettingsSignInAvatar />}
    to="/settings"
+   priority={1}
>
    <SidebarSettings />
</SidebarGroup>

More information on the SidebarGroup & the MobileSidebar component can be found in the changeset for the core-components.

08fa6a604a: The app template has been updated to add an explicit dependency on typescript in the root package.json. This is because it was removed as a dependency of @backstage/cli in order to decouple the TypeScript versioning in Backstage projects.

To apply this change in an existing app, add a typescript dependency to your package.json in the project root:
```
  "dependencies": {
    ...
    "typescript": "~4.5.4",
  }
```
We recommend using a ~ version range since TypeScript releases do not adhere to semver.

It may be the case that you end up with errors if you upgrade the TypeScript version. This is because there was a change to TypeScript not long ago that defaulted the type of errors caught in catch blocks to unknown. You can work around this by adding "useUnknownInCatchVariables": false to the "compilerOptions" in your tsconfig.json:
```
  "compilerOptions": {
    ...
    "useUnknownInCatchVariables": false
  }
```
Another option is to use the utilities from @backstage/errors to assert the type of errors caught in catch blocks:
```
import { assertError, isError } from '@backstage/errors';

try {
  ...
} catch (error) {
  assertError(error);
  ...
  // OR
  if (isError(error)) {
    ...
  }
}
```
Updated dependencies
- @backstage/plugin-tech-radar@0.5.3-next.0
- @backstage/plugin-auth-backend@0.7.0-next.0
- @backstage/core-components@0.8.5-next.0
- @backstage/plugin-api-docs@0.6.23-next.0
- @backstage/plugin-catalog-backend@0.21.0-next.0
- @backstage/plugin-permission-common@0.4.0-next.0
- @backstage/cli@0.12.0-next.0
- @backstage/core-plugin-api@0.6.0-next.0
- @backstage/plugin-catalog@0.7.9-next.0
- @backstage/plugin-user-settings@0.3.17-next.0
- @backstage/backend-common@0.10.4-next.0
- @backstage/config@0.1.13-next.0
- @backstage/plugin-app-backend@0.3.22-next.0
- @backstage/core-app-api@0.5.0-next.0
- @backstage/plugin-catalog-import@0.7.10-next.0
- @backstage/plugin-scaffolder@0.11.19-next.0
- @backstage/plugin-search@0.5.6-next.0
- @backstage/plugin-techdocs@0.12.15-next.0
- @backstage/plugin-permission-node@0.4.0-next.0
- @backstage/catalog-model@0.9.10-next.0
- @backstage/integration-react@0.1.19-next.0
- @backstage/plugin-explore@0.3.26-next.0
- @backstage/plugin-github-actions@0.4.32-next.0
- @backstage/plugin-lighthouse@0.2.35-next.0
- @backstage/plugin-scaffolder-backend@0.15.21-next.0
- @backstage/backend-tasks@0.1.4-next.0
- @backstage/catalog-client@0.5.5-next.0
- @backstage/test-utils@0.2.3-next.0
- @backstage/plugin-proxy-backend@0.2.16-next.0
- @backstage/plugin-rollbar-backend@0.1.19-next.0
- @backstage/plugin-search-backend@0.3.1-next.0
- @backstage/plugin-techdocs-backend@0.12.4-next.0

0.4.12

Patch Changes

5333451def: Cleaned up API exports

cd529c4094: Add permissions to create-app's PluginEnvironment

CatalogEnvironment now has a permissions field, which means that a permission client must now be provided as part of PluginEnvironment. To apply these changes to an existing app, add the following to the makeCreateEnv function in packages/backend/src/index.ts:

  // packages/backend/src/index.ts

+ import { ServerPermissionClient } from '@backstage/plugin-permission-node';

  function makeCreateEnv(config: Config) {
    ...
+   const permissions = ServerPermissionClient.fromConfig(config, {
+     discovery,
+     tokenManager,
+   });

    root.info(`Created UrlReader ${reader}`);

    return (plugin: string): PluginEnvironment => {
      ...
      return {
        logger,
        cache,
        database,
        config,
        reader,
        discovery,
        tokenManager,
        scheduler,
+       permissions,
      };
    }
  }

And add a permissions field to the PluginEnvironment type in packages/backend/src/types.ts:

  // packages/backend/src/types.ts

+ import { PermissionAuthorizer } from '@backstage/plugin-permission-common';

  export type PluginEnvironment = {
    ...
+   permissions: PermissionAuthorizer;
  };

@backstage/plugin-permission-common and @backstage/plugin-permission-node will need to be installed as dependencies:

  // packages/backend/package.json

+   "@backstage/plugin-permission-common": "...",
+   "@backstage/plugin-permission-node": "...",

0.4.11

0.4.10

Patch Changes

79b342bd36: removed inline and internal CSS from index.html

To make this change to an existing app, apply the following changes to the packages/app/public/index.html file:

Remove internal style
```
- <style>
-  #root {
-    min-height: 100%;
-  }
- </style>
```
Remove inline style from the body tag
```
- <body style="margin: 0">
+ <body>
```
d33b65dc52: Removed unused templating asset.
613ad12960: Add a comment to the default backend about the fallback 404 handler.

20af5a701f: The <SearchType /> filter in the composed SearchPage.tsx was replaced with the <SearchType.Accordion /> variant.

This is an entirely optional change; if you wish to display a control surface for search types as a single-select accordion (as opposed to the current multi-select of checkboxes), you can make the following (or similar) changes to your search page layout:

--- a/packages/app/src/components/search/SearchPage.tsx
+++ b/packages/app/src/components/search/SearchPage.tsx
@@ -11,7 +11,7 @@ import {
   SearchType,
   DefaultResultListItem,
 } from '@backstage/plugin-search';
-import { Content, Header, Page } from '@backstage/core-components';
+import { CatalogIcon, Content, DocsIcon, Header, Page } from '@backstage/core-components';

 const useStyles = makeStyles((theme: Theme) => ({
   bar: {
@@ -19,6 +19,7 @@ const useStyles = makeStyles((theme: Theme) => ({
   },
   filters: {
     padding: theme.spacing(2),
+    marginTop: theme.spacing(2),
   },
   filter: {
     '& + &': {
@@ -41,12 +42,23 @@ const SearchPage = () => {
             </Paper>
           </Grid>
           <Grid item xs={3}>
+            <SearchType.Accordion
+              name="Result Type"
+              defaultValue="software-catalog"
+              types={[
+                {
+                  value: 'software-catalog',
+                  name: 'Software Catalog',
+                  icon: <CatalogIcon />,
+                },
+                {
+                  value: 'techdocs',
+                  name: 'Documentation',
+                  icon: <DocsIcon />,
+                },
+              ]}
+            />
             <Paper className={classes.filters}>
-              <SearchType
-                values={['techdocs', 'software-catalog']}
-                name="type"
-                defaultValue="software-catalog"
-              />
               <SearchFilter.Select
                 className={classes.filter}
                 name="kind"

0dcd1dd64f: Add a scheduler to the plugin environment, which can schedule collaborative tasks across backends. To apply the same change in your backend, follow the steps below.

First install the package:

# From the Backstage repository root
cd packages/backend
yarn add @backstage/backend-tasks

Add the scheduler to your plugin environment type:

 // In packages/backend/src/types.ts
+import { PluginTaskScheduler } from '@backstage/backend-tasks';

 export type PluginEnvironment = {
+  scheduler: PluginTaskScheduler;

And finally make sure to add such an instance to each plugin's environment:

 // In packages/backend/src/index.ts
+import { TaskScheduler } from '@backstage/backend-tasks';

 function makeCreateEnv(config: Config) {
   // ...
+  const taskScheduler = TaskScheduler.fromConfig(config);

   return (plugin: string): PluginEnvironment => {
     // ...
+    const scheduler = taskScheduler.forPlugin(plugin);
     return {
+      scheduler,
       // ...

0.4.9

Patch Changes

49a696d720: debounceTime prop is removed from the SearchBar component in the SearchPage as the default is set to 200. The prop is safe to remove and makes it easier to stay up to date with any changes in the future.

5fdc8df0e8: The index.html template of the app has been updated to use the new config global provided by the Backstage CLI.

To apply this change to an existing app, make the following changes to packages/app/public/index.html:

-    <title><%= app.title %></title>
+    <title><%= config.getString('app.title') %></title>

-    <% if (app.googleAnalyticsTrackingId && typeof app.googleAnalyticsTrackingId === 'string') { %>
+    <% if (config.has('app.googleAnalyticsTrackingId')) { %>
     <script
       async
-      src="https://www.googletagmanager.com/gtag/js?id=<%= app.googleAnalyticsTrackingId %>"
+      src="https://www.googletagmanager.com/gtag/js?id=<%= config.getString('app.googleAnalyticsTrackingId') %>"
     ></script>

-      gtag('config', '<%= app.googleAnalyticsTrackingId %>');
+      gtag(
+        'config',
+        '<%= config.getString("app.googleAnalyticsTrackingId") %>',
+      );

0.4.8

Patch Changes

25dfc2d483: Updated the root package.json to include files with .cjs and .mjs extensions in the "lint-staged" configuration.

To make this change to an existing app, apply the following changes to the package.json file:
```
 "lint-staged": {
-    "*.{js,jsx,ts,tsx}": [
+    "*.{js,jsx,ts,tsx,mjs,cjs}": [
```

0.4.7

Patch Changes

9603827bb5: Addressed some peer dependency warnings
1bada775a9: TechDocs Backend may now (optionally) leverage a cache store to improve performance when reading content from a cloud storage provider.

To apply this change to an existing app, pass the cache manager from the plugin environment to the createRouter function in your backend:
```
// packages/backend/src/plugins/techdocs.ts

export default async function createPlugin({
  logger,
  config,
  discovery,
  reader,
+  cache,
}: PluginEnvironment): Promise<Router> {

  // ...

  return await createRouter({
    preparers,
    generators,
    publisher,
    logger,
    config,
    discovery,
+    cache,
  });
```
If your PluginEnvironment does not include a cache manager, be sure you've applied the cache management change to your backend as well.

Additional configuration is required if you wish to enable caching in TechDocs.
4862fbc64f: Bump @spotify/prettier-config
36bb4fb2e9: Removed the scaffolder.github.visibility configuration that is no longer used from the default app template.

0.4.6

Patch Changes

24d2ce03f3: Search Modal now relies on the Search Context to access state and state setter. If you use the SidebarSearchModal as described in the getting started documentation, make sure to update your code with the SearchContextProvider.

export const Root = ({ children }: PropsWithChildren<{}>) => (
  <SidebarPage>
    <Sidebar>
      <SidebarLogo />
-     <SidebarSearchModal />
+     <SearchContextProvider>
+       <SidebarSearchModal />
+     </SearchContextProvider>
      <SidebarDivider />
    ...

905dd952ac: Incorporate usage of the tokenManager into the backend created using create-app.

In existing backends, update the PluginEnvironment to include a tokenManager:

// packages/backend/src/types.ts

...
import {
  ...
+ TokenManager,
} from '@backstage/backend-common';

export type PluginEnvironment = {
  ...
+ tokenManager: TokenManager;
};

Then, create a ServerTokenManager. This can either be a noop that requires no secret and validates all requests by default, or one that uses a secret from your app-config.yaml to generate and validate tokens.

// packages/backend/src/index.ts

...
import {
  ...
+ ServerTokenManager,
} from '@backstage/backend-common';
...

function makeCreateEnv(config: Config) {
  ...
  // CHOOSE ONE
  // TokenManager not requiring a secret
+ const tokenManager = ServerTokenManager.noop();
  // OR TokenManager requiring a secret
+ const tokenManager = ServerTokenManager.fromConfig(config);

  ...
  return (plugin: string): PluginEnvironment => {
    ...
-   return { logger, cache, database, config, reader, discovery };
+   return { logger, cache, database, config, reader, discovery, tokenManager };
  };
}

0.4.5

Patch Changes

dcaeaac174: Cleaned out the peerDependencies in the published version of the package, making it much quicker to run npx @backstage/create-app as it no longer needs to install a long list of unnecessary.
a5a5d7e1f1: DefaultTechDocsCollator is now included in the search backend, and the Search Page updated with the SearchType component that includes the techdocs type
bab752e2b3: Change default port of backend from 7000 to 7007.

This is due to the AirPlay Receiver process occupying port 7000 and preventing local Backstage instances on MacOS to start.

You can change the port back to 7000 or any other value by providing an app-config.yaml with the following values:
```
backend:
  listen: 0.0.0.0:7123
  baseUrl: http://localhost:7123
```
More information can be found here: https://backstage.io/docs/conf/writing
42ebbc18c0: Bump gitbeaker to the latest version

0.4.4

Patch Changes

4ebc9fd277: Create backstage.json file

@backstage/create-app will create a new backstage.json file. At this point, the file will contain a version property, representing the version of @backstage/create-app used for creating the application. If the backstage's application has been bootstrapped using an older version of @backstage/create-app, the backstage.json file can be created and kept in sync, together with all the changes of the latest version of backstage, by running the following script:
```
yarn backstage-cli versions:bump
```
e21e3c6102: Bumping minimum requirements for dockerode and testcontainers
014cbf8cb9: Migrated the app template use the new @backstage/app-defaults for the createApp import, since the createApp exported by @backstage/app-core-api will be removed in the future.

To migrate an existing application, add the latest version of @backstage/app-defaults as a dependency in packages/app/package.json, and make the following change to packages/app/src/App.tsx:
```
-import { createApp, FlatRoutes } from '@backstage/core-app-api';
+import { createApp } from '@backstage/app-defaults';
+import { FlatRoutes } from '@backstage/core-app-api';
```
2163e83fa2: Refactor and add regression tests for create-app tasks
Updated dependencies
- @backstage/cli-common@0.1.6

0.4.3

Patch Changes

5dcea2586c: Integrated SidebarSearchModal component into default-app to use the SearchModal.

The SidebarSearchModal component can also be used in other generated apps:

import {
-  SidebarSearch,
+  SidebarSearchModal
} from '@backstage/plugin-search';
...
 <SidebarPage>
    <Sidebar>
      <SidebarLogo />
-     <SidebarSearch />
+     <SidebarSearchModal />
      <SidebarDivider />
...

If you only want to use the SearchModal you can import it from '@backstage/plugin-search':

import { SearchModal } from '@backstage/plugin-search';

5725f87e4c: Updated the app template to no longer include the --no-private flag for the create-plugin command.

To apply this change to an existing application, remove the --no-private flag from the create-plugin command in the root package.json:

   "prettier:check": "prettier --check .",
-  "create-plugin": "backstage-cli create-plugin --scope internal --no-private",
+  "create-plugin": "backstage-cli create-plugin --scope internal",
   "remove-plugin": "backstage-cli remove-plugin"

1921f70aa7: Removed the version pinning of the packages graphql-language-service-interface and graphql-language-service-parser. This should no longer be necessary.

You can apply the same change in your repository by ensuring that the following does NOT appear in your root package.json.
```
"resolutions": {
  "graphql-language-service-interface": "2.8.2",
  "graphql-language-service-parser": "1.9.0"
  },
```

0.4.2

0.4.1

Patch Changes

4f1c30c176: Support optional path argument when generating a project using create-app
Updated dependencies
- @backstage/cli-common@0.1.5

0.4.0

Minor Changes

5914668655: Removed @backstage/plugin-welcome, no new updates to the packages will be published in the future.

The welcome plugin was used by early alpha versions of Backstage, but today only contained a simple page with welcome instructions. It was superseded by @backstage/plugin-home which can be used to build a homepage customized to the needs of your organization.

If it's still used in your app, remove the dependency from your package.json as well as left over code.

Patch Changes

b486adb8c6: Removed the included jest configuration from the root package.json as the transformModules option no longer exists.

To apply this change to an existing app, make the follow change to the root package.json:
```
-  "jest": {
-    "transformModules": [
-      "@asyncapi/react-component"
-    ]
-  }
```
36e67d2f24: Internal updates to apply more strict checks to throw errors.

0.3.45

Patch Changes

eaca0f53fb: The scaffolder plugin has just released the beta 3 version of software templates, which replaces the handlebars templating syntax. As part of this change, the template entity schema is no longer included in the core catalog-model as with previous versions. The decoupling of the template entities version will allow us to more easily make updates in the future.

In order to use the new beta 3 templates, the following changes are required for any existing installation, inside packages/backend/src/plugins/catalog.ts:
```
+import { ScaffolderEntitiesProcessor } from '@backstage/plugin-scaffolder-backend';

...

   const builder = await CatalogBuilder.create(env);
+  builder.addProcessor(new ScaffolderEntitiesProcessor());
   const { processingEngine, router } = await builder.build();
```
If you're interested in learning more about creating custom kinds, please check out the extending the model documentation.

0.3.44

Patch Changes

e254368371: Switched the default test script in the package root to use backstage-cli test rather than lerna run test. This is thanks to the @backstage/cli now supporting running the test command from the project root.

To apply this change to an existing project, apply the following change to your root package.json:
```
-    "test": "lerna run test --since origin/master -- --coverage",
+    "test": "backstage-cli test",
```
Updated dependencies
- @backstage/cli-common@0.1.4

0.3.43

Patch Changes

9325075eea: Added the default ScmAuth implementation to the app.

To apply this change to an existing app, head to packages/app/apis.ts, import ScmAuth from @backstage/integration-react, and add a ScmAuth.createDefaultApiFactory() to your list of APIs:

 import {
   ScmIntegrationsApi,
   scmIntegrationsApiRef,
+   ScmAuth,
 } from '@backstage/integration-react';

 export const apis: AnyApiFactory[] = [
...
+  ScmAuth.createDefaultApiFactory(),
...
 ];

If you have integrations towards SCM providers other than the default ones (github.com, gitlab.com, etc.), you will want to create a custom ScmAuth factory instead, for example like this:

createApiFactory({
  api: scmAuthApiRef,
  deps: {
    gheAuthApi: gheAuthApiRef,
    githubAuthApi: githubAuthApiRef,
  },
  factory: ({ githubAuthApi, gheAuthApi }) =>
    ScmAuth.merge(
      ScmAuth.forGithub(githubAuthApi),
      ScmAuth.forGithub(gheAuthApi, {
        host: 'ghe.example.com',
      }),
    ),
});

0.3.42

Patch Changes

89fd81a1ab: This change adds an API endpoint for requesting a catalog refresh at /refresh, which is activated if a RefreshService is passed to createRouter. The creation of the router has been abstracted behind the CatalogBuilder to simplify usage and future changes. The following changes are required to your catalog.ts for the refresh endpoint to function.

-  import {
-    CatalogBuilder,
-    createRouter,
-  } from '@backstage/plugin-catalog-backend';
+  import { CatalogBuilder } from '@backstage/plugin-catalog-backend';

  export default async function createPlugin(
    env: PluginEnvironment,
  ): Promise<Router> {
    const builder = await CatalogBuilder.create(env);
-    const {
-      entitiesCatalog,
-      locationAnalyzer,
-      processingEngine,
-      locationService,
-    } = await builder.build();
+   const { processingEngine, router } = await builder.build();
    await processingEngine.start();

-   return await createRouter({
-     entitiesCatalog,
-     locationAnalyzer,
-     locationService,
-     logger: env.logger,
-     config: env.config,
-   });
+   return router;
  }

d0a47c8605: Switched required engine from Node.js 12 or 14, to 14 or 16.

To apply these changes to an existing app, switch out the following in the root package.json:
```
   "engines": {
-    "node": "12 || 14"
+    "node": "14 || 16"
   },
```
Also get rid of the entire engines object in packages/backend/package.json, as it is redundant:
```
-  "engines": {
-    "node": "12 || 14"
-  },
```
df95665e4b: Bumped the default @spotify/prettier-config dependency to ^11.0.0.

This is an optional upgrade, but you may be interested in doing the same, to get the most modern lint rules out there.

0.3.41

0.3.40

Patch Changes

a5013957e: Updated the search configuration class to use the static fromConfig-based constructor for the DefaultCatalogCollator.

To apply this change to an existing app, replace the following line in search.ts:
```
-collator: new DefaultCatalogCollator({ discovery })
+collator: DefaultCatalogCollator.fromConfig(config, { discovery })
```
The config parameter was not needed before, so make sure you also add that in the signature of createPlugin in search.ts:
```
export default async function createPlugin({
  logger,
  discovery,
+  config,
}: PluginEnvironment) {
```
Updated dependencies
- @backstage/cli-common@0.1.3

0.3.39

Patch Changes

25924638b: Minor tweaks to the create-app template to match earlier documented changes

0.3.38

Patch Changes

787bc0826: Wire up TechDocs, which now relies on the composability API for routing.

First, ensure you've mounted <TechDocsReaderPage />. If you already updated to use the composable <TechDocsIndexPage /> (see below), no action is necessary. Otherwise, update your App.tsx so that <TechDocsReaderPage /> is mounted:
```
     <Route path="/docs" element={<TechdocsPage />} />
+    <Route
+      path="/docs/:namespace/:kind/:name/*"
+      element={<TechDocsReaderPage />}
+    />
```
Next, ensure links from the Catalog Entity Page to its TechDocs site are bound:
```
  bindRoutes({ bind }) {
    bind(catalogPlugin.externalRoutes, {
      createComponent: scaffolderPlugin.routes.root,
+     viewTechDoc: techdocsPlugin.routes.docRoot,
    });
```

d02768171: Updated the default create-app EntityPage to include orphan and processing error alerts for all entity types. Previously these were only shown for entities with the Component kind. This also adds the EntityLinkCard for API entities.

As an example, you might add this to your packages/app/src/components/catalog/EntityPage.tsx:

const entityWarningContent = (
  <>
    <EntitySwitch>
      <EntitySwitch.Case if={isOrphan}>
        <Grid item xs={12}>
          <EntityOrphanWarning />
        </Grid>
      </EntitySwitch.Case>
    </EntitySwitch>
    <EntitySwitch>
      <EntitySwitch.Case if={hasCatalogProcessingErrors}>
        <Grid item xs={12}>
          <EntityProcessingErrorsPanel />
        </Grid>
      </EntitySwitch.Case>
    </EntitySwitch>
  </>
);

and then add that at the top of your various content pages:

 const overviewContent = (
   <Grid container spacing={3} alignItems="stretch">
+    {entityWarningContent}
     <Grid item md={6}>
       <EntityAboutCard variant="gridItem" />
     </Grid>

or in actual page wrappers:

 const apiPage = (
   <EntityLayout>
     <EntityLayout.Route path="/" title="Overview">
       <Grid container spacing={3}>
+        {entityWarningContent}
         <Grid item md={6}>
           <EntityAboutCard />
         </Grid>

Note that there may be many such *Page pages in that file, and you probably want that warning at the top of them all.

You can also add the links card to your API page if you do not already have it:

const apiPage = (
  <EntityLayout>
    <EntityLayout.Route path="/" title="Overview">
      <Grid container spacing={3}>
+       {entityWarningContent}
         <Grid item md={6}>
           <EntityAboutCard />
         </Grid>
+        <Grid item md={4} xs={12}>
+          <EntityLinksCard />
+        </Grid>

0.3.37

0.3.36

0.3.35

Patch Changes

362ea5a72: Updated the index page redirect to work with apps served on a different base path than /.

To apply this change to an existing app, remove the / prefix from the target route in the Navigate element in packages/app/src/App.tsx:
```
-<Navigate key="/" to="/catalog" />
+<Navigate key="/" to="catalog" />
```

80582cbec: Use new composable TechDocsIndexPage and DefaultTechDocsHome

Make the following changes to your App.tsx to migrate existing apps:

-    <Route path="/docs" element={<TechdocsPage />} />
+    <Route path="/docs" element={<TechDocsIndexPage />}>
+      <DefaultTechDocsHome />
+    </Route>
+    <Route
+      path="/docs/:namespace/:kind/:name/*"
+      element={<TechDocsReaderPage />}
+    />

c4ef9181a: Migrate to using webpack@5 🎉
56c773909: Add a complete prettier setup to the created project. Prettier used to only be added as a dependency to create apps, but there wasn't a complete setup included that makes it easy to run prettier. That has now changed, and the new prettier:check command can be used to check the formatting of the files in your created project.

To apply this change to an existing app, a couple of changes need to be made.

Create a .prettierignore file at the root of your repository with the following contents:
```
dist
dist-types
coverage
.vscode
```
Next update the root package.json by bumping the prettier version and adding the new prettier:check command:
```
   "scripts": {
     ...
+    "prettier:check": "prettier --check .",
     ...
   },
   ...
   "dependencies": {
     ...
-    "prettier": "^1.19.1"
+    "prettier": "^2.3.2"
   }
```
Finally run yarn prettier --write . on your project to update the existing formatting.
9f8f8dd6b: Removed the / prefix in the catalog SidebarItem element, as it is no longer needed.

To apply this change to an existing app, remove the / prefix from the catalog and any other sidebar items in packages/app/src/components/Root/Root.ts:
```
-<SidebarItem icon={HomeIcon} to="/catalog" text="Home" />
+<SidebarItem icon={HomeIcon} to="catalog" text="Home" />
```
56c773909: Switched @types/react-dom dependency to of the app package to request * rather than a specific version.

To apply this change to an existing app, change the following in packages/app/package.json:
```
-    "@types/react-dom": "^16.9.8",
+    "@types/react-dom": "*",
```

0.3.34

Patch Changes

c189c5da5: fix typo in the comments of EntityPage component
48ea3d25b: The recommended value for a backstage.io/techdocs-ref annotation is now dir:., indicating "documentation source files are located in the same directory relative to the catalog entity." Note that url:<location> values are still supported.
98dda80b4: Update techdocs.generators with the latest techdocs.generator config in app-config.yaml. See https://backstage.io/docs/features/techdocs/configuration for reference and relevant PR https://github.com/backstage/backstage/pull/6071/files for the changes.

0.3.33

Patch Changes

9d40fcb1e: - Bumping material-ui/core version to at least 4.12.2 as they made some breaking changes in later versions which broke Pagination of the Table.
- Switching out material-table to @material-table/core for support for the later versions of material-ui/core
- This causes a minor API change to @backstage/core-components as the interface for Table re-exports the prop from the underlying Table components.
- onChangeRowsPerPage has been renamed to onRowsPerPageChange
- onChangePage has been renamed to onPageChange
- Migration guide is here: https://material-table-core.com/docs/breaking-changes
d50c9e7c0: Update the software-templates to point to main branch instead of master

224e54484: Added an EntityProcessingErrorsPanel component to show any errors that occurred when refreshing an entity from its source location.

If upgrading, this should be added to your EntityPage in your Backstage application:

// packages/app/src/components/catalog/EntityPage.tsx

const overviewContent = (
...
          <EntityOrphanWarning />
        </Grid>
       </EntitySwitch.Case>
    </EntitySwitch>
+   <EntitySwitch>
+     <EntitySwitch.Case if={hasCatalogProcessingErrors}>
+       <Grid item xs={12}>
+         <EntityProcessingErrorsPanel />
+       </Grid>
+     </EntitySwitch.Case>
+   </EntitySwitch>

Additionally, WarningPanel now changes color based on the provided severity.

0.3.32

Patch Changes

03bf17e9b: Improve the responsiveness of the EntityPage UI. With this the Header component should scale with the screen size & wrapping should not cause overflowing/blocking of links. Additionally enforce the Pages using the Grid Layout to use it across all screen sizes & to wrap as intended.

To benefit from the improved responsive layout, the EntityPage in existing Backstage applications should be updated to set the xs column size on each grid item in the page, as this does not default. For example:
```
-  <Grid item md={6}>
+  <Grid item xs={12} md={6}>
```
eb740ee24: Moved sample software templates to the backstage/software-templates repository. If you previously referenced the sample templates straight from scaffolder-backend plugin in the main backstage/backstage repository in your app-config.yaml, these references will need to be updated.

See https://github.com/backstage/software-templates

0.3.31

Patch Changes

ae84b20cf: Revert the upgrade to fs-extra@10.0.0 as that seemed to have broken all installs inexplicably.

0.3.30

Patch Changes

60e830222: Support for Template kinds with version backstage.io/v1alpha1 has now been removed. This means that the old method of running templates with Preparers, Templaters and Publishers has also been removed. If you had any logic in these abstractions, they should now be moved to actions instead, and you can find out more about those in the documentation

If you need any help migrating existing templates, there's a migration guide. Reach out to us on Discord in the #support channel if you're having problems.

The scaffolder-backend now no longer requires these Preparers, Templaters, and Publishers to be passed in, now all it needs is the containerRunner.

Please update your packages/backend/src/plugins/scaffolder.ts like the following

- import {
-  DockerContainerRunner,
-  SingleHostDiscovery,
- } from '@backstage/backend-common';
+ import { DockerContainerRunner } from '@backstage/backend-common';
  import { CatalogClient } from '@backstage/catalog-client';
- import {
-   CookieCutter,
-   CreateReactAppTemplater,
-   createRouter,
-   Preparers,
-   Publishers,
-   Templaters,
- } from '@backstage/plugin-scaffolder-backend';
+ import { createRouter } from '@backstage/plugin-scaffolder-backend';
  import Docker from 'dockerode';
  import { Router } from 'express';
  import type { PluginEnvironment } from '../types';

  export default async function createPlugin({
    config,
    database,
    reader,
+   discovery,
  }: PluginEnvironment): Promise<Router> {
    const dockerClient = new Docker();
    const containerRunner = new DockerContainerRunner({ dockerClient });

-   const cookiecutterTemplater = new CookieCutter({ containerRunner });
-   const craTemplater = new CreateReactAppTemplater({ containerRunner });
-   const templaters = new Templaters();

-   templaters.register('cookiecutter', cookiecutterTemplater);
-   templaters.register('cra', craTemplater);
-
-   const preparers = await Preparers.fromConfig(config, { logger });
-   const publishers = await Publishers.fromConfig(config, { logger });

-   const discovery = SingleHostDiscovery.fromConfig(config);
    const catalogClient = new CatalogClient({ discoveryApi: discovery });

    return await createRouter({
-     preparers,
-     templaters,
-     publishers,
+     containerRunner,
      logger,
      config,
      database,

f7134c368: bump sqlite3 to 5.0.1
e4244f94b: Use SidebarScrollWrapper to improve responsiveness of the current sidebar. Change: Wrap a section of SidebarItems with this component to enable scroll for smaller screens. It can also be used in sidebar plugins (see shortcuts plugin for an example).

0.3.29

Patch Changes

Updated dependencies
- @backstage/cli-common@0.1.2

0.3.28

Patch Changes

48c9fcd33: Migrated to use the new @backstage/core-* packages rather than @backstage/core.

0.3.27

Patch Changes

Updated dependencies
- @backstage/plugin-scaffolder-backend@0.12.2

0.3.26

Patch Changes

5db7445b4: Adding .DS_Store pattern to .gitignore in Scaffolded Backstage App. To migrate an existing app that pattern should be added manually.
```
+# macOS
+.DS_Store
```

b45e29410: This release enables the new catalog processing engine which is a major milestone for the catalog!

This update makes processing more scalable across multiple instances, adds support for deletions and ui flagging of entities that are no longer referenced by a location.

Changes Required to catalog.ts

-import { useHotCleanup } from '@backstage/backend-common';
 import {
   CatalogBuilder,
-  createRouter,
-  runPeriodically
+  createRouter
 } from '@backstage/plugin-catalog-backend';
 import { Router } from 'express';
 import { PluginEnvironment } from '../types';

 export default async function createPlugin(env: PluginEnvironment): Promise<Router> {
-  const builder = new CatalogBuilder(env);
+  const builder = await CatalogBuilder.create(env);
   const {
     entitiesCatalog,
     locationsCatalog,
-    higherOrderOperation,
+    locationService,
+    processingEngine,
     locationAnalyzer,
   } = await builder.build();

-  useHotCleanup(
-    module,
-    runPeriodically(() => higherOrderOperation.refreshAllLocations(), 100000),
-  );
+  await processingEngine.start();

   return await createRouter({
     entitiesCatalog,
     locationsCatalog,
-    higherOrderOperation,
+    locationService,
     locationAnalyzer,
     logger: env.logger,
     config: env.config,

As this is a major internal change we have taken some precaution by still allowing the old catalog to be enabled by keeping your catalog.ts in it's current state. If you encounter any issues and have to revert to the previous catalog engine make sure to raise an issue immediately as the old catalog engine is deprecated and will be removed in a future release.

772dbdb51: Deprecates SingleConnectionDatabaseManager and provides an API compatible database connection manager, DatabaseManager, which allows developers to configure database connections on a per plugin basis.

The backend.database config path allows you to set prefix to use an alternate prefix for automatically generated database names, the default is backstage_plugin_. Use backend.database.plugin.<pluginId> to set plugin specific database connection configuration, e.g.

backend:
  database:
    client: 'pg',
    prefix: 'custom_prefix_'
    connection:
      host: 'localhost'
      user: 'foo'
      password: 'bar'
    plugin:
      catalog:
        connection:
          database: 'database_name_overriden'
      scaffolder:
        client: 'sqlite3'
        connection: ':memory:'

Migrate existing backstage installations by swapping out the database manager in the packages/backend/src/index.ts file as shown below:

import {
-  SingleConnectionDatabaseManager,
+  DatabaseManager,
} from '@backstage/backend-common';

// ...

function makeCreateEnv(config: Config) {
  // ...
-  const databaseManager = SingleConnectionDatabaseManager.fromConfig(config);
+  const databaseManager = DatabaseManager.fromConfig(config);
  // ...
}

Updated dependencies
- @backstage/plugin-catalog@0.6.3
- @backstage/plugin-search-backend-node@0.2.1
- @backstage/plugin-catalog-backend@0.10.3
- @backstage/backend-common@0.8.3
- @backstage/cli@0.7.1
- @backstage/plugin-api-docs@0.5.0
- @backstage/plugin-scaffolder-backend@0.12.1
- @backstage/plugin-techdocs@0.9.6
- @backstage/plugin-techdocs-backend@0.8.3
- @backstage/plugin-catalog-import@0.5.10
- @backstage/plugin-app-backend@0.3.14
- @backstage/plugin-proxy-backend@0.2.10
- @backstage/plugin-rollbar-backend@0.1.12
- @backstage/plugin-search-backend@0.2.1
- @backstage/plugin-user-settings@0.2.11
- @backstage/catalog-model@0.8.3
- @backstage/plugin-auth-backend@0.3.13
- @backstage/core@0.7.13

0.3.25

Patch Changes

4f8cf50fe: Updated the @gitbeaker/node dependency past the broken one without a dist folder.

See this issue for more details.

If you get build errors that look like the following in your Backstage instance, you may want to also bump all of your @gitbeaker/* dependencies to at least ^30.2.0.

node:internal/modules/cjs/loader:356
      throw err;
      ^

Error: Cannot find module '/path/to/project/node_modules/@gitbeaker/node/dist/index.js'. Please verify that the package.json has a valid "main" entry
    at tryPackage (node:internal/modules/cjs/loader:348:19)
    at Function.Module._findPath (node:internal/modules/cjs/loader:561:18)
    at Function.Module._resolveFilename (node:internal/modules/cjs/loader:926:27)
    at Function.Module._load (node:internal/modules/cjs/loader:773:27)
    at Module.require (node:internal/modules/cjs/loader:1012:19)
    at require (node:internal/modules/cjs/helpers:93:18)
    at Object.<anonymous> (/path/to/project/test.js:4:18)
    at Module._compile (node:internal/modules/cjs/loader:1108:14)
    at Object.Module._extensions..js (node:internal/modules/cjs/loader:1137:10)
    at Module.load (node:internal/modules/cjs/loader:988:32) {
  code: 'MODULE_NOT_FOUND',
  path: '/path/to/project/node_modules/@gitbeaker/node/package.json',
  requestPath: '@gitbeaker/node'
}

you could also consider pinning the version to an older one in your package.json either root or packages/backend/package.json, before the breakage occurred.

"resolutions": {
    "**/@gitbeaker/node": "29.2.4",
    "**/@gitbeaker/core": "29.2.4",
    "**/@gitbeaker/requester-utils": "29.2.4"
}

Be aware that this is only required short term until we can release our updated versions of @backstage/plugin-scaffolder-backend.

55a253de2: Migrating old backstage.io/v1alpha1 templates to backstage.io/v1beta2

Deprecating the create-react-app Template. We're planning on removing the create-react-app templater, as it's been a little tricky to support and takes 15mins to run in a container. We've currently cached a copy of the output for create-react-app and ship that under our sample templates folder. If you want to continue using it, we suggest copying the template out of there and putting it in your own repository as it will be removed in upcoming releases.

We also recommend removing this entry from your app-config.yaml if it exists:
```
-    - type: url
-      target: https://github.com/backstage/backstage/blob/master/plugins/scaffolder-backend/sample-templates/create-react-app/template.yaml
-      rules:
-        - allow: [Template]
```

509b5638c: Added "out-of-the-box" alpha-milestone search features to scaffolded Backstage apps.

To apply this change to an existing app, do the following...

First, navigate to your backend package and install the two new search backend packages:

cd packages/backend
yarn add @backstage/plugin-search-backend @backstage/plugin-search-backend-node

Wire up these new packages into your app backend by first creating a new search.ts file at src/plugins/search.ts with contents like the following:

import { useHotCleanup } from '@backstage/backend-common';
import { createRouter } from '@backstage/plugin-search-backend';
import {
  IndexBuilder,
  LunrSearchEngine,
} from '@backstage/plugin-search-backend-node';
import { PluginEnvironment } from '../types';
import { DefaultCatalogCollator } from '@backstage/plugin-catalog-backend';

export default async function createPlugin({
  logger,
  discovery,
}: PluginEnvironment) {
  // Initialize a connection to a search engine.
  const searchEngine = new LunrSearchEngine({ logger });
  const indexBuilder = new IndexBuilder({ logger, searchEngine });

  // Collators are responsible for gathering documents known to plugins. This
  // particular collator gathers entities from the software catalog.
  indexBuilder.addCollator({
    defaultRefreshIntervalSeconds: 600,
    collator: new DefaultCatalogCollator({ discovery }),
  });

  // The scheduler controls when documents are gathered from collators and sent
  // to the search engine for indexing.
  const { scheduler } = await indexBuilder.build();

  // A 3 second delay gives the backend server a chance to initialize before
  // any collators are executed, which may attempt requests against the API.
  setTimeout(() => scheduler.start(), 3000);
  useHotCleanup(module, () => scheduler.stop());

  return await createRouter({
    engine: indexBuilder.getSearchEngine(),
    logger,
  });
}

Then, ensure the search plugin you configured above is initialized by modifying your backend's index.ts file in the following ways:

+import search from './plugins/search';
// ...
+const searchEnv = useHotMemoize(module, () => createEnv('search'));
// ...
+apiRouter.use('/search', await search(searchEnv));
// ...

In your frontend app package, create a new searchPage component at, for example, packages/app/src/components/search/SearchPage.tsx with contents like the following:

import React from 'react';
import { makeStyles, Theme, Grid, List, Paper } from '@material-ui/core';

import { Content, Header, Lifecycle, Page } from '@backstage/core';
import { CatalogResultListItem } from '@backstage/plugin-catalog';
import {
  SearchBar,
  SearchFilter,
  SearchResult,
  DefaultResultListItem,
} from '@backstage/plugin-search';

const useStyles = makeStyles((theme: Theme) => ({
  bar: {
    padding: theme.spacing(1, 0),
  },
  filters: {
    padding: theme.spacing(2),
  },
  filter: {
    '& + &': {
      marginTop: theme.spacing(2.5),
    },
  },
}));

const SearchPage = () => {
  const classes = useStyles();

  return (
    <Page themeId="home">
      <Header title="Search" subtitle={<Lifecycle alpha />} />
      <Content>
        <Grid container direction="row">
          <Grid item xs={12}>
            <Paper className={classes.bar}>
              <SearchBar debounceTime={100} />
            </Paper>
          </Grid>
          <Grid item xs={3}>
            <Paper className={classes.filters}>
              <SearchFilter.Select
                className={classes.filter}
                name="kind"
                values={['Component', 'Template']}
              />
              <SearchFilter.Checkbox
                className={classes.filter}
                name="lifecycle"
                values={['experimental', 'production']}
              />
            </Paper>
          </Grid>
          <Grid item xs={9}>
            <SearchResult>
              {({ results }) => (
                <List>
                  {results.map(({ type, document }) => {
                    switch (type) {
                      case 'software-catalog':
                        return (
                          <CatalogResultListItem
                            key={document.location}
                            result={document}
                          />
                        );
                      default:
                        return (
                          <DefaultResultListItem
                            key={document.location}
                            result={document}
                          />
                        );
                    }
                  })}
                </List>
              )}
            </SearchResult>
          </Grid>
        </Grid>
      </Content>
    </Page>
  );
};

export const searchPage = <SearchPage />;

Then in App.tsx, import this new searchPage component, and set it as a child of the existing <SearchPage /> route so that it looks like this:

+import { searchPage } from './components/search/SearchPage';
// ...
-<Route path="/search" element={<SearchPage />} />
+<Route path="/search" element={<SearchPage />}>
+  {searchPage}
+</Route>

Updated dependencies [9cd3c533c]
Updated dependencies [db1c8f93b]
Updated dependencies [9c63be545]
Updated dependencies [9bdd2cca8]
Updated dependencies [92963779b]
Updated dependencies [27a9b503a]
Updated dependencies [f4e3ac5ce]
Updated dependencies [66c6bfebd]
Updated dependencies [9b4010965]
Updated dependencies [7f7443308]
Updated dependencies [55a253de2]
Updated dependencies [7028ee1ca]
Updated dependencies [70bc30c5b]
Updated dependencies [db1c8f93b]
Updated dependencies [5aff84759]
Updated dependencies [5aff84759]
Updated dependencies [f26e6008f]
Updated dependencies [21e8ebef5]
Updated dependencies [4fbb00707]
Updated dependencies [eda9dbd5f]
Updated dependencies [4f8cf50fe]
Updated dependencies [d5ad47bbb]
Updated dependencies [875809a59]
- @backstage/cli@0.7.0
- @backstage/plugin-catalog@0.6.2
- @backstage/plugin-catalog-backend@0.10.2
- @backstage/plugin-github-actions@0.4.9
- @backstage/backend-common@0.8.2
- @backstage/catalog-model@0.8.2
- @backstage/plugin-scaffolder@0.9.8
- @backstage/plugin-scaffolder-backend@0.12.0
- @backstage/integration-react@0.1.3
- @backstage/catalog-client@0.3.13
- @backstage/plugin-catalog-import@0.5.9
- @backstage/plugin-search-backend-node@0.2.0
- @backstage/plugin-search@0.4.0
- @backstage/plugin-search-backend@0.2.0
- @backstage/plugin-proxy-backend@0.2.9
- @backstage/core@0.7.12
- @backstage/errors@0.1.1
- @backstage/test-utils@0.1.13
- @backstage/theme@0.2.8
- @backstage/plugin-api-docs@0.4.15
- @backstage/plugin-app-backend@0.3.13
- @backstage/plugin-auth-backend@0.3.12
- @backstage/plugin-explore@0.3.6
- @backstage/plugin-lighthouse@0.2.17
- @backstage/plugin-rollbar-backend@0.1.11
- @backstage/plugin-tech-radar@0.4.0
- @backstage/plugin-techdocs@0.9.5
- @backstage/plugin-techdocs-backend@0.8.2
- @backstage/plugin-user-settings@0.2.10

0.3.24

Patch Changes

1ddf551f4: Add CLI output and README how to start app after create-app CLI
Updated dependencies [7af9cef07]
Updated dependencies [497f4ce18]
Updated dependencies [ee4eb5b40]
Updated dependencies [84160313e]
Updated dependencies [3772de8ba]
Updated dependencies [7e7c71417]
Updated dependencies [f430b6c6f]
Updated dependencies [2a942cc9e]
Updated dependencies [e7c5e4b30]
Updated dependencies [ebe802bc4]
Updated dependencies [1cf1d351f]
Updated dependencies [90a505a77]
Updated dependencies [76f99a1a0]
Updated dependencies [1157fa307]
Updated dependencies [6fe1567a7]
Updated dependencies [e7a5a3474]
Updated dependencies [2305ab8fc]
Updated dependencies [054bcd029]
Updated dependencies [aad98c544]
Updated dependencies [63a432e9c]
Updated dependencies [f46a9e82d]
- @backstage/test-utils@0.1.13
- @backstage/plugin-scaffolder@0.9.7
- @backstage/cli@0.6.14
- @backstage/plugin-catalog@0.6.1
- @backstage/theme@0.2.8
- @backstage/catalog-model@0.8.1
- @backstage/core@0.7.12
- @backstage/plugin-tech-radar@0.4.0
- @backstage/plugin-scaffolder-backend@0.11.5
- @backstage/plugin-catalog-backend@0.10.1
- @backstage/plugin-techdocs@0.9.5

0.3.23

Patch Changes

6c4bd674c: Cache management has been added to the Backstage backend.

To apply this change to an existing app, make the following changes:

// packages/backend/src/types.ts

import { Logger } from 'winston';
import { Config } from '@backstage/config';
import {
+  PluginCacheManager,
  PluginDatabaseManager,
  PluginEndpointDiscovery,
  UrlReader,
} from '@backstage/backend-common';

export type PluginEnvironment = {
  logger: Logger;
  database: PluginDatabaseManager;
+  cache: PluginCacheManager;
  config: Config;
  reader: UrlReader
  discovery: PluginEndpointDiscovery;
};

// packages/backend/src/index.ts

import Router from 'express-promise-router';
import {
  createServiceBuilder,
  loadBackendConfig,
  getRootLogger,
  useHotMemoize,
  notFoundHandler,
+  CacheManager,
  SingleConnectionDatabaseManager,
  SingleHostDiscovery,
  UrlReaders,
} from '@backstage/backend-common';
import { Config } from '@backstage/config';

function makeCreateEnv(config: Config) {
  const root = getRootLogger();
  const reader = UrlReaders.default({ logger: root, config });
  const discovery = SingleHostDiscovery.fromConfig(config);

  root.info(`Created UrlReader ${reader}`);

  const databaseManager = SingleConnectionDatabaseManager.fromConfig(config);
+  const cacheManager = CacheManager.fromConfig(config);

  return (plugin: string): PluginEnvironment => {
    const logger = root.child({ type: 'plugin', plugin });
    const database = databaseManager.forPlugin(plugin);
-    return { logger, database, config, reader, discovery };
+    const cache = cacheManager.forPlugin(plugin);
+    return { logger, database, cache, config, reader, discovery };
  };
}

To configure a cache store, add a backend.cache key to your app-config.yaml.

// app-config.yaml

backend:
  baseUrl: http://localhost:7000
  listen:
    port: 7000
  database:
    client: sqlite3
    connection: ':memory:'
+  cache:
+    store: memory

f86ab6d49: Added newer entity relationship cards to the default @backstage/create-app template:
- EntityDependsOnComponentsCard
- EntityDependsOnResourcesCard
- EntityHasResourcesCard
- EntityHasSubcomponentsCard
The EntityLinksCard was also added to the overview page. To apply these to your Backstage application, compare against the updated EntityPage.tsx
260aaa684: Bumped the @gitbeaker dependencies to 29.x.

To apply this change to an existing app, update all @gitbeaker/* dependencies in your package.jsons to point to ^29.2.0. Then run yarn install at the root of your project.
Updated dependencies [0fd4ea443]
Updated dependencies [add62a455]
Updated dependencies [cc592248b]
Updated dependencies [17c497b81]
Updated dependencies [1cd0cacd9]
Updated dependencies [4ea9df9d3]
Updated dependencies [7a7da5146]
Updated dependencies [bf805b467]
Updated dependencies [203ce6f6f]
Updated dependencies [7ab5bfe68]
Updated dependencies [260aaa684]
Updated dependencies [704875e26]
Updated dependencies [3a181cff1]
- @backstage/plugin-catalog-backend@0.10.0
- @backstage/catalog-client@0.3.12
- @backstage/catalog-model@0.8.0
- @backstage/core@0.7.11
- @backstage/plugin-catalog@0.6.0
- @backstage/cli@0.6.13
- @backstage/plugin-techdocs@0.9.4
- @backstage/plugin-scaffolder-backend@0.11.4
- @backstage/plugin-api-docs@0.4.15
- @backstage/plugin-auth-backend@0.3.12
- @backstage/plugin-catalog-import@0.5.8
- @backstage/plugin-explore@0.3.6
- @backstage/plugin-github-actions@0.4.8
- @backstage/plugin-lighthouse@0.2.17
- @backstage/plugin-scaffolder@0.9.6
- @backstage/plugin-search@0.3.7
- @backstage/plugin-techdocs-backend@0.8.2

0.3.22

Patch Changes

3be844496: chore: bump ts-node versions to 9.1.1
Updated dependencies [062bbf90f]
Updated dependencies [2cd70e164]
Updated dependencies [0b033d07b]
Updated dependencies [3be844496]
Updated dependencies [5542de095]
Updated dependencies [22fd8ce2a]
Updated dependencies [10c008a3a]
Updated dependencies [82ca1ac22]
Updated dependencies [81ef1d57b]
Updated dependencies [f9fb4a205]
Updated dependencies [e3fc89df6]
Updated dependencies [9a207f052]
Updated dependencies [889d89b6e]
Updated dependencies [16be1d093]
Updated dependencies [fd39d4662]
Updated dependencies [3f988cb63]
Updated dependencies [675a569a9]
- @backstage/core@0.7.9
- @backstage/integration-react@0.1.2
- @backstage/test-utils@0.1.11
- @backstage/plugin-api-docs@0.4.13
- @backstage/plugin-catalog@0.5.7
- @backstage/plugin-catalog-import@0.5.6
- @backstage/plugin-explore@0.3.5
- @backstage/plugin-github-actions@0.4.6
- @backstage/plugin-lighthouse@0.2.16
- @backstage/plugin-scaffolder@0.9.4
- @backstage/plugin-scaffolder-backend@0.11.1
- @backstage/plugin-search@0.3.6
- @backstage/plugin-tech-radar@0.3.11
- @backstage/plugin-techdocs@0.9.2
- @backstage/plugin-user-settings@0.2.10
- @backstage/cli@0.6.11
- @backstage/backend-common@0.8.0
- @backstage/catalog-model@0.7.9
- @backstage/plugin-catalog-backend@0.9.0
- @backstage/plugin-app-backend@0.3.13
- @backstage/plugin-auth-backend@0.3.10
- @backstage/plugin-proxy-backend@0.2.8
- @backstage/plugin-rollbar-backend@0.1.11
- @backstage/plugin-techdocs-backend@0.8.1

0.3.21

Patch Changes

38ca05168: The default @octokit/rest dependency was bumped to "^18.5.3".

e0bfd3d44: The scaffolder-backend and techdocs-backend plugins have been updated. In order to update, you need to apply the following changes to your existing backend application:

@backstage/plugin-techdocs-backend:

// packages/backend/src/plugin/techdocs.ts

+ import { DockerContainerRunner } from '@backstage/backend-common';

  export default async function createPlugin({
    logger,
    config,
    discovery,
    reader,
  }: PluginEnvironment): Promise<Router> {
    // Preparers are responsible for fetching source files for documentation.
    const preparers = await Preparers.fromConfig(config, {
      logger,
      reader,
    });

+   // Docker client (conditionally) used by the generators, based on techdocs.generators config.
+   const dockerClient = new Docker();
+   const containerRunner = new DockerContainerRunner({ dockerClient });

    // Generators are used for generating documentation sites.
    const generators = await Generators.fromConfig(config, {
      logger,
+     containerRunner,
    });

    // Publisher is used for
    // 1. Publishing generated files to storage
    // 2. Fetching files from storage and passing them to TechDocs frontend.
    const publisher = await Publisher.fromConfig(config, {
      logger,
      discovery,
    });

    // checks if the publisher is working and logs the result
    await publisher.getReadiness();

-   // Docker client (conditionally) used by the generators, based on techdocs.generators config.
-   const dockerClient = new Docker();

    return await createRouter({
      preparers,
      generators,
      publisher,
-     dockerClient,
      logger,
      config,
      discovery,
    });
  }

@backstage/plugin-scaffolder-backend:

// packages/backend/src/plugin/scaffolder.ts

- import { SingleHostDiscovery } from '@backstage/backend-common';
+ import {
+   DockerContainerRunner,
+   SingleHostDiscovery,
+ } from '@backstage/backend-common';

  export default async function createPlugin({
    logger,
    config,
    database,
    reader,
  }: PluginEnvironment): Promise<Router> {
+   const dockerClient = new Docker();
+   const containerRunner = new DockerContainerRunner({ dockerClient });

+   const cookiecutterTemplater = new CookieCutter({ containerRunner });
-   const cookiecutterTemplater = new CookieCutter();
+   const craTemplater = new CreateReactAppTemplater({ containerRunner });
-   const craTemplater = new CreateReactAppTemplater();
    const templaters = new Templaters();

    templaters.register('cookiecutter', cookiecutterTemplater);
    templaters.register('cra', craTemplater);

    const preparers = await Preparers.fromConfig(config, { logger });
    const publishers = await Publishers.fromConfig(config, { logger });

-   const dockerClient = new Docker();

    const discovery = SingleHostDiscovery.fromConfig(config);
    const catalogClient = new CatalogClient({ discoveryApi: discovery });

    return await createRouter({
      preparers,
      templaters,
      publishers,
      logger,
      config,
-     dockerClient,
      database,
      catalogClient,
      reader,
    });
  }

Updated dependencies [e0bfd3d44]
Updated dependencies [e0bfd3d44]
Updated dependencies [e0bfd3d44]
Updated dependencies [38ca05168]
Updated dependencies [f65adcde7]
Updated dependencies [80888659b]
Updated dependencies [b219821a0]
Updated dependencies [7b8272fb7]
Updated dependencies [8aedbb4af]
Updated dependencies [fc79a6dd3]
Updated dependencies [69eefb5ae]
Updated dependencies [75c8cec39]
Updated dependencies [b2e2ec753]
Updated dependencies [227439a72]
Updated dependencies [9314a8592]
Updated dependencies [2e05277e0]
Updated dependencies [4075c6367]
Updated dependencies [cdb3426e5]
Updated dependencies [d8b81fd28]
Updated dependencies [d1b1306d9]
- @backstage/plugin-scaffolder-backend@0.11.0
- @backstage/backend-common@0.7.0
- @backstage/plugin-techdocs-backend@0.8.0
- @backstage/plugin-catalog-import@0.5.5
- @backstage/plugin-github-actions@0.4.5
- @backstage/cli@0.6.10
- @backstage/core@0.7.8
- @backstage/plugin-catalog-backend@0.8.2
- @backstage/theme@0.2.7
- @backstage/plugin-tech-radar@0.3.10
- @backstage/plugin-scaffolder@0.9.3
- @backstage/plugin-techdocs@0.9.1
- @backstage/plugin-proxy-backend@0.2.7
- @backstage/catalog-model@0.7.8
- @backstage/config@0.1.5
- @backstage/catalog-client@0.3.11
- @backstage/plugin-app-backend@0.3.12
- @backstage/plugin-auth-backend@0.3.9
- @backstage/plugin-rollbar-backend@0.1.10

0.3.20

Patch Changes

73f3f5d78: Updates the end to end test in the app to match the new catalog index page title. To apply this change to an existing app, update packages/app/cypress/integration/app.js to search for "My Company Catalog" instead of "My Company Service Catalog".
Updated dependencies [1ce80ff02]
Updated dependencies [4c42ecca2]
Updated dependencies [c614ede9a]
Updated dependencies [9afcac5af]
Updated dependencies [07a7806c3]
Updated dependencies [f6efa71ee]
Updated dependencies [19a4dd710]
Updated dependencies [a99e0bc42]
Updated dependencies [dcd54c7cd]
Updated dependencies [da546ce00]
Updated dependencies [e0c9ed759]
Updated dependencies [6fbd7beca]
Updated dependencies [15cbe6815]
Updated dependencies [39bdaa004]
Updated dependencies [cb8c848a3]
Updated dependencies [21fddf452]
Updated dependencies [17915e29b]
Updated dependencies [a1783f306]
Updated dependencies [6eaecbd81]
Updated dependencies [23769512a]
Updated dependencies [1a142ae8a]
- @backstage/plugin-api-docs@0.4.12
- @backstage/plugin-github-actions@0.4.4
- @backstage/plugin-catalog-import@0.5.4
- @backstage/plugin-explore@0.3.4
- @backstage/plugin-lighthouse@0.2.15
- @backstage/core@0.7.7
- @backstage/plugin-scaffolder@0.9.2
- @backstage/plugin-catalog@0.5.6
- @backstage/plugin-catalog-backend@0.8.1
- @backstage/plugin-search@0.3.5
- @backstage/plugin-techdocs@0.9.0
- @backstage/plugin-scaffolder-backend@0.10.1

0.3.19

Patch Changes

ee22773e9: Removed plugins.ts from the app, as plugins are now discovered through the react tree.

To apply this change to an existing app, simply delete packages/app/src/plugins.ts along with the import and usage in packages/app/src/App.tsx.

Note that there are a few plugins that require explicit registration, in which case you would need to keep them in plugins.ts. The set of plugins that need explicit registration is any plugin that doesn't have a component extension that gets rendered as part of the app element tree. An example of such a plugin in the main Backstage repo is @backstage/plugin-badges. In the case of the badges plugin this is because there is not yet a component-based API for adding context menu items to the entity layout.

If you have plugins that still rely on route registration through the register method of createPlugin, these need to be kept in plugins.ts as well. However, it is recommended to migrate these to export an extensions component instead.
670acd88e: Fix system diagram card to be on the system page

To apply the same fix to an existing application, in EntityPage.tsx simply move the <EntityLayout.route> for the /diagram path from the groupPage down into the systemPage element.
Updated dependencies [94da20976]
Updated dependencies [84c54474d]
Updated dependencies [d8cc7e67a]
Updated dependencies [4e5c94249]
Updated dependencies [99fbef232]
Updated dependencies [cb0206b2b]
Updated dependencies [1373f4f12]
Updated dependencies [29a7e4be8]
Updated dependencies [ab07d77f6]
Updated dependencies [49574a8a3]
Updated dependencies [d367f63b5]
Updated dependencies [96728a2af]
Updated dependencies [5fe62f124]
Updated dependencies [931b21a12]
Updated dependencies [937ed39ce]
Updated dependencies [87c4f59de]
Updated dependencies [09b5fcf2e]
Updated dependencies [b42531cfe]
Updated dependencies [c2306f898]
Updated dependencies [9a9e7a42f]
Updated dependencies [50ce875a0]
Updated dependencies [ac6025f63]
Updated dependencies [e292e393f]
Updated dependencies [479b29124]
- @backstage/core@0.7.6
- @backstage/plugin-scaffolder-backend@0.10.0
- @backstage/cli@0.6.9
- @backstage/plugin-scaffolder@0.9.1
- @backstage/plugin-catalog-import@0.5.3
- @backstage/plugin-rollbar-backend@0.1.9
- @backstage/backend-common@0.6.3
- @backstage/plugin-catalog@0.5.5
- @backstage/plugin-catalog-backend@0.8.0
- @backstage/theme@0.2.6
- @backstage/plugin-techdocs@0.8.0

0.3.18

Patch Changes

b49a525ab: Fixing dependency resolution for problematic library graphql-language-service-interface.

This change might not have to be applied to your local installation, however if you run into this error:

Error: Failed to compile.
/tmp/backstage-e2e-uMeycm/test-app/node_modules/graphql-language-service-interface/esm/GraphQLLanguageService.js 100:23
Module parse failed: Unexpected token (100:23)
You may need an appropriate loader to handle this file type, currently no loaders are configured to process this file. See https://webpack.js.org/concepts#loaders
|         }
|         let customRules = null;
>         if (extensions?.customValidationRules &&
|             typeof extensions.customValidationRules === 'function') {
|             customRules = extensions.customValidationRules(this._graphQLConfig);

You can fix it by adding the following to the root package.json.

...
"resolutions": {
  "graphql-language-service-interface": "2.8.2",
  "graphql-language-service-parser": "1.9.0"
 },
...

a360f9478: Expose the catalog-import route as an external route from the scaffolder.

This will make it possible to hide the "Register Existing Component" button when you for example are running backstage with catalog.readonly=true.

As a consequence of this change you need add a new binding to your createApp call to keep the button visible. However, if you instead want to hide the button you can safely ignore the following example.

To bind the external route from the catalog-import plugin to the scaffolder template index page, make sure you have the appropriate imports and add the following to the createApp call:
```
import { catalogImportPlugin } from '@backstage/plugin-catalog-import';

const app = createApp({
  // ...
  bindRoutes({ bind }) {
    // ...
    bind(scaffolderPlugin.externalRoutes, {
      registerComponent: catalogImportPlugin.routes.importPage,
    });
  },
});
```

f1952337c: Due to a change in the techdocs publishers, they don't check if they are able to reach e.g. the configured S3 bucket anymore. This can be added again by the following change. Note that the backend process will no longer exit when it is not reachable but will only emit an error log message. You should include the check when your backend to get early feedback about a potential misconfiguration:

  // packages/backend/src/plugins/techdocs.ts

  export default async function createPlugin({
    logger,
    config,
    discovery,
    reader,
  }: PluginEnvironment): Promise<Router> {
    // ...

    const publisher = await Publisher.fromConfig(config, {
      logger,
      discovery,
    })

+   // checks if the publisher is working and logs the result
+   await publisher.getReadiness();

    // Docker client (conditionally) used by the generators, based on techdocs.generators config.
    const dockerClient = new Docker();

    // ...
}

Updated dependencies [d8ffec739]
Updated dependencies [7abec4dbc]
Updated dependencies [017192ee8]
Updated dependencies [a360f9478]
Updated dependencies [bb5055aee]
Updated dependencies [d840d30bc]
Updated dependencies [d0d1c2f7b]
Updated dependencies [5d0740563]
Updated dependencies [b25846562]
Updated dependencies [12390778e]
Updated dependencies [cba5944fc]
Updated dependencies [a376e3ee8]
Updated dependencies [fef852ecd]
Updated dependencies [18f7345a6]
Updated dependencies [5cafcf452]
Updated dependencies [423a514c3]
Updated dependencies [86a95ba67]
Updated dependencies [442f34b87]
Updated dependencies [e27cb6c45]
Updated dependencies [184b02bef]
Updated dependencies [0b7fd7a9d]
Updated dependencies [60ce64aa2]
- @backstage/plugin-scaffolder-backend@0.9.6
- @backstage/plugin-catalog-backend@0.7.1
- @backstage/plugin-scaffolder@0.9.0
- @backstage/catalog-model@0.7.7
- @backstage/core@0.7.5
- @backstage/plugin-catalog@0.5.4
- @backstage/plugin-api-docs@0.4.11
- @backstage/plugin-techdocs-backend@0.7.1
- @backstage/plugin-techdocs@0.7.2
- @backstage/catalog-client@0.3.10
- @backstage/plugin-tech-radar@0.3.9
- @backstage/cli@0.6.8

0.3.17

Patch Changes

3e7de08af: Fully migrated the template to the new composability API

The create-app template is now fully migrated to the new composability API, see Composability System Migration Documentation for explanations and more details. The final change which is now done was to migrate the EntityPage from being a component built on top of the EntityPageLayout and several more custom components, to an element tree built with EntitySwitch and EntityLayout.

To apply this change to an existing plugin, it is important that all plugins that you are using have already been migrated. In this case the most crucial piece is that no entity page cards of contents may require the entity prop, and they must instead consume the entity from context using useEntity.

Since this change is large with a lot of repeated changes, we'll describe a couple of common cases rather than the entire change. If your entity pages are unchanged from the create-app template, you can also just bring in the latest version directly from the template itself.

The first step of the change is to change the packages/app/src/components/catalog/EntityPage.tsx export to entityPage rather than EntityPage. This will require an update to App.tsx, which is the only change we need to do outside of EntityPage.tsx:

-import { EntityPage } from './components/catalog/EntityPage';
+import { entityPage } from './components/catalog/EntityPage';

 <Route
   path="/catalog/:namespace/:kind/:name"
   element={<CatalogEntityPage />}
 >
-  <EntityPage />
+  {entityPage}
 </Route>

The rest of the changes happen within EntityPage.tsx, and can be split into two broad categories, updating page components, and updating switch components.

Migrating Page Components

Let's start with an example of migrating a user page component. The following is the old code in the template:

const UserOverviewContent = ({ entity }: { entity: UserEntity }) => (
  <Grid container spacing={3}>
    <Grid item xs={12} md={6}>
      <UserProfileCard entity={entity} variant="gridItem" />
    </Grid>
    <Grid item xs={12} md={6}>
      <OwnershipCard entity={entity} variant="gridItem" />
    </Grid>
  </Grid>
);

const UserEntityPage = ({ entity }: { entity: Entity }) => (
  <EntityPageLayout>
    <EntityPageLayout.Content
      path="/*"
      title="Overview"
      element={<UserOverviewContent entity={entity as UserEntity} />}
    />
  </EntityPageLayout>
);

There's the main UserEntityPage component, and the UserOverviewContent component. Let's start with migrating the page contents, which we do by rendering an element rather than creating a component, as well as replace the cards with their new composability compatible variants. The new cards and content components can be identified by the Entity prefix.

const userOverviewContent = (
  <Grid container spacing={3}>
    <Grid item xs={12} md={6}>
      <EntityUserProfileCard variant="gridItem" />
    </Grid>
    <Grid item xs={12} md={6}>
      <EntityOwnershipCard variant="gridItem" />
    </Grid>
  </Grid>
);

Now let's migrate the page component, again by converting it into a rendered element instead of a component, as well as replacing the use of EntityPageLayout with EntityLayout.

const userPage = (
  <EntityLayout>
    <EntityLayout.Route path="/" title="Overview">
      {userOverviewContent}
    </EntityLayout.Route>
  </EntityLayout>
);

At this point the userPage is quite small, so throughout this migration we have inlined the page contents for all pages. This is an optional step, but may help reduce noise. The final page now looks like this:

const userPage = (
  <EntityLayout>
    <EntityLayout.Route path="/" title="Overview">
      <Grid container spacing={3}>
        <Grid item xs={12} md={6}>
          <EntityUserProfileCard variant="gridItem" />
        </Grid>
        <Grid item xs={12} md={6}>
          <EntityOwnershipCard variant="gridItem" />
        </Grid>
      </Grid>
    </EntityLayout.Route>
  </EntityLayout>
);

Migrating Switch Components

Switch components were used to select what entity page components or cards to render, based on for example the kind of entity. For this example we'll focus on the root EntityPage switch component, but the process is the same for example for the CI/CD switcher.

The old EntityPage looked like this:

export const EntityPage = () => {
  const { entity } = useEntity();

  switch (entity?.kind?.toLocaleLowerCase('en-US')) {
    case 'component':
      return <ComponentEntityPage entity={entity} />;
    case 'api':
      return <ApiEntityPage entity={entity} />;
    case 'group':
      return <GroupEntityPage entity={entity} />;
    case 'user':
      return <UserEntityPage entity={entity} />;
    case 'system':
      return <SystemEntityPage entity={entity} />;
    case 'domain':
      return <DomainEntityPage entity={entity} />;
    case 'location':
    case 'resource':
    case 'template':
    default:
      return <DefaultEntityPage entity={entity} />;
  }
};

In order to migrate to the composability API, we need to make this an element instead of a component, which means we're unable to keep the switch statement as is. To help with this, the catalog plugin provides an EntitySwitch component, which functions similar to a regular switch statement, which the first match being the one that is rendered. The catalog plugin also provides a number of built-in filter functions to use, such as isKind and isComponentType.

To migrate the EntityPage, we convert the switch statement into an EntitySwitch element, and each case statement into an EntitySwitch.Case element. We also move over to use our new element version of the page components, with the result looking like this:

export const entityPage = (
  <EntitySwitch>
    <EntitySwitch.Case if={isKind('component')} children={componentPage} />
    <EntitySwitch.Case if={isKind('api')} children={apiPage} />
    <EntitySwitch.Case if={isKind('group')} children={groupPage} />
    <EntitySwitch.Case if={isKind('user')} children={userPage} />
    <EntitySwitch.Case if={isKind('system')} children={systemPage} />
    <EntitySwitch.Case if={isKind('domain')} children={domainPage} />

    <EntitySwitch.Case>{defaultEntityPage}</EntitySwitch.Case>
  </EntitySwitch>
);

Another example is the ComponentEntityPage, which is migrated from this:

export const ComponentEntityPage = ({ entity }: { entity: Entity }) => {
  switch (entity?.spec?.type) {
    case 'service':
      return <ServiceEntityPage entity={entity} />;
    case 'website':
      return <WebsiteEntityPage entity={entity} />;
    default:
      return <DefaultEntityPage entity={entity} />;
  }
};

To this:

const componentPage = (
  <EntitySwitch>
    <EntitySwitch.Case if={isComponentType('service')}>
      {serviceEntityPage}
    </EntitySwitch.Case>

    <EntitySwitch.Case if={isComponentType('website')}>
      {websiteEntityPage}
    </EntitySwitch.Case>

    <EntitySwitch.Case>{defaultEntityPage}</EntitySwitch.Case>
  </EntitySwitch>
);

Note that if you want to conditionally render some piece of content, you can omit the default EntitySwitch.Case. If no case is matched in an EntitySwitch, nothing will be rendered.

Updated dependencies [802b41b65]
Updated dependencies [2b2b31186]
Updated dependencies [1279a3325]
Updated dependencies [4a4681b1b]
Updated dependencies [97b60de98]
Updated dependencies [3f96a9d5a]
Updated dependencies [b051e770c]
Updated dependencies [f9c75f7a9]
Updated dependencies [ae6250ce3]
Updated dependencies [98dd5da71]
Updated dependencies [b779b5fee]
- @backstage/plugin-scaffolder-backend@0.9.5
- @backstage/plugin-auth-backend@0.3.8
- @backstage/core@0.7.4
- @backstage/catalog-model@0.7.6
- @backstage/plugin-scaffolder@0.8.2
- @backstage/plugin-catalog-import@0.5.2
- @backstage/test-utils@0.1.10
- @backstage/plugin-catalog@0.5.3
- @backstage/backend-common@0.6.2
- @backstage/cli@0.6.7
- @backstage/plugin-app-backend@0.3.11

0.3.16

Patch Changes

Updated dependencies [676ede643]
Updated dependencies [2ab6f3ff0]
Updated dependencies [0d55dcc74]
Updated dependencies [ee5529268]
Updated dependencies [2c29611a0]
Updated dependencies [29e1789e1]
Updated dependencies [aa58c01e2]
Updated dependencies [60bddefce]
Updated dependencies [bebd1c4fe]
Updated dependencies [f1b2c1d2c]
Updated dependencies [676ede643]
Updated dependencies [9f48b548c]
Updated dependencies [8bee6a131]
Updated dependencies [b196a4569]
Updated dependencies [8488a1a96]
Updated dependencies [37e3a69f5]
Updated dependencies [6b2d54fd6]
Updated dependencies [44590510d]
Updated dependencies [dd7fa21e2]
Updated dependencies [164cc4c53]
Updated dependencies [676ede643]
- @backstage/plugin-catalog-backend@0.7.0
- @backstage/plugin-scaffolder@0.8.1
- @backstage/plugin-scaffolder-backend@0.9.4
- @backstage/plugin-auth-backend@0.3.7
- @backstage/plugin-api-docs@0.4.10
- @backstage/plugin-github-actions@0.4.3
- @backstage/plugin-catalog@0.5.2
- @backstage/plugin-techdocs@0.7.1
- @backstage/catalog-client@0.3.9
- @backstage/plugin-catalog-import@0.5.1
- @backstage/plugin-explore@0.3.3
- @backstage/catalog-model@0.7.5
- @backstage/backend-common@0.6.1
- @backstage/plugin-user-settings@0.2.9

0.3.15

Patch Changes

2c525f85e: (fix) Adds locationAnalyzer to default-app template

The locationAnalyzer was missing from the default-app template. This resulted in 404 errors in newly bootstrapped backstage applications, when adding components without configuration.

To fix this in an existing backstage application, the locationAnalyzer needs to be carried from the builder to the router in the packages/backend/src/plugins/catalog.ts file.
```
   const builder = new CatalogBuilder(env);
   const {
     entitiesCatalog,
     locationsCatalog,
     higherOrderOperation,
+    locationAnalyzer,
   } = await builder.build();
   // ...
   return await createRouter({
     entitiesCatalog,
     locationsCatalog,
     higherOrderOperation,
+    locationAnalyzer,
     logger: env.logger,
   });
```

f88fe9dd9: Adds plugin-org and more capability to the default EntityPage to display Users, Groups and Systems.

To update an existing application, add the org plugin:

cd packages/app
yarn add @backstage/plugin-org

Then add the example systems locations to your app-config.yaml:

catalog:
  rules:
-    - allow: [Component, API, Group, User, Template, Location]
+    - allow: [Component, System, API, Group, User, Template, Location]
  locations:
    # Backstage example components
    - type: url
      target: https://github.com/backstage/backstage/blob/master/packages/catalog-model/examples/all-components.yaml

+    # Backstage example systems
+    - type: url
+      target: https://github.com/backstage/backstage/blob/master/packages/catalog-model/examples/all-systems.yaml
+
    # Backstage example APIs

Additionally, the default app sidebar was updated to parity with the Backstage repo. You can see these changes in the template App.tsx referencing a new Root component.

Finally, compare your packages/app/src/components/catalog/EntityPage.tsx to EntityPage from the @backstage/create-app default template to pick up additional changes there.

4d248725e: Update the create-app template to use the correct latest version of express-promise-router.

To apply the same change in your own repository, update all of your repo's dependencies on express-promise-router to "^4.1.0".
Updated dependencies [9f2e51e89]
Updated dependencies [01ccef4c7]
Updated dependencies [4d248725e]
Updated dependencies [aaeb7ecf3]
Updated dependencies [449776cd6]
Updated dependencies [91e87c055]
Updated dependencies [ea9d977e7]
Updated dependencies [fcc3ada24]
Updated dependencies [687f066e1]
Updated dependencies [2aab54319]
Updated dependencies [113d3d59e]
Updated dependencies [f47e11427]
Updated dependencies [4618774ff]
Updated dependencies [3139f83af]
Updated dependencies [598f5bcfb]
Updated dependencies [c862b3f36]
Updated dependencies [4d248725e]
Updated dependencies [df59930b3]
- @backstage/plugin-scaffolder-backend@0.9.3
- @backstage/plugin-github-actions@0.4.2
- @backstage/plugin-catalog@0.5.1
- @backstage/plugin-techdocs@0.7.0
- @backstage/plugin-techdocs-backend@0.7.0
- @backstage/plugin-auth-backend@0.3.6
- @backstage/core@0.7.3
- @backstage/plugin-catalog-backend@0.6.7
- @backstage/theme@0.2.5
- @backstage/cli@0.6.6

0.3.14

Patch Changes

3385b374b: Supply a scmIntegrationsApiRef from the new @backstage/integration-react.

This is a new facility that plugins will start to use. You will have to add it to your local packages/app as described below. If this is not done, runtime errors will be seen in the frontend, on the form No API factory available for dependency apiRef{integration.scmintegrations}.

In packages/app/package.json:
```
   "dependencies": {
+    "@backstage/integration-react": "^0.1.1",
```
In packages/app/src/apis.ts:
```
+import {
+  scmIntegrationsApiRef,
+  ScmIntegrationsApi,
+} from '@backstage/integration-react';

 export const apis: AnyApiFactory[] = [
+  createApiFactory({
+    api: scmIntegrationsApiRef,
+    deps: { configApi: configApiRef },
+    factory: ({ configApi }) => ScmIntegrationsApi.fromConfig(configApi),
+  }),
```
9ca0e4009: use local version of lowerCase and upperCase methods

028339210: Adds example groups and users to the default app template.

To apply this change in an existing application, change the following in app-config.yaml:

     - type: url
       target: https://github.com/backstage/backstage/blob/master/packages/catalog-model/examples/all-apis.yaml

+    # Backstage example organization groups
+    - type: url
+      target: https://github.com/backstage/backstage/blob/master/packages/catalog-model/examples/acme/org.yaml
+      rules:
+        - allow: [Group, User]
+
     # Backstage example templates
     - type: url
       target: https://github.com/backstage/backstage/blob/master/plugins/scaffolder-backend/sample-templates/react-ssr-template/template.yaml

Updated dependencies [010aed784]
Updated dependencies [633a31fec]
Updated dependencies [8686eb38c]
Updated dependencies [34e6bb409]
Updated dependencies [b56815b40]
Updated dependencies [147b4c5b1]
Updated dependencies [83bfc98a3]
Updated dependencies [7d8c4c97c]
Updated dependencies [e7baa0d2e]
Updated dependencies [8b4f7e42a]
Updated dependencies [8686eb38c]
Updated dependencies [84972540b]
Updated dependencies [3385b374b]
Updated dependencies [0434853a5]
Updated dependencies [a0dacc184]
Updated dependencies [8686eb38c]
Updated dependencies [9ca0e4009]
Updated dependencies [4bc98a5b9]
Updated dependencies [34ff49b0f]
Updated dependencies [d2f4efc5d]
Updated dependencies [8686eb38c]
Updated dependencies [424742dc1]
Updated dependencies [c8b54c370]
Updated dependencies [4e0b5055a]
Updated dependencies [8b5e59750]
Updated dependencies [8686eb38c]
- @backstage/plugin-catalog-backend@0.6.6
- @backstage/plugin-catalog@0.5.0
- @backstage/catalog-client@0.3.8
- @backstage/plugin-tech-radar@0.3.8
- @backstage/plugin-user-settings@0.2.8
- @backstage/plugin-techdocs@0.6.2
- @backstage/plugin-catalog-import@0.5.0
- @backstage/plugin-techdocs-backend@0.6.5
- @backstage/plugin-scaffolder-backend@0.9.2
- @backstage/backend-common@0.6.0
- @backstage/cli@0.6.5
- @backstage/plugin-scaffolder@0.8.0
- @backstage/config@0.1.4
- @backstage/core@0.7.2
- @backstage/plugin-api-docs@0.4.9
- @backstage/plugin-explore@0.3.2
- @backstage/plugin-github-actions@0.4.1
- @backstage/plugin-lighthouse@0.2.14
- @backstage/plugin-search@0.3.4
- @backstage/plugin-auth-backend@0.3.5
- @backstage/test-utils@0.1.9
- @backstage/plugin-app-backend@0.3.10
- @backstage/plugin-proxy-backend@0.2.6
- @backstage/plugin-rollbar-backend@0.1.8

0.3.13

Patch Changes

b03fba0dc: Adds "yarn dev" command to simplify local development.

To add the command to an existing application, first add it to the scripts section of your monorepo root package.json like so:
```
 "scripts": {
+    "dev": "concurrently \"yarn start\" \"yarn start-backend\"",
     "start": "yarn workspace app start",
     "start-backend": "yarn workspace backend start",
```
And then add the concurrently package to your monorepo, like so:
```
yarn add concurrently@6.0.0 --dev -W
```
Notes:
- This needs to be done to the monorepo root, not your frontend or backend package.
- The --dev -W will add it only to devDependencies, and force it to the monorepo main root.
You can then run yarn dev which will start both the Backstage frontend and backend in a single window.
Updated dependencies [13fb84244]
Updated dependencies [9ef5a126d]
Updated dependencies [4f3d0dce0]
Updated dependencies [d7245b733]
Updated dependencies [393b623ae]
Updated dependencies [d7245b733]
Updated dependencies [0b42fff22]
Updated dependencies [0b42fff22]
Updated dependencies [2ef5bc7ea]
Updated dependencies [ff4d666ab]
Updated dependencies [c532c1682]
Updated dependencies [761698831]
Updated dependencies [aa095e469]
Updated dependencies [761698831]
Updated dependencies [f98f212e4]
Updated dependencies [9f7dc10fb]
Updated dependencies [eabe89d38]
Updated dependencies [93c62c755]
Updated dependencies [2089de76b]
Updated dependencies [c9b5c1eca]
Updated dependencies [dc1fc92c8]
Updated dependencies [2089de76b]
Updated dependencies [868e4cdf2]
Updated dependencies [02d78290a]
Updated dependencies [a501128db]
Updated dependencies [ca4a904f6]
Updated dependencies [5f1b7ea35]
Updated dependencies [5ab5864f6]
Updated dependencies [4202807bb]
Updated dependencies [2e57922de]
- @backstage/plugin-github-actions@0.4.0
- @backstage/plugin-catalog-backend@0.6.5
- @backstage/plugin-catalog@0.4.2
- @backstage/backend-common@0.5.6
- @backstage/plugin-app-backend@0.3.9
- @backstage/plugin-scaffolder-backend@0.9.1
- @backstage/catalog-model@0.7.4
- @backstage/catalog-client@0.3.7
- @backstage/core@0.7.1
- @backstage/plugin-techdocs-backend@0.6.4
- @backstage/plugin-techdocs@0.6.1
- @backstage/plugin-auth-backend@0.3.4
- @backstage/plugin-scaffolder@0.7.1
- @backstage/theme@0.2.4
- @backstage/plugin-explore@0.3.1
- @backstage/cli@0.6.4

0.3.12

Patch Changes

f71589800: The api-docs plugin has been migrated to use an external route reference to dynamically link to the create component page.

If you want to have a button that links to the scaffolder plugin from the API explorer, apply the following changes to packages/app/src/App.tsx:
```
+ import { apiDocsPlugin } from '@backstage/plugin-api-docs';
  import { scaffolderPlugin } from '@backstage/plugin-scaffolder';

  const app = createApp({
    // ...
    bindRoutes({ bind }) {
+     bind(apiDocsPlugin.externalRoutes, {
+       createComponent: scaffolderPlugin.routes.root,
+     });
    },
  });
```
If you choose to not bind the routes, the button to create new APIs is not displayed.
7a1b2ba0e: Migrated away from using deprecated routes and router components at top-level in the app, and instead use routable extension pages.

To apply this change to an existing app, make the following changes to packages/app/src/App.tsx:

Update imports and remove the usage of the deprecated app.getRoutes().

- import { Router as DocsRouter } from '@backstage/plugin-techdocs';
+ import { TechdocsPage } from '@backstage/plugin-techdocs';
  import { CatalogImportPage } from '@backstage/plugin-catalog-import';
- import { Router as TechRadarRouter } from '@backstage/plugin-tech-radar';
- import { SearchPage as SearchRouter } from '@backstage/plugin-search';
- import { Router as SettingsRouter } from '@backstage/plugin-user-settings';
+ import { TechRadarPage } from '@backstage/plugin-tech-radar';
+ import { SearchPage } from '@backstage/plugin-search';
+ import { UserSettingsPage } from '@backstage/plugin-user-settings';
+ import { ApiExplorerPage } from '@backstage/plugin-api-docs';
  import { EntityPage } from './components/catalog/EntityPage';
  import { scaffolderPlugin, ScaffolderPage } from '@backstage/plugin-scaffolder';


  const AppProvider = app.getProvider();
  const AppRouter = app.getRouter();
- const deprecatedAppRoutes = app.getRoutes();

As well as update or add the following routes:

   <Route path="/create" element={<ScaffolderPage />} />
-  <Route path="/docs" element={<DocsRouter />} />
+  <Route path="/docs" element={<TechdocsPage />} />
+  <Route path="/api-docs" element={<ApiExplorerPage />} />
   <Route
     path="/tech-radar"
-    element={<TechRadarRouter width={1500} height={800} />}
+    element={<TechRadarPage width={1500} height={800} />}
   />
   <Route path="/catalog-import" element={<CatalogImportPage />} />
-  <Route
-    path="/search"
-    element={<SearchRouter/>}
-  />
-  <Route path="/settings" element={<SettingsRouter />} />
-  {deprecatedAppRoutes}
+  <Route path="/search" element={<SearchPage />} />
+  <Route path="/settings" element={<UserSettingsPage />} />

If you have added additional plugins with registered routes or are using Router components from other plugins, these should be migrated to use the *Page components as well. See this commit for more examples of how to migrate.

For more information and the background to this change, see the composability system migration docs.

415a3a42d: Updated the default App test to work better on Windows.

To apply this change to an existing app, replace the process.env.APP_CONFIG definition in packages/app/src/App.test.tsx with the following:

process.env = {
  NODE_ENV: 'test',
  APP_CONFIG: [
    {
      data: {
        app: { title: 'Test' },
        backend: { baseUrl: 'http://localhost:7000' },
        techdocs: {
          storageUrl: 'http://localhost:7000/api/techdocs/static/docs',
        },
      },
      context: 'test',
    },
  ] as any,
};

Updated dependencies [b2a5320a4]
Updated dependencies [12d8f27a6]
Updated dependencies [507513fed]
Updated dependencies [52b5bc3e2]
Updated dependencies [ecdd407b1]
Updated dependencies [32a003973]
Updated dependencies [40c0fdbaa]
Updated dependencies [12d8f27a6]
Updated dependencies [497859088]
Updated dependencies [1987c9341]
Updated dependencies [f31b76b44]
Updated dependencies [15eee03bc]
Updated dependencies [f43192207]
Updated dependencies [cfc83cac1]
Updated dependencies [8adb48df4]
Updated dependencies [bc327dc42]
Updated dependencies [2386de1d3]
Updated dependencies [9ce68b677]
Updated dependencies [10362e9eb]
Updated dependencies [e37d2de99]
Updated dependencies [813c6a4f2]
Updated dependencies [11c6208fe]
Updated dependencies [8106c9528]
Updated dependencies [05183f202]
Updated dependencies [40c0fdbaa]
Updated dependencies [f71589800]
Updated dependencies [2a271d89e]
Updated dependencies [bece09057]
Updated dependencies [d4f0a1406]
Updated dependencies [169f48deb]
Updated dependencies [8a1566719]
Updated dependencies [d0ed25196]
Updated dependencies [4c049a1a1]
Updated dependencies [96ccc8f69]
Updated dependencies [3af994c81]
Updated dependencies [b33e553b2]
Updated dependencies [04667f571]
Updated dependencies [b93538acc]
Updated dependencies [8871e7523]
Updated dependencies [dbea11072]
- @backstage/plugin-circleci@0.2.11
- @backstage/plugin-github-actions@0.3.5
- @backstage/plugin-scaffolder@0.7.0
- @backstage/plugin-scaffolder-backend@0.9.0
- @backstage/cli@0.6.3
- @backstage/plugin-techdocs-backend@0.6.3
- @backstage/plugin-catalog-backend@0.6.4
- @backstage/plugin-api-docs@0.4.8
- @backstage/plugin-catalog@0.4.1
- @backstage/catalog-model@0.7.3
- @backstage/backend-common@0.5.5
- @backstage/plugin-proxy-backend@0.2.5
- @backstage/plugin-auth-backend@0.3.3
- @backstage/plugin-explore@0.3.0
- @backstage/plugin-techdocs@0.6.0
- @backstage/plugin-catalog-import@0.4.3
- @backstage/core@0.7.0
- @backstage/plugin-lighthouse@0.2.13
- @backstage/plugin-search@0.3.3
- @backstage/plugin-tech-radar@0.3.7
- @backstage/plugin-user-settings@0.2.7

0.3.11

Patch Changes

4594f7efc: Add the google analytics scripts in the index.html template for new applications.

To apply this change to an existing application, change the following in packages\app\public\index.html:

    <title><%= app.title %></title>

+    <% if (app.googleAnalyticsTrackingId && typeof app.googleAnalyticsTrackingId
+    === 'string') { %>
+    <script
+      async
+      src="https://www.googletagmanager.com/gtag/js?id=<%= app.googleAnalyticsTrackingId %>"
+    ></script>
+    <script>
+      window.dataLayer = window.dataLayer || [];
+      function gtag() {
+        dataLayer.push(arguments);
+      }
+      gtag('js', new Date());
+
+      gtag('config', '<%= app.googleAnalyticsTrackingId %>');
+    </script>
+    <% } %>
  </head>

08fa2176a: BREAKING CHANGE

The Scaffolder and Catalog plugins have been migrated to partially require use of the new composability API. The Scaffolder used to register its pages using the deprecated route registration plugin API, but those registrations have been removed. This means you now need to add the Scaffolder plugin page to the app directly.

The Catalog plugin has also been migrated to use an external route reference to dynamically link to the create component page. This means you need to migrate the catalog plugin to use the new extension components, as well as bind the external route.

Apply the following changes to packages/app/src/App.tsx:

-import { Router as CatalogRouter } from '@backstage/plugin-catalog';
+import {
+  catalogPlugin,
+  CatalogIndexPage,
+  CatalogEntityPage,
+} from '@backstage/plugin-catalog';
+import { scaffolderPlugin, ScaffolderPage } from '@backstage/plugin-scaffolder';

# The following addition to the app config allows the catalog plugin to link to the
# component creation page, i.e. the scaffolder. You can chose a different target if you want to.
 const app = createApp({
   apis,
   plugins: Object.values(plugins),
+  bindRoutes({ bind }) {
+    bind(catalogPlugin.externalRoutes, {
+      createComponent: scaffolderPlugin.routes.root,
+    });
+  }
 });

# Apply these changes within FlatRoutes. It is important to have migrated to using FlatRoutes
# for this to work, if you haven't done that yet, see the previous entries in this changelog.
-  <Route
-    path="/catalog"
-    element={<CatalogRouter EntityPage={EntityPage} />}
-  />
+  <Route path="/catalog" element={<CatalogIndexPage />} />
+  <Route
+    path="/catalog/:namespace/:kind/:name"
+    element={<CatalogEntityPage />}
+  >
+    <EntityPage />
+  </Route>
   <Route path="/docs" element={<DocsRouter />} />
+  <Route path="/create" element={<ScaffolderPage />} />

The scaffolder has been redesigned to be horizontally scalable and to persistently store task state and execution logs in the database. Component registration has moved from the frontend into a separate registration step executed by the TaskWorker. This requires that a CatalogClient is passed to the scaffolder backend instead of the old CatalogEntityClient.

The default catalog client comes from the @backstage/catalog-client, which you need to add as a dependency in packages/backend/package.json.

Once the dependency has been added, apply the following changes topackages/backend/src/plugins/scaffolder.ts:

 import {
   CookieCutter,
   createRouter,
   Preparers,
   Publishers,
   CreateReactAppTemplater,
   Templaters,
-  CatalogEntityClient,
 } from '@backstage/plugin-scaffolder-backend';
+import { CatalogClient } from '@backstage/catalog-client';

 const discovery = SingleHostDiscovery.fromConfig(config);
-const entityClient = new CatalogEntityClient({ discovery });
+const catalogClient = new CatalogClient({ discoveryApi: discovery })

 return await createRouter({
   preparers,
   templaters,
   publishers,
   logger,
   config,
   dockerClient,
-  entityClient,
   database,
+  catalogClient,
 });

See the @backstage/scaffolder-backend changelog for more information about this change.

Updated dependencies [ec504e7b4]
Updated dependencies [3a58084b6]
Updated dependencies [a5f42cf66]
Updated dependencies [e488f0502]
Updated dependencies [e799e74d4]
Updated dependencies [dc12852c9]
Updated dependencies [a5f42cf66]
Updated dependencies [a8953a9c9]
Updated dependencies [f37992797]
Updated dependencies [347137ccf]
Updated dependencies [d0760ecdf]
Updated dependencies [1407b34c6]
Updated dependencies [d6593abe6]
Updated dependencies [bad21a085]
Updated dependencies [e8e35fb5f]
Updated dependencies [9615e68fb]
Updated dependencies [e780e119c]
Updated dependencies [437bac549]
Updated dependencies [9f2b3a26e]
Updated dependencies [49f9b7346]
Updated dependencies [1c06cb312]
Updated dependencies [968b588f7]
Updated dependencies [3a58084b6]
Updated dependencies [2499f6cde]
Updated dependencies [5469a9761]
Updated dependencies [a1f5e6545]
Updated dependencies [60d1bc3e7]
Updated dependencies [2c1f2a7c2]
Updated dependencies [6266ddd11]
- @backstage/plugin-auth-backend@0.3.2
- @backstage/core@0.6.3
- @backstage/plugin-scaffolder@0.6.0
- @backstage/plugin-scaffolder-backend@0.8.0
- @backstage/test-utils@0.1.8
- @backstage/plugin-catalog@0.4.0
- @backstage/plugin-catalog-import@0.4.2
- @backstage/plugin-techdocs@0.5.8
- @backstage/plugin-techdocs-backend@0.6.2
- @backstage/plugin-explore@0.2.7
- @backstage/plugin-api-docs@0.4.7
- @backstage/catalog-model@0.7.2
- @backstage/cli@0.6.2
- @backstage/plugin-tech-radar@0.3.6
- @backstage/plugin-app-backend@0.3.8
- @backstage/plugin-catalog-backend@0.6.3
- @backstage/config@0.1.3
- @backstage/plugin-circleci@0.2.10
- @backstage/plugin-github-actions@0.3.4
- @backstage/plugin-lighthouse@0.2.12
- @backstage/plugin-search@0.3.2

0.3.10

Patch Changes

d50e9b81e: Updated docker build to use backstage-cli backend:bundle instead of backstage-cli backend:build-image.

To apply this change to an existing application, change the following in packages/backend/package.json:

-  "build": "backstage-cli backend:build",
-  "build-image": "backstage-cli backend:build-image --build --tag backstage",
+  "build": "backstage-cli backend:bundle",
+  "build-image": "docker build ../.. -f Dockerfile --tag backstage",

Note that the backend build is switched to backend:bundle, and the build-image script simply calls docker build. This means the build-image script no longer builds all packages, so you have to run yarn build in the root first.

In order to work with the new build method, the Dockerfile at packages/backend/Dockerfile has been updated with the following contents:

# This dockerfile builds an image for the backend package.
# It should be executed with the root of the repo as docker context.
#
# Before building this image, be sure to have run the following commands in the repo root:
#
# yarn install
# yarn tsc
# yarn build
#
# Once the commands have been run, you can build the image using `yarn build-image`

FROM node:14-buster-slim

WORKDIR /app

# Copy repo skeleton first, to avoid unnecessary docker cache invalidation.
# The skeleton contains the package.json of each package in the monorepo,
# and along with yarn.lock and the root package.json, that's enough to run yarn install.
ADD yarn.lock package.json packages/backend/dist/skeleton.tar.gz ./

RUN yarn install --frozen-lockfile --production --network-timeout 300000 && rm -rf "$(yarn cache dir)"

# Then copy the rest of the backend bundle, along with any other files we might want.
ADD packages/backend/dist/bundle.tar.gz app-config.yaml ./

CMD ["node", "packages/backend", "--config", "app-config.yaml"]

Note that the base image has been switched from node:14-buster to node:14-buster-slim, significantly reducing the image size. This is enabled by the removal of the nodegit dependency, so if you are still using this in your project you will have to stick with the node:14-buster base image.

A .dockerignore file has been added to the root of the repo as well, in order to keep the docker context upload small. It lives in the root of the repo with the following contents:

.git
node_modules
packages
!packages/backend/dist
plugins

532bc0ec0: Upgrading to lerna@4.0.0.
Updated dependencies [16fb1d03a]
Updated dependencies [92f01d75c]
Updated dependencies [6c4a76c59]
Updated dependencies [32a950409]
Updated dependencies [491f3a0ec]
Updated dependencies [f10950bd2]
Updated dependencies [914c89b13]
Updated dependencies [fd3f2a8c0]
Updated dependencies [257a753ff]
Updated dependencies [d872f662d]
Updated dependencies [edbc27bfd]
Updated dependencies [434b4e81a]
Updated dependencies [fb28da212]
Updated dependencies [9337f509d]
Updated dependencies [0ada34a0f]
Updated dependencies [0af242b6d]
Updated dependencies [f4c2bcf54]
Updated dependencies [d9687c524]
Updated dependencies [53b69236d]
Updated dependencies [29c8bcc53]
Updated dependencies [3600ac3b0]
Updated dependencies [07e226872]
Updated dependencies [b0a41c707]
Updated dependencies [f62e7abe5]
Updated dependencies [a341a8716]
Updated dependencies [96f378d10]
Updated dependencies [532bc0ec0]
Updated dependencies [688b73110]
- @backstage/backend-common@0.5.4
- @backstage/plugin-auth-backend@0.3.1
- @backstage/plugin-scaffolder@0.5.1
- @backstage/plugin-catalog@0.3.2
- @backstage/core@0.6.2
- @backstage/cli@0.6.1
- @backstage/plugin-user-settings@0.2.6
- @backstage/plugin-scaffolder-backend@0.7.1
- @backstage/plugin-api-docs@0.4.6
- @backstage/plugin-catalog-import@0.4.1
- @backstage/plugin-github-actions@0.3.3
- @backstage/plugin-lighthouse@0.2.11
- @backstage/plugin-techdocs-backend@0.6.1
- @backstage/plugin-catalog-backend@0.6.2
- @backstage/plugin-circleci@0.2.9
- @backstage/plugin-explore@0.2.6
- @backstage/plugin-search@0.3.1
- @backstage/plugin-techdocs@0.5.7

0.3.9

Patch Changes

615103a63: Pass on plugin database management instance that is now required by the scaffolder plugin.

To apply this change to an existing application, add the following to src/plugins/scaffolder.ts:

export default async function createPlugin({
  logger,
  config,
+  database,
}: PluginEnvironment) {

// ...omitted...

  return await createRouter({
    preparers,
    templaters,
    publishers,
    logger,
    config,
    dockerClient,
    entityClient,
+    database,
  });
}

30e200d12: @backstage/plugin-catalog-import has been refactored, so the App.tsx of the backstage apps need to be updated:

// packages/app/src/App.tsx

     <Route
       path="/catalog-import"
-      element={<CatalogImportPage catalogRouteRef={catalogRouteRef} />}
+      element={<CatalogImportPage />}
     />

f4b576d0e: TechDocs: Add comments about migrating away from basic setup in app-config.yaml
Updated dependencies [753bb4c40]
Updated dependencies [1deb31141]
Updated dependencies [6ed2b47d6]
Updated dependencies [77ad0003a]
Updated dependencies [6b26c9f41]
Updated dependencies [b3f0c3811]
Updated dependencies [d2441aee3]
Updated dependencies [727f0deec]
Updated dependencies [fb53eb7cb]
Updated dependencies [07bafa248]
Updated dependencies [ca559171b]
Updated dependencies [ffffea8e6]
Updated dependencies [f5e564cd6]
Updated dependencies [f3fbfb452]
Updated dependencies [615103a63]
Updated dependencies [68dd79d83]
Updated dependencies [84364b35c]
Updated dependencies [41af18227]
Updated dependencies [82b2c11b6]
Updated dependencies [1df75733e]
Updated dependencies [965e200c6]
Updated dependencies [b51ee6ece]
Updated dependencies [e5da858d7]
Updated dependencies [9230d07e7]
Updated dependencies [f5f45744e]
Updated dependencies [0fe8ff5be]
Updated dependencies [5a5163519]
Updated dependencies [82b2c11b6]
Updated dependencies [8f3443427]
Updated dependencies [08142b256]
Updated dependencies [08142b256]
Updated dependencies [b51ee6ece]
Updated dependencies [804502a5c]
- @backstage/plugin-catalog-import@0.4.0
- @backstage/plugin-auth-backend@0.3.0
- @backstage/plugin-catalog@0.3.1
- @backstage/plugin-scaffolder@0.5.0
- @backstage/plugin-scaffolder-backend@0.7.0
- @backstage/plugin-catalog-backend@0.6.1
- @backstage/plugin-circleci@0.2.8
- @backstage/plugin-search@0.3.0
- @backstage/plugin-app-backend@0.3.7
- @backstage/backend-common@0.5.3
- @backstage/plugin-api-docs@0.4.5
- @backstage/plugin-lighthouse@0.2.10
- @backstage/plugin-techdocs@0.5.6
- @backstage/test-utils@0.1.7
- @backstage/plugin-github-actions@0.3.2
- @backstage/plugin-explore@0.2.5
- @backstage/plugin-techdocs-backend@0.6.0
- @backstage/core@0.6.1
- @backstage/plugin-tech-radar@0.3.5

0.3.8

Patch Changes

019fe39a0: BREAKING CHANGE: The useEntity hook has been moved from @backstage/plugin-catalog to @backstage/plugin-catalog-react. To apply this change to an existing app, add @backstage/plugin-catalog-react to your dependencies in packages/app/package.json, and update the import inside packages/app/src/components/catalog/EntityPage.tsx as well as any other places you were using useEntity or any other functions that were moved to @backstage/plugin-catalog-react.
436ca3f62: Remove techdocs.requestUrl and techdocs.storageUrl from app-config.yaml
Updated dependencies [ceef4dd89]
Updated dependencies [720149854]
Updated dependencies [c777df180]
Updated dependencies [398e1f83e]
Updated dependencies [12ece98cd]
Updated dependencies [d82246867]
Updated dependencies [7fc89bae2]
Updated dependencies [c810082ae]
Updated dependencies [b712841d6]
Updated dependencies [a5628df40]
Updated dependencies [2430ee7c2]
Updated dependencies [3149bfe63]
Updated dependencies [5fa3bdb55]
Updated dependencies [bc5082a00]
Updated dependencies [6e612ce25]
Updated dependencies [e44925723]
Updated dependencies [b37501a3d]
Updated dependencies [a26668913]
Updated dependencies [025e122c3]
Updated dependencies [e9aab60c7]
Updated dependencies [21e624ba9]
Updated dependencies [19fe61c27]
Updated dependencies [e9aab60c7]
Updated dependencies [da9f53c60]
Updated dependencies [a08c4b0b0]
Updated dependencies [24e47ef1e]
Updated dependencies [bc5082a00]
Updated dependencies [b37501a3d]
Updated dependencies [90c8f20b9]
Updated dependencies [32c95605f]
Updated dependencies [7881f2117]
Updated dependencies [529d16d27]
Updated dependencies [54c7d02f7]
Updated dependencies [de98c32ed]
Updated dependencies [806929fe2]
Updated dependencies [019fe39a0]
Updated dependencies [cdea0baf1]
Updated dependencies [019fe39a0]
Updated dependencies [11cb5ef94]
- @backstage/plugin-catalog-import@0.3.7
- @backstage/plugin-scaffolder@0.4.2
- @backstage/plugin-techdocs-backend@0.5.5
- @backstage/cli@0.6.0
- @backstage/core@0.6.0
- @backstage/plugin-api-docs@0.4.4
- @backstage/plugin-catalog@0.3.0
- @backstage/theme@0.2.3
- @backstage/plugin-lighthouse@0.2.9
- @backstage/backend-common@0.5.2
- @backstage/plugin-catalog-backend@0.6.0
- @backstage/plugin-techdocs@0.5.5
- @backstage/plugin-user-settings@0.2.5
- @backstage/catalog-model@0.7.1
- @backstage/plugin-scaffolder-backend@0.6.0
- @backstage/plugin-app-backend@0.3.6
- @backstage/plugin-tech-radar@0.3.4
- @backstage/plugin-explore@0.2.4
- @backstage/plugin-circleci@0.2.7
- @backstage/plugin-github-actions@0.3.1
- @backstage/plugin-search@0.2.7
- @backstage/test-utils@0.1.6
- @backstage/plugin-auth-backend@0.2.12
- @backstage/plugin-proxy-backend@0.2.4
- @backstage/plugin-rollbar-backend@0.1.7

0.3.7

Patch Changes

Updated dependencies [26a3a6cf0]
Updated dependencies [12a56cdfe]
Updated dependencies [664dd08c9]
Updated dependencies [9dd057662]
Updated dependencies [ef7957be4]
Updated dependencies [0b1182346]
Updated dependencies [d7b1d317f]
Updated dependencies [a91aa6bf2]
Updated dependencies [39b05b9ae]
Updated dependencies [4eaa06057]
- @backstage/backend-common@0.5.1
- @backstage/plugin-scaffolder-backend@0.5.2
- @backstage/cli@0.5.0
- @backstage/plugin-catalog@0.2.14
- @backstage/plugin-catalog-backend@0.5.5
- @backstage/plugin-catalog-import@0.3.6
- @backstage/plugin-scaffolder@0.4.1
- @backstage/plugin-auth-backend@0.2.12
- @backstage/catalog-model@0.7.0
- @backstage/core@0.5.0
- @backstage/test-utils@0.1.6
- @backstage/theme@0.2.2
- @backstage/plugin-api-docs@0.4.3
- @backstage/plugin-app-backend@0.3.5
- @backstage/plugin-circleci@0.2.6
- @backstage/plugin-explore@0.2.3
- @backstage/plugin-github-actions@0.3.0
- @backstage/plugin-lighthouse@0.2.8
- @backstage/plugin-proxy-backend@0.2.4
- @backstage/plugin-rollbar-backend@0.1.7
- @backstage/plugin-search@0.2.6
- @backstage/plugin-tech-radar@0.3.3
- @backstage/plugin-techdocs@0.5.4
- @backstage/plugin-techdocs-backend@0.5.4
- @backstage/plugin-user-settings@0.2.4

0.3.6

Patch Changes

d3947caf3: Fix accidental dependency on non-existent dependencies.
Updated dependencies [a4e636c8f]
Updated dependencies [099c5cf4f]
Updated dependencies [0ea002378]
Updated dependencies [a08db734c]
- @backstage/plugin-catalog@0.2.13
- @backstage/plugin-scaffolder-backend@0.5.1

0.3.6

Minor Changes

ed6baab66: - Deprecating the scaffolder.${provider}.token auth duplication and favoring integrations.${provider} instead. If you receive deprecation warnings your config should change like the following:
```
scaffolder:
  github:
    token:
      $env: GITHUB_TOKEN
    visibility: public
```
To something that looks like this:
```
integration:
  github:
    - host: github.com
      token:
        $env: GITHUB_TOKEN
scaffolder:
  github:
    visibility: public
```
You can also configure multiple different hosts under the integration config like the following:
```
integration:
  github:
    - host: github.com
      token:
        $env: GITHUB_TOKEN
    - host: ghe.mycompany.com
      token:
        $env: GITHUB_ENTERPRISE_TOKEN
```
This of course is the case for all the providers respectively.
- Adding support for cross provider scaffolding, you can now create repositories in for example Bitbucket using a template residing in GitHub.
- Fix GitLab scaffolding so that it returns a catalogInfoUrl which automatically imports the project into the catalog.
- The Store Path field on the scaffolder frontend has now changed so that you require the full URL to the desired destination repository.
backstage/new-repository would become https://github.com/backstage/new-repository if provider was GitHub for example.

Patch Changes

a284f5bc1: Due to a package name change from @kyma-project/asyncapi-react to @asyncapi/react-component the jest configuration in the root package.json has to be updated:
```
   "jest": {
     "transformModules": [
-      "@kyma-project/asyncapi-react
+      "@asyncapi/react-component"
     ]
   }
```

89278acab: Migrate to using FlatRoutes from @backstage/core for the root app routes.

This is the first step in migrating applications as mentioned here: https://backstage.io/docs/plugins/composability#porting-existing-apps.

To apply this change to an existing app, switch out the Routes component from react-router to FlatRoutes from @backstage/core. This also allows you to remove any /* suffixes on the route paths. For example:

import {
   OAuthRequestDialog,
   SidebarPage,
   createRouteRef,
+  FlatRoutes,
 } from '@backstage/core';
 import { AppSidebar } from './sidebar';
-import { Route, Routes, Navigate } from 'react-router';
+import { Route, Navigate } from 'react-router';
 import { Router as CatalogRouter } from '@backstage/plugin-catalog';
...
         <AppSidebar />
-        <Routes>
+        <FlatRoutes>
...
           <Route
-            path="/catalog/*"
+            path="/catalog"
             element={<CatalogRouter EntityPage={EntityPage} />}
           />
-          <Route path="/docs/*" element={<DocsRouter />} />
+          <Route path="/docs" element={<DocsRouter />} />
...
           <Route path="/settings" element={<SettingsRouter />} />
-        </Routes>
+        </FlatRoutes>
       </SidebarPage>

26d3b24f3: fix routing and config for user-settings plugin

To make the corresponding change in your local app, add the following in your App.tsx

import { Router as SettingsRouter } from '@backstage/plugin-user-settings';
...
<Route path="/settings" element={<SettingsRouter />} />

and the following to your plugins.ts:

export { plugin as UserSettings } from '@backstage/plugin-user-settings';

92dbbcedd: Add *-credentials.yaml to gitignore to prevent accidental commits of sensitive credential information.

To apply this change to an existing installation, add these lines to your .gitignore
```
# Sensitive credentials
*-credentials.yaml
```

d176671d1: use fromConfig for all scaffolder helpers, and use the url protocol for app-config location entries.

To apply this change to your local installation, replace the contents of your packages/backend/src/plugins/scaffolder.ts with the following contents:

import {
  CookieCutter,
  createRouter,
  Preparers,
  Publishers,
  CreateReactAppTemplater,
  Templaters,
  CatalogEntityClient,
} from '@backstage/plugin-scaffolder-backend';
import { SingleHostDiscovery } from '@backstage/backend-common';
import type { PluginEnvironment } from '../types';
import Docker from 'dockerode';

export default async function createPlugin({
  logger,
  config,
}: PluginEnvironment) {
  const cookiecutterTemplater = new CookieCutter();
  const craTemplater = new CreateReactAppTemplater();
  const templaters = new Templaters();
  templaters.register('cookiecutter', cookiecutterTemplater);
  templaters.register('cra', craTemplater);

  const preparers = await Preparers.fromConfig(config, { logger });
  const publishers = await Publishers.fromConfig(config, { logger });

  const dockerClient = new Docker();

  const discovery = SingleHostDiscovery.fromConfig(config);
  const entityClient = new CatalogEntityClient({ discovery });

  return await createRouter({
    preparers,
    templaters,
    publishers,
    logger,
    config,
    dockerClient,
    entityClient,
  });
}

This will ensure that the scaffolder-backend package can add handlers for the url protocol which is becoming the standard when registering entities in the catalog

9d1d1138e: Ensured that versions bumps of packages used in the app template trigger a release of this package when needed.
db05f7a35: Remove the @types/helmet dev dependency from the app template. This dependency is now unused as the package helmet brings its own types.

To update your existing app, simply remove the @types/helmet dependency from the package.json of your backend package.
Updated dependencies [def2307f3]
Updated dependencies [46bba09ea]
Updated dependencies [efd6ef753]
Updated dependencies [0b135e7e0]
Updated dependencies [593632f07]
Updated dependencies [2b514d532]
Updated dependencies [318a6af9f]
Updated dependencies [33846acfc]
Updated dependencies [294a70cab]
Updated dependencies [b604a9d41]
Updated dependencies [ac7be581a]
Updated dependencies [a187b8ad0]
Updated dependencies [0ea032763]
Updated dependencies [8855f61f6]
Updated dependencies [5345a1f98]
Updated dependencies [ed6baab66]
Updated dependencies [ad838c02f]
Updated dependencies [f04db53d7]
Updated dependencies [a5e27d5c1]
Updated dependencies [0643a3336]
Updated dependencies [debf359b5]
Updated dependencies [a2291d7cc]
Updated dependencies [f9ba00a1c]
Updated dependencies [09a370426]
Updated dependencies [a93f42213]
- @backstage/catalog-model@0.7.0
- @backstage/plugin-catalog-backend@0.5.4
- @backstage/plugin-github-actions@0.3.0
- @backstage/core@0.5.0
- @backstage/backend-common@0.5.0
- @backstage/plugin-catalog@0.2.12
- @backstage/plugin-catalog-import@0.3.5
- @backstage/cli@0.4.7
- @backstage/plugin-api-docs@0.4.3
- @backstage/plugin-scaffolder@0.4.0
- @backstage/plugin-scaffolder-backend@0.5.0
- @backstage/plugin-techdocs@0.5.4
- @backstage/plugin-techdocs-backend@0.5.4
- @backstage/plugin-auth-backend@0.2.11
- @backstage/plugin-lighthouse@0.2.8
- @backstage/plugin-circleci@0.2.6
- @backstage/plugin-search@0.2.6
- @backstage/plugin-explore@0.2.3
- @backstage/plugin-tech-radar@0.3.3
- @backstage/plugin-user-settings@0.2.4
- @backstage/plugin-app-backend@0.3.4
- @backstage/plugin-proxy-backend@0.2.4
- @backstage/plugin-rollbar-backend@0.1.7

0.3.5

Patch Changes

94fdf4955: Get rid of all usages of @octokit/types, and bump the rest of the octokit dependencies to the latest version
cc068c0d6: Bump the gitbeaker dependencies to 28.x.

To update your own installation, go through the package.json files of all of your packages, and ensure that all dependencies on @gitbeaker/node or @gitbeaker/core are at version ^28.0.2. Then run yarn install at the root of your repo.

0.3.4

Patch Changes

643dcec7c: noop release for create-app to force re-deploy

0.3.3

Patch Changes

bd9c6719f: Bumping the version for create-app so that we can use the latest versions of internal packages and rebuild the version which is passed to the package.json

0.3.2

Patch Changes

c2b52d9c5: Replace register-component plugin with new catalog-import plugin
fc6839f13: Bump sqlite3 to v5.

To apply this change to an existing app, change the version of sqlite3 in the dependencies of packages/backend/package.json:
```
     "pg": "^8.3.0",
-    "sqlite3": "^4.2.0",
+    "sqlite3": "^5.0.0",
     "winston": "^3.2.1"
```
Note that the sqlite3 dependency may not be preset if you chose to use PostgreSQL when creating the app.
8d68e4cdc: Removed the Circle CI sidebar item, since the target page does not exist.

To apply this change to an existing app, remove "CircleCI" sidebar item from packages/app/src/sidebar.tsx, and the BuildIcon import if it is unused.
1773a5182: Removed lighthouse plugin from the default set up plugins, as it requires a separate Backend to function.

To apply this change to an existing app, remove the following:
1. The lighthouse block from app-config.yaml.
2. The @backstage/plugin-lighthouse dependency from packages/app/package.json.
3. The @backstage/plugin-lighthouse re-export from packages/app/src/plugins.ts.
4. The Lighthouse sidebar item from packages/app/src/sidebar.tsx, and the RuleIcon import if it is unused.

0.3.1

Patch Changes

4e0e3b1bf: Add missing yarn clean for app.

For users with existing Backstage installations, add the following under the scripts section in packages/app/package.json, after the "lint" entry:
```
"clean": "backstage-cli clean",
```
This will add the missing yarn clean for the generated frontend.
352a6581f: Added "start-backend" script to root package.json.

To apply this change to an existing app, add the following script to the root package.json:
```
"start-backend": "yarn workspace backend start"
```

0.3.0

Minor Changes

0101c7a16: Add search plugin to default template for CLI created apps

Patch Changes

a8573e53b: techdocs-backend: Simplified file, removing individual preparers and generators. techdocs-backend: UrlReader is now available to use in preparers.

In your Backstage app, packages/backend/plugins/techdocs.ts file has now been simplified, to remove registering individual preparers and generators.

Please update the file when upgrading the version of @backstage/plugin-techdocs-backend package.
```
const preparers = await Preparers.fromConfig(config, {
  logger,
  reader,
});

const generators = await Generators.fromConfig(config, {
  logger,
});

const publisher = await Publisher.fromConfig(config, {
  logger,
  discovery,
});
```
You should be able to remove unnecessary imports, and just do
```
import {
  createRouter,
  Preparers,
  Generators,
  Publisher,
} from '@backstage/plugin-techdocs-backend';
```

0.2.5

Patch Changes

2783ec018: In the techdocs-backend plugin (packages/backend/src/plugins/techdocs.ts), create a publisher using
```
  const publisher = Publisher.fromConfig(config, logger, discovery);
```
instead of
```
  const publisher = new LocalPublish(logger, discovery);
```
An instance of publisher can either be a local filesystem publisher or a Google Cloud Storage publisher.

Read more about the configs here https://backstage.io/docs/features/techdocs/configuration (You will also have to update techdocs.storage.type to local or googleGcs. And techdocs.builder to either local or external.)

0.2.4

Patch Changes

94348441e: Add "files": ["dist"] to both app and backend packages. This ensures that packaged versions of these packages do not contain unnecessary files.

To apply this change to an existing app, add the following to packages/app/package.json and packages/backend/package.json:
```
  "files": [
    "dist"
  ]
```

cb5fc4b29: Adjust template to the latest changes in the api-docs plugin.

Template Changes

While updating to the latest api-docs plugin, the following changes are necessary for the create-app template in your app/src/components/catalog/EntityPage.tsx. This adds:

A custom entity page for API entities
Changes the API tab to include the new ConsumedApisCard and ProvidedApisCard that link to the API entity.

 import {
+  ApiDefinitionCard,
-  Router as ApiDocsRouter,
+  ConsumedApisCard,
+  ProvidedApisCard,
+  ConsumedApisCard,
+  ConsumingComponentsCard,
+  ProvidedApisCard,
+  ProvidingComponentsCard
 } from '@backstage/plugin-api-docs';

...

+const ComponentApisContent = ({ entity }: { entity: Entity }) => (
+  <Grid container spacing={3} alignItems="stretch">
+    <Grid item md={6}>
+      <ProvidedApisCard entity={entity} />
+    </Grid>
+    <Grid item md={6}>
+      <ConsumedApisCard entity={entity} />
+    </Grid>
+  </Grid>
+);

 const ServiceEntityPage = ({ entity }: { entity: Entity }) => (
   <EntityPageLayout>
     <EntityPageLayout.Content
      path="/"
      title="Overview"
      element={<OverviewContent entity={entity} />}
    />
    <EntityPageLayout.Content
      path="/ci-cd/*"
      title="CI/CD"
      element={<CICDSwitcher entity={entity} />}
    />
    <EntityPageLayout.Content
      path="/api/*"
      title="API"
-     element={<ApiDocsRouter entity={entity} />}
+     element={<ComponentApisContent entity={entity} />}
    />
...

-export const EntityPage = () => {
-  const { entity } = useEntity();
-  switch (entity?.spec?.type) {
-    case 'service':
-      return <ServiceEntityPage entity={entity} />;
-    case 'website':
-      return <WebsiteEntityPage entity={entity} />;
-    default:
-      return <DefaultEntityPage entity={entity} />;
-  }
-};

+export const ComponentEntityPage = ({ entity }: { entity: Entity }) => {
+  switch (entity?.spec?.type) {
+    case 'service':
+      return <ServiceEntityPage entity={entity} />;
+    case 'website':
+      return <WebsiteEntityPage entity={entity} />;
+    default:
+      return <DefaultEntityPage entity={entity} />;
+  }
+};
+
+const ApiOverviewContent = ({ entity }: { entity: Entity }) => (
+  <Grid container spacing={3}>
+    <Grid item md={6}>
+      <AboutCard entity={entity} />
+    </Grid>
+    <Grid container item md={12}>
+      <Grid item md={6}>
+        <ProvidingComponentsCard entity={entity} />
+      </Grid>
+      <Grid item md={6}>
+        <ConsumingComponentsCard entity={entity} />
+      </Grid>
+    </Grid>
+  </Grid>
+);
+
+const ApiDefinitionContent = ({ entity }: { entity: ApiEntity }) => (
+  <Grid container spacing={3}>
+    <Grid item xs={12}>
+      <ApiDefinitionCard apiEntity={entity} />
+    </Grid>
+  </Grid>
+);
+
+const ApiEntityPage = ({ entity }: { entity: Entity }) => (
+  <EntityPageLayout>
+    <EntityPageLayout.Content
+      path="/*"
+      title="Overview"
+      element={<ApiOverviewContent entity={entity} />}
+    />
+    <EntityPageLayout.Content
+      path="/definition/*"
+      title="Definition"
+      element={<ApiDefinitionContent entity={entity as ApiEntity} />}
+    />
+  </EntityPageLayout>
+);
+
+export const EntityPage = () => {
+  const { entity } = useEntity();
+
+  switch (entity?.kind?.toLowerCase()) {
+    case 'component':
+      return <ComponentEntityPage entity={entity} />;
+    case 'api':
+      return <ApiEntityPage entity={entity} />;
+    default:
+      return <DefaultEntityPage entity={entity} />;
+  }
+};

1e22f8e0b: Unify dockerode library and type dependency versions

0.2.3

Patch Changes

68fdc3a9f: Optimized the yarn install step in the backend Dockerfile.

To apply these changes to an existing app, make the following changes to packages/backend/Dockerfile:

Replace the RUN yarn install ... line with the following:
```
RUN yarn install --frozen-lockfile --production --network-timeout 300000 && rm -rf "$(yarn cache dir)"
```
4a655c89d: Removed "resolutions" entry for esbuild in the root package.json in order to use the version specified by @backstage/cli.

To apply this change to an existing app, remove the following from your root package.json:
```
"resolutions": {
  "esbuild": "0.6.3"
},
```
ea475893d: Add API docs plugin to new apps being created through the CLI.

0.2.2

Patch Changes

7d7abd50c: Add app-backend as a backend plugin, and make a single docker build of the backend the default way to deploy backstage.

Note that the app-backend currently only is a solution for deployments of the app, it's not a dev server and is not intended for local development.

Template changes

As a part of installing the app-backend plugin, the below changes where made. The changes are grouped into two steps, installing the plugin, and updating the Docker build and configuration.

Installing the app-backend plugin in the backend

First, install the @backstage/plugin-app-backend plugin package in your backend. These changes where made for v0.3.0 of the plugin, and the installation process might change in the future. Run the following from the root of the repo:
```
cd packages/backend
yarn add @backstage/plugin-app-backend
```
For the app-backend to get access to the static content in the frontend we also need to add the local app package as a dependency. Add the following to your "dependencies" in packages/backend/package.json, assuming your app package is still named app and on version 0.0.0:
```
"app": "0.0.0",
```
Don't worry, this will not cause your entire frontend dependency tree to be added to the app, just double check that packages/app/package.json has a "bundled": true field at top-level. This signals to the backend build process that the package is bundled and that no transitive dependencies should be included.

Next, create packages/backend/src/plugins/app.ts with the following:
```
import { createRouter } from '@backstage/plugin-app-backend';
import { PluginEnvironment } from '../types';

export default async function createPlugin({
  logger,
  config,
}: PluginEnvironment) {
  return await createRouter({
    logger,
    config,
    appPackageName: 'app',
  });
}
```
In packages/backend/src/index.ts, make the following changes:

Add an import for the newly created plugin setup file:
```
import app from './plugins/app';
```
Setup the following plugin env.
```
const appEnv = useHotMemoize(module, () => createEnv('app'));
```
Change service builder setup to include the app plugin as follows. Note that the app plugin is not installed on the /api route with most other plugins.
```
const service = createServiceBuilder(module)
  .loadConfig(config)
  .addRouter('/api', apiRouter)
  .addRouter('', await app(appEnv));
```
You should now have the app-backend plugin installed in your backend, ready to serve the frontend bundle!

Docker build setup

Since the backend image is now the only one needed for a simple Backstage deployment, the image tag name in the build-image script inside packages/backend/package.json was changed to the following:
```
"build-image": "backstage-cli backend:build-image --build --tag backstage",
```
For convenience, a build-image script was also added to the root package.json with the following:
```
"build-image": "yarn workspace backend build-image",
```
In the root of the repo, a new app-config.production.yaml file was added. This is used to set the appropriate app.baseUrl now that the frontend is served directly by the backend in the production deployment. It has the following contents:
```
app:
  # Should be the same as backend.baseUrl when using the `app-backend` plugin
  baseUrl: http://localhost:7000

backend:
  baseUrl: http://localhost:7000
  listen:
    port: 7000
```
In order to load in the new configuration at runtime, the command in the Dockerfile at the repo root was changed to the following:
```
CMD ["node", "packages/backend", "--config", "app-config.yaml", "--config", "app-config.production.yaml"]
```

0.2.1

Patch Changes

c56e28375: Fix missing api-docs plugin registration in app template

0.2.0

Minor Changes

6d29605db: Change the default backend plugin mount point to /api
5249594c5: Add service discovery interface and implement for single host deployments

Fixes #1847, #2596

Went with an interface similar to the frontend DiscoveryApi, since it's dead simple but still provides a lot of flexibility in the implementation.

Also ended up with two different methods, one for internal endpoint discovery and one for external. The two use-cases are explained a bit more in the docs, but basically it's service-to-service vs callback URLs.

This did get me thinking about uniqueness and that we're heading towards a global namespace for backend plugin IDs. That's probably fine, but if we're happy with that we should leverage it a bit more to simplify the backend setup. For example we'd have each plugin provide its own ID and not manually mount on paths in the backend.

Draft until we're happy with the implementation, then I can add more docs and changelog entry. Also didn't go on a thorough hunt for places where discovery can be used, but I don't think there are many since it's been pretty awkward to do service-to-service communication.
56e4eb589: Make CSP configurable to fix app-backend served app not being able to fetch

See discussion here on discord
d7873e1aa: Default to using internal scope for new plugins
6f447b3fc: Remove identity-backend

Not used, and we're heading down the route of identities in the catalog
61db1ddc6: Allow node v14 and add to master build matrix
- Upgrade sqlite3@^5.0.0 in @backstage/plugin-catalog-backend
- Add Node 14 to engines in @backstage/create-app
a768a07fb: Add the ability to import users from GitHub Organization into the catalog.

The token needs to have the scopes user:email, read:user, and read:org.
f00ca3cb8: Auto-create plugin databases

Relates to #1598.

This creates databases for plugins before handing off control to plugins.

The list of plugins currently need to be hard-coded depending on the installed plugins. A later PR will properly refactor the code to provide a factory pattern where plugins specify what they need, and Knex instances will be provided based on the input.
6d97d2d6f: The InfoCard variant 'height100' is deprecated. Use variant 'gridItem' instead.

When the InfoCard is displayed as a grid item within a grid, you may want items to have the same height for all items. Set to the 'gridItem' variant to display the InfoCard with full height suitable for Grid: <InfoCard variant="gridItem">...</InfoCard>

Changed the InfoCards in '@backstage/plugin-github-actions', '@backstage/plugin-jenkins', '@backstage/plugin-lighthouse' to pass an optional variant to the corresponding card of the plugin.

As a result the overview content of the EntityPage shows cards with full height suitable for Grid.
7aff112af: The default mount point for backend plugins have been changed to /api. These changes are done in the backend package itself, so it is recommended that you sync up existing backend packages with this new pattern.

Patch Changes

e67d49bf5: Sync scaffolded backend with example
961414d55: Remove discovery api override
440a17b39: Bump @backstage/catalog-backend and pass the now required UrlReader interface to the plugin
8c2b76e45: BREAKING CHANGE

The existing loading of additional config files like app-config.development.yaml using APP_ENV or NODE_ENV has been removed. Instead, the CLI and backend process now accept one or more --config flags to load config files.

Without passing any flags, app-config.yaml and, if it exists, app-config.local.yaml will be loaded. If passing any --config <path> flags, only those files will be loaded, NOT the default app-config.yaml one.

The old behaviour of for example APP_ENV=development can be replicated using the following flags:
```
--config ../../app-config.yaml --config ../../app-config.development.yaml
```

5a920c6e4: Updated naming of environment variables. New pattern [NAME]_TOKEN for GitHub, GitLab, Azure & GitHub Enterprise access tokens.

Detail:

Previously we have to export same token for both, catalog & scaffolder

export GITHUB_ACCESS_TOKEN=foo
export GITHUB_PRIVATE_TOKEN=foo

with latest changes, only single export is sufficient.

export GITHUB_TOKEN=foo
export GITLAB_TOKEN=foo
export GHE_TOKEN=foo
export AZURE_TOKEN=foo

list:

Old name	New name
GITHUB_ACCESS_TOKEN	GITHUB_TOKEN
GITHUB_PRIVATE_TOKEN	GITHUB_TOKEN
GITLAB_ACCESS_TOKEN	GITLAB_TOKEN
GITLAB_PRIVATE_TOKEN	GITLAB_TOKEN
AZURE_PRIVATE_TOKEN	AZURE_TOKEN
GHE_PRIVATE_TOKEN	GHE_TOKEN

67d76b419: Fix for configured templates using 'url' locations even though it's not supported yet
7bbeb049f: Change loadBackendConfig to return the config directly

301 KiB Raw Blame History

@backstage/create-app

0.8.4-next.0

Patch Changes

0.8.3

Patch Changes

0.8.3-next.3

Patch Changes

0.8.3-next.2

Patch Changes

0.8.3-next.1

Patch Changes

0.8.3-next.0

Patch Changes

0.8.2

Patch Changes

0.8.2-next.2

Patch Changes

0.8.2-next.1

Patch Changes

0.8.2-next.0

Patch Changes

0.8.0

Minor Changes

Patch Changes

0.7.10-next.2

Patch Changes

0.7.10-next.1

Patch Changes

0.7.10-next.0

Patch Changes

0.7.9

Patch Changes

0.7.9-next.2

Patch Changes

0.7.9-next.1

Patch Changes

0.7.9-next.0

Patch Changes

0.7.8

Patch Changes

0.7.8-next.3

Patch Changes

0.7.8-next.2

Patch Changes

0.7.8-next.1

Patch Changes

0.7.8-next.0

Patch Changes

0.7.7

Patch Changes

0.7.7-next.2

Patch Changes

0.7.7-next.1

Patch Changes

0.7.7-next.0

Patch Changes

0.7.6

Patch Changes

0.7.6-next.3

Patch Changes

0.7.6-next.2

Patch Changes

0.7.6-next.1

Patch Changes

0.7.6-next.0

Patch Changes

0.7.5

Patch Changes

0.7.5-next.3

Patch Changes

0.7.5-next.2

Patch Changes

0.7.5-next.1

Patch Changes

0.7.5-next.0

Patch Changes

0.7.4

Patch Changes

0.7.4-next.2

301 KiB

Raw Blame History