FlexBuilder

• A module bundler, ESNext builder and development tool, using webpack, babel and nodemon

Installation

yarn add --dev flexbuilder or npm install --dev flexbuilder

Install all necessary peer dependencies. Except react and react-dom, the rest should be installed as dev dependencies.

Usage

Add a build.js file at the root

build.js

process.on('unhandledRejection', (reason, p) => { throw reason });

require('babel-polyfill');
const builder = require('flexbuilder').default;
const argv = require('yargs').argv;

builder({
	root: __dirname,
	dev: !!argv.dev,
	// options documented below
});

Add these scripts to the package.json file:

package.json

{
	"scripts": {
		"dev": "node ./build --dev",
		"build": "node ./build"
	}
}

If you have symlinked modules in your project (only during development), add node's --preserve-symlinks flag to the commands above.

package.json (for symlinked modules)

{
	"scripts": {
		"dev": "node --preserve-symlinks ./build --dev",
		"build": "node --preserve-symlinks ./build"
	}
}

Options

| Name | Required | Description | | --------------|:---------:| -----:| | root | Yes | Root of the project. Use __dirname | | dev | Yes | Should run in dev mode? It's best to use !!argv.dev | | start | Yes if target is an app and server code needs to be run in dev mode | relative path to the distribution server file | | library | Yes if target is a library | Name of the library | | sources | Yes | { server: {}, client: {} } Each key in the server or client object is used as the destination file name. Each value is a relative path to the source directory | | alias | No | { server: {}, client: {} } Aliases to be used to resolve modules on the server and/or client. It's best to use require.resolve instead of an absolute path here. | | define | No | { server: {}, client: {} } Use to define any extra compile-time variables. | | devServerPort | Yes if using webpack dev server | You must explicitly provide a port for webpack dev server |