@backstage/cli 0.28.0-next.2 → 0.29.0-next.0

package/dist/lib/cache/SuccessCache.cjs.js

@@ -0,0 +1,70 @@
+'use strict';
+
+var fs = require('fs-extra');
+var node_path = require('node:path');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
+
+const DEFAULT_CACHE_BASE_PATH = "node_modules/.cache/backstage-cli";
+const CACHE_MAX_AGE_MS = 7 * 24 * 36e5;
+class SuccessCache {
+  #path;
+  constructor(name, basePath) {
+    this.#path = node_path.resolve(basePath ?? DEFAULT_CACHE_BASE_PATH, name);
+  }
+  async read() {
+    try {
+      const stat = await fs__default.default.stat(this.#path);
+      if (!stat.isDirectory()) {
+        await fs__default.default.rm(this.#path);
+        return /* @__PURE__ */ new Set();
+      }
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        return /* @__PURE__ */ new Set();
+      }
+      throw error;
+    }
+    const items = await fs__default.default.readdir(this.#path);
+    const returned = /* @__PURE__ */ new Set();
+    const removed = /* @__PURE__ */ new Set();
+    const now = Date.now();
+    for (const item of items) {
+      const split = item.split("_");
+      if (split.length !== 2) {
+        removed.add(item);
+        continue;
+      }
+      const createdAt = parseInt(split[0], 10);
+      if (Number.isNaN(createdAt) || now - createdAt > CACHE_MAX_AGE_MS) {
+        removed.add(item);
+      } else {
+        returned.add(split[1]);
+      }
+    }
+    for (const item of removed) {
+      await fs__default.default.unlink(node_path.resolve(this.#path, item));
+    }
+    return returned;
+  }
+  async write(newEntries) {
+    const now = Date.now();
+    await fs__default.default.ensureDir(this.#path);
+    const existingItems = await fs__default.default.readdir(this.#path);
+    const empty = Buffer.alloc(0);
+    for (const key of newEntries) {
+      const trimmedItems = existingItems.filter(
+        (item) => item.endsWith(`_${key}`)
+      );
+      for (const trimmedItem of trimmedItems) {
+        await fs__default.default.unlink(node_path.resolve(this.#path, trimmedItem));
+      }
+      await fs__default.default.writeFile(node_path.resolve(this.#path, `${now}_${key}`), empty);
+    }
+  }
+}
+
+exports.SuccessCache = SuccessCache;
+//# sourceMappingURL=SuccessCache.cjs.js.map

package/dist/lib/packager/createDistWorkspace.cjs.js

@@ -118,7 +118,7 @@ async function createDistWorkspace(packageNames, options = {}) {
   await moveToDistWorkspace(
     targetDir,
     targets,
-    Boolean(options.alwaysYarnPack),
+    Boolean(options.alwaysPack),
     Boolean(options.enableFeatureDetection)
   );
   const files = options.files ?? ["yarn.lock", "package.json"];
@@ -150,10 +150,10 @@ const FAST_PACK_SCRIPTS = [
   "backstage-cli prepack",
   "backstage-cli package prepack"
 ];
-async function moveToDistWorkspace(workspaceDir, localPackages, alwaysYarnPack, enableFeatureDetection) {
+async function moveToDistWorkspace(workspaceDir, localPackages, alwaysPack, enableFeatureDetection) {
   const [fastPackPackages, slowPackPackages] = partition__default.default(
     localPackages,
-    (pkg) => !alwaysYarnPack && FAST_PACK_SCRIPTS.includes(pkg.packageJson.scripts?.prepack)
+    (pkg) => !alwaysPack && FAST_PACK_SCRIPTS.includes(pkg.packageJson.scripts?.prepack)
   );
   const featureDetectionProject = fastPackPackages.length > 0 && enableFeatureDetection ? await typeDistProject.createTypeDistProject() : void 0;
   await Promise.all(

package/dist/lib/{experimental/startBackendExperimental.cjs.js → runner/runBackend.cjs.js}

@@ -2,8 +2,8 @@
 
 var chokidar = require('chokidar');
 var ctrlcWindows = require('ctrlc-windows');
-var IpcServer = require('./IpcServer.cjs.js');
-var ServerDataStore = require('./ServerDataStore.cjs.js');
+var IpcServer = require('../ipc/IpcServer.cjs.js');
+var ServerDataStore = require('../ipc/ServerDataStore.cjs.js');
 var debounce = require('lodash/debounce');
 var url = require('url');
 var path = require('path');
@@ -21,7 +21,7 @@ const loaderArgs = [
   require.resolve("@backstage/cli/config/nodeTransform.cjs")
   // TODO: Support modules, although there's currently no way to load them since import() is transpiled tp require()
 ];
-async function startBackendExperimental(options) {
+async function runBackend(options) {
   const envEnv = process.env;
   if (!envEnv.NODE_ENV) {
     envEnv.NODE_ENV = "development";
@@ -77,6 +77,7 @@ async function startBackendExperimental(options) {
         stdio: ["ignore", "inherit", "inherit", "ipc"],
         env: {
           ...process.env,
+          BACKSTAGE_CLI_LINKED_WORKSPACE: options.linkedWorkspace,
           BACKSTAGE_CLI_CHANNEL: "1",
           ESBK_TSCONFIG_PATH: paths.paths.resolveTargetRoot("tsconfig.json")
         },
@@ -124,5 +125,5 @@ async function startBackendExperimental(options) {
   return () => exitPromise;
 }
 
-exports.startBackendExperimental = startBackendExperimental;
-//# sourceMappingURL=startBackendExperimental.cjs.js.map
+exports.runBackend = runBackend;
+//# sourceMappingURL=runBackend.cjs.js.map

package/dist/lib/version.cjs.js

@@ -5,17 +5,21 @@ var semver = require('semver');
 var paths = require('./paths.cjs.js');
 var _package$1 = require('../packages/backend-plugin-api/package.json.cjs.js');
 var _package$2 = require('../packages/backend-test-utils/package.json.cjs.js');
-var _package$3 = require('../packages/cli/package.json.cjs.js');
-var _package$4 = require('../packages/config/package.json.cjs.js');
-var _package$5 = require('../packages/core-app-api/package.json.cjs.js');
-var _package$6 = require('../packages/core-components/package.json.cjs.js');
-var _package$7 = require('../packages/core-plugin-api/package.json.cjs.js');
-var _package$8 = require('../packages/dev-utils/package.json.cjs.js');
-var _package$9 = require('../packages/test-utils/package.json.cjs.js');
-var _package$b = require('../plugins/scaffolder-node/package.json.cjs.js');
-var _package$c = require('../plugins/auth-backend/package.json.cjs.js');
-var _package$d = require('../plugins/auth-backend-module-guest-provider/package.json.cjs.js');
-var _package$a = require('../packages/theme/package.json.cjs.js');
+var _package$3 = require('../packages/catalog-client/package.json.cjs.js');
+var _package$4 = require('../packages/cli/package.json.cjs.js');
+var _package$5 = require('../packages/config/package.json.cjs.js');
+var _package$6 = require('../packages/core-app-api/package.json.cjs.js');
+var _package$7 = require('../packages/core-components/package.json.cjs.js');
+var _package$8 = require('../packages/core-plugin-api/package.json.cjs.js');
+var _package$9 = require('../packages/dev-utils/package.json.cjs.js');
+var _package$a = require('../packages/errors/package.json.cjs.js');
+var _package$b = require('../packages/test-utils/package.json.cjs.js');
+var _package$d = require('../plugins/scaffolder-node/package.json.cjs.js');
+var _package$e = require('../plugins/scaffolder-node-test-utils/package.json.cjs.js');
+var _package$f = require('../plugins/auth-backend/package.json.cjs.js');
+var _package$g = require('../plugins/auth-backend-module-guest-provider/package.json.cjs.js');
+var _package$h = require('../plugins/catalog-node/package.json.cjs.js');
+var _package$c = require('../packages/theme/package.json.cjs.js');
 var _package = require('../packages/backend-defaults/package.json.cjs.js');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
@@ -27,17 +31,21 @@ const packageVersions = {
   "@backstage/backend-defaults": _package.version,
   "@backstage/backend-plugin-api": _package$1.version,
   "@backstage/backend-test-utils": _package$2.version,
-  "@backstage/cli": _package$3.version,
-  "@backstage/config": _package$4.version,
-  "@backstage/core-app-api": _package$5.version,
-  "@backstage/core-components": _package$6.version,
-  "@backstage/core-plugin-api": _package$7.version,
-  "@backstage/dev-utils": _package$8.version,
-  "@backstage/test-utils": _package$9.version,
-  "@backstage/theme": _package$a.version,
-  "@backstage/plugin-scaffolder-node": _package$b.version,
-  "@backstage/plugin-auth-backend": _package$c.version,
-  "@backstage/plugin-auth-backend-module-guest-provider": _package$d.version
+  "@backstage/catalog-client": _package$3.version,
+  "@backstage/cli": _package$4.version,
+  "@backstage/config": _package$5.version,
+  "@backstage/core-app-api": _package$6.version,
+  "@backstage/core-components": _package$7.version,
+  "@backstage/core-plugin-api": _package$8.version,
+  "@backstage/dev-utils": _package$9.version,
+  "@backstage/errors": _package$a.version,
+  "@backstage/test-utils": _package$b.version,
+  "@backstage/theme": _package$c.version,
+  "@backstage/plugin-scaffolder-node": _package$d.version,
+  "@backstage/plugin-scaffolder-node-test-utils": _package$e.version,
+  "@backstage/plugin-auth-backend": _package$f.version,
+  "@backstage/plugin-auth-backend-module-guest-provider": _package$g.version,
+  "@backstage/plugin-catalog-node": _package$h.version
 };
 function findVersion() {
   const pkgContent = fs__default.default.readFileSync(paths.paths.resolveOwn("package.json"), "utf8");

package/dist/packages/backend-defaults/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.5.1-next.2";
+var version = "0.5.3-next.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/backend-plugin-api/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.0.1-next.1";
+var version = "1.0.2-next.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/backend-test-utils/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.0.1-next.2";
+var version = "1.0.3-next.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/catalog-client/package.json.cjs.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var version = "1.8.0-next.0";
+
+exports.version = version;
+//# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/cli/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.28.0-next.2";
+var version = "0.29.0-next.0";
 var dependencies = {
 	"@backstage/catalog-model": "workspace:^",
 	"@backstage/cli-common": "workspace:^",
@@ -50,7 +50,7 @@ var dependencies = {
 	"cross-spawn": "^7.0.3",
 	"css-loader": "^6.5.1",
 	"ctrlc-windows": "^2.1.0",
-	esbuild: "^0.23.0",
+	esbuild: "^0.24.0",
 	"esbuild-loader": "^4.0.0",
 	eslint: "^8.6.0",
 	"eslint-config-prettier": "^9.0.0",
@@ -69,6 +69,7 @@ var dependencies = {
 	"git-url-parse": "^15.0.0",
 	glob: "^7.1.7",
 	"global-agent": "^3.0.0",
+	globby: "^11.1.0",
 	handlebars: "^4.7.3",
 	"html-webpack-plugin": "^5.3.1",
 	inquirer: "^8.2.0",
@@ -100,7 +101,6 @@ var dependencies = {
 	"rollup-plugin-esbuild": "^6.1.1",
 	"rollup-plugin-postcss": "^4.0.0",
 	"rollup-pluginutils": "^2.8.2",
-	"run-script-webpack-plugin": "^0.2.0",
 	semver: "^7.5.3",
 	"style-loader": "^3.3.1",
 	sucrase: "^3.20.2",
@@ -109,9 +109,8 @@ var dependencies = {
 	"terser-webpack-plugin": "^5.1.3",
 	"ts-morph": "^23.0.0",
 	util: "^0.12.3",
-	webpack: "^5.70.0",
+	webpack: "^5.94.0",
 	"webpack-dev-server": "^5.0.0",
-	"webpack-node-externals": "^3.0.0",
 	yaml: "^2.0.0",
 	yargs: "^16.2.0",
 	"yml-loader": "^2.1.0",
@@ -122,13 +121,23 @@ var devDependencies = {
 	"@backstage/backend-common": "^0.25.0",
 	"@backstage/backend-plugin-api": "workspace:^",
 	"@backstage/backend-test-utils": "workspace:^",
+	"@backstage/catalog-client": "workspace:^",
 	"@backstage/config": "workspace:^",
 	"@backstage/core-app-api": "workspace:^",
 	"@backstage/core-components": "workspace:^",
 	"@backstage/core-plugin-api": "workspace:^",
 	"@backstage/dev-utils": "workspace:^",
+	"@backstage/errors": "workspace:^",
+	"@backstage/plugin-auth-backend": "workspace:^",
+	"@backstage/plugin-auth-backend-module-guest-provider": "workspace:^",
+	"@backstage/plugin-catalog-node": "workspace:^",
+	"@backstage/plugin-scaffolder-node": "workspace:^",
+	"@backstage/plugin-scaffolder-node-test-utils": "workspace:^",
 	"@backstage/test-utils": "workspace:^",
 	"@backstage/theme": "workspace:^",
+	"@rspack/core": "^1.0.10",
+	"@rspack/dev-server": "^1.0.9",
+	"@rspack/plugin-react-refresh": "^1.0.0",
 	"@types/cross-spawn": "^6.0.2",
 	"@types/ejs": "^3.1.3",
 	"@types/express": "^4.17.6",
@@ -143,6 +152,7 @@ var devDependencies = {
 	"@types/svgo": "^2.6.2",
 	"@types/tar": "^6.1.1",
 	"@types/terser-webpack-plugin": "^5.0.4",
+	"@types/webpack-sources": "^3.2.3",
 	"@types/yarnpkg__lockfile": "^1.1.4",
 	"@vitejs/plugin-react": "^4.3.1",
 	del: "^7.0.0",

package/dist/packages/core-app-api/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.15.1-next.1";
+var version = "1.15.1";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/core-components/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.15.1-next.2";
+var version = "0.16.0-next.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/core-plugin-api/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.10.0-next.1";
+var version = "1.10.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/dev-utils/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.1.2-next.2";
+var version = "1.1.3-next.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/errors/package.json.cjs.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var version = "1.2.4";
+
+exports.version = version;
+//# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/test-utils/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.6.1-next.2";
+var version = "1.7.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/theme/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.6.0-next.1";
+var version = "0.6.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/plugins/auth-backend/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.23.1-next.1";
+var version = "0.24.0-next.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/plugins/auth-backend-module-guest-provider/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.2.1-next.1";
+var version = "0.2.2-next.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/plugins/catalog-node/package.json.cjs.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var version = "1.14.0-next.0";
+
+exports.version = version;
+//# sourceMappingURL=package.json.cjs.js.map

package/dist/plugins/scaffolder-node/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.5.0-next.2";
+var version = "0.5.1-next.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/plugins/scaffolder-node-test-utils/package.json.cjs.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var version = "0.1.15-next.0";
+
+exports.version = version;
+//# sourceMappingURL=package.json.cjs.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/cli",
-  "version": "0.28.0-next.2",
+  "version": "0.29.0-next.0",
   "description": "CLI for developing Backstage plugins and apps",
   "backstage": {
     "role": "cli"
@@ -44,12 +44,12 @@
   "dependencies": {
     "@backstage/catalog-model": "1.7.0",
     "@backstage/cli-common": "0.1.14",
-    "@backstage/cli-node": "0.2.9-next.0",
+    "@backstage/cli-node": "0.2.9",
     "@backstage/config": "1.2.0",
     "@backstage/config-loader": "1.9.1",
     "@backstage/errors": "1.2.4",
-    "@backstage/eslint-plugin": "0.1.10-next.1",
-    "@backstage/integration": "1.15.1-next.1",
+    "@backstage/eslint-plugin": "0.1.10",
+    "@backstage/integration": "1.15.1",
     "@backstage/release-manifests": "0.0.11",
     "@backstage/types": "1.1.1",
     "@manypkg/get-packages": "^1.1.3",
@@ -90,7 +90,7 @@
     "cross-spawn": "^7.0.3",
     "css-loader": "^6.5.1",
     "ctrlc-windows": "^2.1.0",
-    "esbuild": "^0.23.0",
+    "esbuild": "^0.24.0",
     "esbuild-loader": "^4.0.0",
     "eslint": "^8.6.0",
     "eslint-config-prettier": "^9.0.0",
@@ -109,6 +109,7 @@
     "git-url-parse": "^15.0.0",
     "glob": "^7.1.7",
     "global-agent": "^3.0.0",
+    "globby": "^11.1.0",
     "handlebars": "^4.7.3",
     "html-webpack-plugin": "^5.3.1",
     "inquirer": "^8.2.0",
@@ -140,7 +141,6 @@
     "rollup-plugin-esbuild": "^6.1.1",
     "rollup-plugin-postcss": "^4.0.0",
     "rollup-pluginutils": "^2.8.2",
-    "run-script-webpack-plugin": "^0.2.0",
     "semver": "^7.5.3",
     "style-loader": "^3.3.1",
     "sucrase": "^3.20.2",
@@ -149,9 +149,8 @@
     "terser-webpack-plugin": "^5.1.3",
     "ts-morph": "^23.0.0",
     "util": "^0.12.3",
-    "webpack": "^5.70.0",
+    "webpack": "^5.94.0",
     "webpack-dev-server": "^5.0.0",
-    "webpack-node-externals": "^3.0.0",
     "yaml": "^2.0.0",
     "yargs": "^16.2.0",
     "yml-loader": "^2.1.0",
@@ -160,15 +159,25 @@
   },
   "devDependencies": {
     "@backstage/backend-common": "^0.25.0",
-    "@backstage/backend-plugin-api": "1.0.1-next.1",
-    "@backstage/backend-test-utils": "1.0.1-next.2",
+    "@backstage/backend-plugin-api": "1.0.2-next.0",
+    "@backstage/backend-test-utils": "1.0.3-next.0",
+    "@backstage/catalog-client": "1.8.0-next.0",
     "@backstage/config": "1.2.0",
-    "@backstage/core-app-api": "1.15.1-next.1",
-    "@backstage/core-components": "0.15.1-next.2",
-    "@backstage/core-plugin-api": "1.10.0-next.1",
-    "@backstage/dev-utils": "1.1.2-next.2",
-    "@backstage/test-utils": "1.6.1-next.2",
-    "@backstage/theme": "0.6.0-next.1",
+    "@backstage/core-app-api": "1.15.1",
+    "@backstage/core-components": "0.16.0-next.0",
+    "@backstage/core-plugin-api": "1.10.0",
+    "@backstage/dev-utils": "1.1.3-next.0",
+    "@backstage/errors": "1.2.4",
+    "@backstage/plugin-auth-backend": "0.24.0-next.0",
+    "@backstage/plugin-auth-backend-module-guest-provider": "0.2.2-next.0",
+    "@backstage/plugin-catalog-node": "1.14.0-next.0",
+    "@backstage/plugin-scaffolder-node": "0.5.1-next.0",
+    "@backstage/plugin-scaffolder-node-test-utils": "0.1.15-next.0",
+    "@backstage/test-utils": "1.7.0",
+    "@backstage/theme": "0.6.0",
+    "@rspack/core": "^1.0.10",
+    "@rspack/dev-server": "^1.0.9",
+    "@rspack/plugin-react-refresh": "^1.0.0",
     "@types/cross-spawn": "^6.0.2",
     "@types/ejs": "^3.1.3",
     "@types/express": "^4.17.6",
@@ -183,6 +192,7 @@
     "@types/svgo": "^2.6.2",
     "@types/tar": "^6.1.1",
     "@types/terser-webpack-plugin": "^5.0.4",
+    "@types/webpack-sources": "^3.2.3",
     "@types/yarnpkg__lockfile": "^1.1.4",
     "@vitejs/plugin-react": "^4.3.1",
     "del": "^7.0.0",
@@ -193,12 +203,28 @@
     "vite-plugin-node-polyfills": "^0.22.0"
   },
   "peerDependencies": {
-    "@vitejs/plugin-react": "^4.3.1",
-    "vite": "^5.0.0",
-    "vite-plugin-html": "^3.2.2",
+    "@modyfi/vite-plugin-yaml": "^1.1.0",
+    "@rspack/core": "^1.0.10",
+    "@rspack/dev-server": "^1.0.9",
+    "@rspack/plugin-react-refresh": "^1.0.0",
+    "@vitejs/plugin-react": "^4.0.4",
+    "vite": "^4.4.9",
+    "vite-plugin-html": "^3.2.0",
     "vite-plugin-node-polyfills": "^0.22.0"
   },
   "peerDependenciesMeta": {
+    "@modyfi/vite-plugin-yaml": {
+      "optional": true
+    },
+    "@rspack/core": {
+      "optional": true
+    },
+    "@rspack/dev-server": {
+      "optional": true
+    },
+    "@rspack/plugin-react-refresh": {
+      "optional": true
+    },
     "@vitejs/plugin-react": {
       "optional": true
     },

package/templates/default-backend-plugin/README.md.hbs

@@ -1,14 +1,28 @@
 # {{id}}
 
-Welcome to the {{id}} backend plugin!
+This plugin backend was templated using the Backstage CLI. You should replace this text with a description of your plugin backend.
 
-_This plugin was created through the Backstage CLI_
+## Installation
 
-## Getting started
+This plugin is installed via the `{{name}}` package. To install it to your backend package, run the following command:
 
-Your plugin has been added to the example app in this repository, meaning you'll be able to access it by running `yarn
-start` in the root directory, and then navigating to [/{{id}}/health](http://localhost:7007/api/{{id}}/health).
+```bash
+# From your root directory
+yarn --cwd packages/backend add {{name}}
+```
 
-You can also serve the plugin in isolation by running `yarn start` in the plugin directory.
-This method of serving the plugin provides quicker iteration speed and a faster startup and hot reloads.
-It is only meant for local development, and the setup for it can be found inside the [/dev](./dev) directory.
+Then add the plugin to your backend in `packages/backend/src/index.ts`:
+
+```ts
+const backend = createBackend();
+// ...
+backend.add(import('{{name}}'));
+```
+
+## Development
+
+This plugin backend can be started in a standalone mode from directly in this
+package with `yarn start`. It is a limited setup that is most convenient when
+developing the plugin backend itself.
+
+If you want to run the entire project, including the frontend, run `yarn dev` from the root directory.

package/templates/default-backend-plugin/dev/index.ts.hbs

@@ -0,0 +1,60 @@
+import { createBackend } from '@backstage/backend-defaults';
+import { mockServices } from '@backstage/backend-test-utils';
+import { catalogServiceMock } from '@backstage/plugin-catalog-node/testUtils';
+
+// TEMPLATE NOTE:
+// This is the development setup for your plugin that wires up a
+// minimal backend that can use both real and mocked plugins and services.
+//
+// Start up the backend by running `yarn start` in the package directory.
+// Once it's up and running, try out the following requests:
+//
+// Create a new todo item, standalone or for the sample component:
+//
+//   curl http://localhost:7007/api/{{id}}/todos -H 'Content-Type: application/json' -d '{"title": "My Todo"}'
+//   curl http://localhost:7007/api/{{id}}/todos -H 'Content-Type: application/json' -d '{"title": "My Todo", "entityRef": "component:default/sample"}'
+//
+// List TODOs:
+//
+//   curl http://localhost:7007/api/{{id}}/todos
+//
+// Explicitly make an unauthenticated request, or with service auth:
+//
+//   curl http://localhost:7007/api/{{id}}/todos -H 'Authorization: Bearer mock-none-token'
+//   curl http://localhost:7007/api/{{id}}/todos -H 'Authorization: Bearer mock-service-token'
+
+const backend = createBackend();
+
+// TEMPLATE NOTE:
+// Mocking the auth and httpAuth service allows you to call your plugin API without
+// having to authenticate.
+//
+// If you want to use real auth, you can install the following instead:
+//   backend.add(import('@backstage/plugin-auth-backend'));
+//   backend.add(import('@backstage/plugin-auth-backend-module-guest-provider'));
+backend.add(mockServices.auth.factory());
+backend.add(mockServices.httpAuth.factory());
+
+// TEMPLATE NOTE:
+// Rather than using a real catalog you can use a mock with a fixed set of entities.
+backend.add(
+  catalogServiceMock.factory({
+    entities: [
+      {
+        apiVersion: 'backstage.io/v1alpha1',
+        kind: 'Component',
+        metadata: {
+          name: 'sample',
+          title: 'Sample Component',
+        },
+        spec: {
+          type: 'service',
+        },
+      },
+    ],
+  }),
+);
+
+backend.add(import('../src'));
+
+backend.start();