Add README and comment to clarify example status of backend

packages/backend/README.md

@@ -0,0 +1,20 @@
+# example-backend
+
+This package is an EXAMPLE of a Backstage backend.
+
+The main purpose of this package is to provide a test bed for Backstage plugins
+that have a backend part. Feel free to experiment locally or within your fork
+by adding dependencies and routes to this backend, to try things out.
+
+Our goal is to eventually amend the create-app flow of the CLI, such that a
+production ready version of a backend skeleton is made alongside the frontend
+app. Until then, feel free to experiment here!
+
+## Development
+
+To run the backend in watch mode, use `yarn start`.
+
+## Documentation
+
+- [Backstage Readme](https://github.com/spotify/backstage/blob/master/README.md)
+- [Backstage Documentation](https://github.com/spotify/backstage/blob/master/docs/README.md)

packages/backend/src/index.ts

@@ -14,12 +14,20 @@
  * limitations under the License.
  */
 
+/*
+ * Hi!
+ *
+ * Note that this is an EXAMPLE Backstage backend. Please check the README.
+ *
+ * Happy hacking!
+ */
+
 import express from 'express';
 import cors from 'cors';
 import helmet from 'helmet';
 import { testRouter } from './test';
 
-const PORT = 7000;
+const PORT = parseInt(process.env.PORT ?? '', 10) || 7000;
 const app = express();
 
 app.use(helmet());