chore: align plugin scripts with backstage-cli conventions

.github/workflows/ci.yml

@@ -26,16 +26,18 @@ jobs:
       - name: Type-check
         run: npx tsc --project tsconfig.json
 
-      - name: Build frontend
-        run: yarn workspace @rwdocs/backstage-plugin-rw run build
-
-      - name: Build backend
-        run: yarn workspace @rwdocs/backstage-plugin-rw-backend run build
-
       - name: Lint
         run: |
           yarn workspace @rwdocs/backstage-plugin-rw run lint
           yarn workspace @rwdocs/backstage-plugin-rw-backend run lint
 
       - name: Format check
-        run: npx prettier --check "plugins/*/src/**"
+        run: |
+          yarn workspace @rwdocs/backstage-plugin-rw run format:check
+          yarn workspace @rwdocs/backstage-plugin-rw-backend run format:check
+
+      - name: Build frontend
+        run: yarn workspace @rwdocs/backstage-plugin-rw run build
+
+      - name: Build backend
+        run: yarn workspace @rwdocs/backstage-plugin-rw-backend run build

CLAUDE.md

@@ -12,13 +12,16 @@ Backstage plugin pair for embedding RW documentation sites. Yarn 4.12.0 workspac
 ## Commands
 
 ```bash
-# Full build + lint + format
+# Full build + typecheck + lint + format
 make all
 
-# Build all plugins (install deps, type-check, backstage-cli build)
+# Build all plugins (install deps, backstage-cli build)
 make build
 
-# Lint (TypeScript strict mode via tsc --noEmit)
+# Type-check (tsc --noEmit across all plugins)
+make typecheck
+
+# Lint (ESLint via backstage-cli package lint)
 make lint
 
 # Format (Prettier, printWidth: 100)
@@ -33,7 +36,7 @@ yarn workspace @rwdocs/backstage-plugin-rw run lint
 yarn workspace @rwdocs/backstage-plugin-rw-backend run lint
 ```
 
-No test framework is configured.
+Tests use `backstage-cli package test` (Jest). No tests have been written yet.
 
 ## Architecture
 

Makefile

@@ -1,19 +1,27 @@
-all: build lint format
+all: typecheck lint format build
 
-build:
+install:
 	yarn install
-	npx tsc --project tsconfig.json
+
+build: install
 	yarn workspace @rwdocs/backstage-plugin-rw run build
 	yarn workspace @rwdocs/backstage-plugin-rw-backend run build
 
-lint:
+typecheck: install
+	npx tsc --project tsconfig.json
+
+lint: install
 	yarn workspace @rwdocs/backstage-plugin-rw run lint
 	yarn workspace @rwdocs/backstage-plugin-rw-backend run lint
 
-format:
+format: install
 	yarn workspace @rwdocs/backstage-plugin-rw run format
 	yarn workspace @rwdocs/backstage-plugin-rw-backend run format
 
+format\:check: install
+	yarn workspace @rwdocs/backstage-plugin-rw run format:check
+	yarn workspace @rwdocs/backstage-plugin-rw-backend run format:check
+
 clean:
 	yarn workspace @rwdocs/backstage-plugin-rw run clean
 	yarn workspace @rwdocs/backstage-plugin-rw-backend run clean

plugins/rw-backend/.eslintrc.js

@@ -0,0 +1 @@
+module.exports = require('@backstage/cli/config/eslint-factory')(__dirname);

plugins/rw-backend/package.json

@@ -8,7 +8,9 @@
     "./package.json": "./package.json"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "main": "dist/index.cjs.js",
+    "types": "dist/index.d.ts"
   },
   "backstage": {
     "role": "backend-plugin",
@@ -24,10 +26,13 @@
     "config.d.ts"
   ],
   "scripts": {
+    "start": "backstage-cli package start",
     "build": "backstage-cli package build",
+    "lint": "backstage-cli package lint",
+    "test": "backstage-cli package test",
     "clean": "backstage-cli package clean",
-    "lint": "tsc --noEmit",
     "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
     "prepack": "backstage-cli package prepack",
     "postpack": "backstage-cli package postpack"
   },
@@ -44,6 +49,7 @@
     "@backstage/cli": "^0.35.0",
     "@types/express": "^4.17.0",
     "@types/jest": "^30.0.0",
+    "jest": "^30.0.0",
     "prettier": "^3.4.2",
     "typescript": "^5.7.0"
   }

plugins/rw/.eslintrc.js

@@ -0,0 +1 @@
+module.exports = require('@backstage/cli/config/eslint-factory')(__dirname);

plugins/rw/package.json

@@ -8,7 +8,10 @@
     "./package.json": "./package.json"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "main": "dist/index.cjs.js",
+    "module": "dist/index.esm.js",
+    "types": "dist/index.d.ts"
   },
   "backstage": {
     "role": "frontend-plugin",
@@ -22,10 +25,13 @@
     "dist"
   ],
   "scripts": {
+    "start": "backstage-cli package start",
     "build": "backstage-cli package build",
+    "lint": "backstage-cli package lint",
+    "test": "backstage-cli package test",
     "clean": "backstage-cli package clean",
-    "lint": "tsc --noEmit",
     "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
     "prepack": "backstage-cli package prepack",
     "postpack": "backstage-cli package postpack"
   },
@@ -49,6 +55,7 @@
     "@backstage/plugin-catalog-react": "^2.0.0",
     "@types/jest": "^30.0.0",
     "@types/react": "^18.0.0",
+    "jest": "^30.0.0",
     "prettier": "^3.4.2",
     "react": "^18.0.0",
     "react-dom": "^18.0.0",

plugins/rw/src/plugin.tsx

@@ -33,6 +33,7 @@ const rwEntityContent = EntityContentBlueprint.make({
   params: {
     path: "docs",
     title: "Documentation",
+    group: "documentation",
     loader: () => import("./components/RwDocsViewer").then((m) => <m.RwDocsViewer />),
   },
 });