Flow Status Webpack Plugin

This webpack plugin will automatically start a Flow server (or restart if one is running) when webpack starts up, and run flow status after each webpack build. Still experimental.

If you have any idea on how to get it better, you're welcome to contribute!

Requirements

You need to have Flow installed. To do that, follow these steps.

Installation

npm install flow-status-webpack-plugin --save-dev

Usage

1var FlowStatusWebpackPlugin = require('flow-status-webpack-plugin');
2
3module.exports = {
4    ...
5    plugins: [
6        new FlowStatusWebpackPlugin()
7    ]
8}

Configuration

If you want to pass additional command-line arguments to flow start, you can pass a flowArgs option to the plugin:

1var FlowStatusWebpackPlugin = require('flow-status-webpack-plugin');
2
3module.exports = {
4    ...
5    plugins: [
6        new FlowStatusWebpackPlugin({
7            flowArgs: '--lib path/to/interfaces/directory'
8        })
9    ]
10}

If you don't want the plugin to automatically restart any running Flow server, pass restartFlow: false:

1var FlowStatusWebpackPlugin = require('flow-status-webpack-plugin');
2
3module.exports = {
4    ...
5    plugins: [
6        new FlowStatusWebpackPlugin({
7            restartFlow: false
8        })
9    ]
10}

If provided a binary path, will run Flow from this path instead of running it from any global installation.

1var FlowStatusWebpackPlugin = require('flow-status-webpack-plugin');
2
3module.exports = {
4    ...
5    plugins: [
6        new FlowStatusWebpackPlugin({
7            binaryPath: '/path/to/your/flow/installation'
8        })
9    ]
10}

If you want the plugin to fail the build if the code doesn't type check, pass failOnError = true, and include the NoErrorsPlugin:

1var FlowStatusWebpackPlugin = require('flow-status-webpack-plugin');
2
3module.exports = {
4    ...
5    plugins: [
6        new webpack.NoErrorsPlugin(),
7        new FlowStatusWebpackPlugin({
8            failOnError: true
9        })
10    ]
11}

If you want to perform an action on successful/failed Flow checks, use the onSucess/onError callbacks:

1var FlowStatusWebpackPlugin = require('flow-status-webpack-plugin');
2var notifier = require('node-notifier');
3
4module.exports = {
5    ...
6    plugins: [
7        new webpack.NoErrorsPlugin(),
8        new FlowStatusWebpackPlugin({
9            onSuccess: function(stdout) { notifier.notify({ title: 'Flow', message: 'Flow is happy!' }); },
10            onError: function(stdout) { notifier.notify({ title: 'Flow', message: 'Flow is sad!' }); }
11        })
12    ]
13}

License

This plugin is released under the MIT License.