fox-send/docs/build.md

Send has two build configurations, development and production. Both can be run via `npm` scripts, `npm start` for development and `npm run build` for production. Webpack is our only build tool and all configuration lives in [webpack.config.js](../webpack.config.js).

# Development

`npm start` launches a `webpack-dev-server` on port 1337 that compiles the assets and watches files for changes. It also serves the backend API and frontend unit tests via the `server/bin/dev.js` entrypoint. The frontend tests can be run in the browser by navigating to http://localhost:8080/test and will rerun automatically as the watched files are saved with changes.

# Production

`npm run build` compiles the assets and writes the files to the `dist/` directory. `npm run prod` launches an Express server on port 1443 that serves the backend API and frontend static assets from `dist/` via the `server/bin/prod.js` entrypoint.

# Notable differences

- Development compiles assets in memory, so no `dist/` directory is generated
- Development does not enable CSP headers
- Development frontend source is instrumented for code coverage
- Only development includes sourcemaps
- Only development exposes the `/test` route
- Production sets Cache-Control immutable headers on the hashed static assets

# Custom Loaders

The `build/` directory contains custom webpack loaders specific to Send. See [build/readme.md](../build/readme.md) for details on each loader.
updated docs 2018-03-06 00:29:09 +00:00			Send has two build configurations, development and production. Both can be run via `npm` scripts, `npm start` for development and `npm run build` for production. Webpack is our only build tool and all configuration lives in [webpack.config.js](../webpack.config.js).

			`# Development`

Fix incorrect development server port in documentation 2020-10-15 14:12:23 +00:00			`npm start` launches a `webpack-dev-server` on port 1337 that compiles the assets and watches files for changes. It also serves the backend API and frontend unit tests via the `server/bin/dev.js` entrypoint. The frontend tests can be run in the browser by navigating to http://localhost:8080/test and will rerun automatically as the watched files are saved with changes.
updated docs 2018-03-06 00:29:09 +00:00
			`# Production`

created server/bin/ for server entrypoints - added server/bin/test.js for the frontend test runner 2018-06-22 20:32:24 +00:00			`npm run build` compiles the assets and writes the files to the `dist/` directory. `npm run prod` launches an Express server on port 1443 that serves the backend API and frontend static assets from `dist/` via the `server/bin/prod.js` entrypoint.
updated docs 2018-03-06 00:29:09 +00:00
			`# Notable differences`

			- Development compiles assets in memory, so no `dist/` directory is generated
			`- Development does not enable CSP headers`
			`- Development frontend source is instrumented for code coverage`
			`- Only development includes sourcemaps`
			- Only development exposes the `/test` route
			`- Production sets Cache-Control immutable headers on the hashed static assets`

			`# Custom Loaders`

Fix incorrect development server port in documentation 2020-10-15 14:12:23 +00:00			The `build/` directory contains custom webpack loaders specific to Send. See [build/readme.md](../build/readme.md) for details on each loader.