@backstage-community/plugin-npm-backend 1.15.0 → 1.17.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @backstage-community/plugin-npm-backend
 
+## 1.17.0
+
+### Minor Changes
+
+- c235037: Backstage version bump to v1.47.2
+
+### Patch Changes
+
+- Updated dependencies [c235037]
+  - @backstage-community/plugin-npm-common@1.17.0
+
+## 1.16.0
+
+### Minor Changes
+
+- d4dad74: Backstage version bump to v1.46.2
+
+### Patch Changes
+
+- Updated dependencies [d4dad74]
+  - @backstage-community/plugin-npm-common@1.16.0
+
 ## 1.15.0
 
 ### Minor Changes

package/README.md

@@ -91,6 +91,70 @@ you must install also the backend plugin and [configure it](./registries.md).
 
 ### Frontend plugin
 
+### Load plugin via the new frontend system (alpha)
+
+For early adaopters of the new frontend system.
+
+Your Backstage frontend app must use that new frontend system which isn't the default at the moment.
+
+1. Install the frontend dependency:
+
+   ```sh
+   yarn workspace app-next add @backstage-community/plugin-npm
+   ```
+
+2. Add the package to your `packages/app-next/src/App.tsx`.
+
+   ```tsx
+   import npmPlugin from '@backstage-community/plugin-npm/alpha';
+   ```
+
+   And extend your createApp:
+
+   ```tsx
+   export const app = createApp({
+     features: [
+       // ...other plugins
+       npmPlugin,
+     ],
+   });
+   ```
+
+3. Optional enable translation via the `TranslationBlueprint` extension:
+
+   ```tsx
+   import { TranslationBlueprint } from '@backstage/plugin-app-react';
+
+   import npmPlugin, {
+     npmTranslations,
+   } from '@backstage-community/plugin-npm/alpha';
+   ```
+
+   ```tsx
+   const npmTranslation = TranslationBlueprint.make({
+     name: 'npmTranslation',
+     params: {
+       resource: npmTranslations,
+     },
+   });
+
+   export default createApp({
+     features: [
+       createFrontendModule({
+         pluginId: 'app',
+         extensions: [
+           // ...other extensions
+           npmTranslation,
+         ],
+       }),
+       // ...other plugins
+       npmPlugin,
+     ],
+   });
+   ```
+
+### Manual wiring the frontend plugin ("Old Frontend System")
+
 1. Install the frontend dependency:
 
    ```sh
@@ -140,44 +204,12 @@ you must install also the backend plugin and [configure it](./registries.md).
    </EntityLayout.Route>
    ```
 
-### Alternative: Use the new frontend system (alpha)
-
-For early adaopters of the new frontend system.
-
-Your Backstage frontend app must use that new frontend system which isn't the default at the moment.
-
-1. Install the frontend dependency:
-
-   ```sh
-   yarn workspace app-next add @backstage-community/plugin-npm
-   ```
-
-2. Add the package to your `packages/app[-next]/src/App.tsx`.
-
-   ```tsx
-   import npmPlugin from '@backstage-community/plugin-npm/alpha';
-   ```
-
-   And extend your createApp:
-
-   ```tsx
-   export const app = createApp({
-     features: [
-       catalogPlugin,
-       catalogImportPlugin,
-       userSettingsPlugin,
-       npmPlugin,
-       // ...
-     ],
-   });
-   ```
-
 ### Optional: Backend plugin (req. for private packages or alternative registries)
 
 1. Install the backend plugin:
 
    ```sh
-   yarn workspace backend add @backstage-community/plugin-npm
+   yarn workspace backend add @backstage-community/plugin-npm-backend
    ```
 
 2. Add it to `packages/backend/src/index.ts`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage-community/plugin-npm-backend",
-  "version": "1.15.0",
+  "version": "1.17.0",
   "main": "dist/index.cjs.js",
   "types": "dist/index.d.ts",
   "license": "Apache-2.0",
@@ -33,17 +33,17 @@
     "postpack": "backstage-cli package postpack"
   },
   "dependencies": {
-    "@backstage-community/plugin-npm-common": "^1.15.0",
-    "@backstage/backend-defaults": "^0.13.1",
-    "@backstage/backend-plugin-api": "^1.5.0",
+    "@backstage-community/plugin-npm-common": "^1.17.0",
+    "@backstage/backend-defaults": "^0.15.1",
+    "@backstage/backend-plugin-api": "^1.6.2",
     "@backstage/errors": "^1.2.7",
-    "@backstage/plugin-catalog-node": "^1.20.0",
+    "@backstage/plugin-catalog-node": "^1.20.1",
     "express": "^4.17.1",
     "express-promise-router": "^4.1.0"
   },
   "devDependencies": {
-    "@backstage/backend-test-utils": "^1.10.0",
-    "@backstage/cli": "^0.34.5",
+    "@backstage/backend-test-utils": "^1.10.4",
+    "@backstage/cli": "^0.35.3",
     "@types/express": "^4.17.1"
   },
   "files": [