Bw/alpha master

README.rst

@@ -158,6 +158,16 @@ You may create a `.env.private` with any overrides of the environment settings c
 
 **Note: .env.private should be added to your project's .gitignore so it does not get checked in.**
 
+Serving a production Webpack build locally
+------------------------------------------
+
+In some scenarios, you may want to run a production Webpack build locally. To serve a production build locally:
+
+#. Create an ``env.config.js`` file containing the configuration for local development, with the exception of ``NODE_ENV='production'``.
+#. Run ``npm run build`` to build the production assets. The output assets will rely on the local development configuration specified in the prior step.
+#. Add an NPM script ``serve`` to your application's ``package.json`` (i.e., ``"serve": "fedx-scripts serve"``).
+#. Run ``npm run serve`` to serve your production build assets. It will attempt to run the build on the same port specified in the ``env.config.js`` file.
+
 Local module configuration for TypeScript
 -----------------------------------------
 

config/jest.config.js

@@ -1,6 +1,6 @@
 const path = require('path');
 const fs = require('fs');
-const { defaults: tsjPreset } = require('ts-jest/presets');
+const { jsWithTs: tsjPreset } = require('ts-jest/presets');
 
 const presets = require('../lib/presets');
 

lib/scripts/serve.js

@@ -40,15 +40,13 @@ if (isDirectoryEmpty(buildPath)) {
   console.log(chalk.bold.red(`ERROR: No build found. Please run ${formattedBuildCmd} first.`));
 } else {
   let configuredPort;
+  let envConfig;
 
   try {
-    configuredPort = require(path.join(process.cwd(), 'env.config.js'))?.PORT;
+    envConfig = require(path.join(process.cwd(), 'env.config.js'));
+    configuredPort = envConfig?.PORT || process.env.PORT;
   } catch (error) {
-    // Pass. Consuming applications may not have an `env.config.js` file. This is OK.
-  }
-
-  if (!configuredPort) {
-    configuredPort = process.env.PORT;
+    // pass, consuming applications may not have an `env.config.js` file. This is OK.
   }
 
   // No `PORT` found in `env.config.js` and/or `.env.development|private`, so output a warning.