Switch to webpack-dev-server

template/build/utils.js

@@ -3,6 +3,7 @@
 const path = require('path')
 const config = require('../config')
 const ExtractTextPlugin = require('extract-text-webpack-plugin')
+const pkg = require('../package.json')
 
 exports.assetsPath = function (_path) {
  const assetsSubDirectory = process.env.NODE_ENV === 'production'
@@ -71,3 +72,22 @@ exports.styleLoaders = function (options) {
  }
  return output
 }
+
+exports.createNotifierCallback = function () {
+ const notifier = require('node-notifier')
+
+ return (severity, errors) => {
+ if (severity !== 'error') {
+ return
+ }
+ const error = errors[0]
+
+ const filename = error.file.split('!').pop()
+ notifier.notify({
+ title: pkg.name,
+ message: severity + ': ' + error.name,
+ subtitle: filename || '',
+ icon: path.join(__dirname, 'logo.png')
+ })
+ }
+}

template/build/webpack.base.conf.js

@@ -32,15 +32,16 @@ module.exports = {
  module: {
  rules: [
  {{#lint}}
- {
+ ...(config.dev.useEslint? [{
  test: /\.(js|vue)$/,
  loader: 'eslint-loader',
  enforce: 'pre',
  include: [resolve('src'), resolve('test')],
  options: {
- formatter: require('eslint-friendly-formatter')
+ formatter: require('eslint-friendly-formatter'),
+ emitWarning: !config.dev.showEslintErrorsInOverlay
  }
- },
+ }] : []),
  {{/lint}}
  {
  test: /\.vue$/,

template/build/webpack.dev.conf.js

@@ -9,24 +9,39 @@ const merge = require('webpack-merge')
 const baseWebpackConfig = require('./webpack.base.conf')
 const HtmlWebpackPlugin = require('html-webpack-plugin')
 const FriendlyErrorsPlugin = require('friendly-errors-webpack-plugin')
+const portfinder = require('portfinder')
 
-// add hot-reload related code to entry chunks
-Object.keys(baseWebpackConfig.entry).forEach(function (name) {
- baseWebpackConfig.entry[name] = ['./build/dev-client'].concat(baseWebpackConfig.entry[name])
-})
-
-module.exports = merge(baseWebpackConfig, {
+const devWebpackConfig = merge(baseWebpackConfig, {
  module: {
  rules: utils.styleLoaders({ sourceMap: config.dev.cssSourceMap })
  },
  // cheap-module-eval-source-map is faster for development
  devtool: '#cheap-module-eval-source-map',
+ // these devServer options should be customized in /config/index.js
+ devServer: {
+ clientLogLevel: 'warning',
+ hot: true,
+ host: process.env.HOST || config.dev.host,
+ port: process.env.PORT || config.dev.port,
+ open: config.dev.autoOpenBrowser,
+ overlay: config.dev.errorOverlay ? {
+ warnings: false,
+ errors: true,
+ } : false,
+ publicPath: config.dev.assetsPublicPath,
+ proxy: config.dev.proxyTable,
+ quiet: true, // necessary for FriendlyErrorsPlugin
+ watchOptions: {
+ poll: config.dev.poll,
+ },
+ historyApiFallback: true
+ },
  plugins: [
  new webpack.DefinePlugin({
- 'process.env': config.dev.env
+ 'process.env': require('../config/dev.env')
  }),
- // https://github.com/glenjamin/webpack-hot-middleware#installation--usage
  new webpack.HotModuleReplacementPlugin(),
+ new webpack.NamedModulesPlugin(), // HMR shows correct file names in console on update.
  new webpack.NoEmitOnErrorsPlugin(),
  // https://github.com/ampedandwired/html-webpack-plugin
  new HtmlWebpackPlugin({
@@ -39,3 +54,29 @@ module.exports = merge(baseWebpackConfig, {
  new FriendlyErrorsPlugin()
  ]
 })
+
+module.exports = new Promise((resolve, reject) => {
+ portfinder.basePort = process.env.PORT || config.dev.port
+ portfinder.getPort((err, port) => {
+ if (err) {
+ reject(err)
+ } else {
+ // publish the new Port, necessary for e2e tests
+ process.env.PORT = port
+ // add port to devServer config
+ devWebpackConfig.devServer.port = port
+
+ // Add FriendlyErrorsPlugin
+ devWebpackConfig.plugins.push(new FriendlyErrorsPlugin({
+ compilationSuccessInfo: {
+ messages: [`Your application is running here: http://${config.dev.host}:${port}`],
+ },
+ onErrors: config.dev.notifyOnErrors
+ ? utils.createNotifierCallback()
+ : undefined
+ }))
+
+ resolve(devWebpackConfig)
+ }
+ })
+})

template/build/webpack.prod.conf.js

@@ -16,7 +16,7 @@ const loadMinified = require('./load-minified')
 
 const env = {{#if_or unit e2e}}process.env.NODE_ENV === 'testing'
  ? require('../config/test.env')
- : {{/if_or}}config.build.env
+ : {{/if_or}}require('../config/prod.env')
 
 const webpackConfig = merge(baseWebpackConfig, {
  module: {

template/config/index.js

@@ -4,37 +4,58 @@
 const path = require('path')
 
 module.exports = {
+ dev: {
+ host: 'localhost', // can be overwritten by process.env.HOST
+ port: 8080, // can be overwritten by process.env.HOST, if port is in use, a free one will be determined
+
+ // Paths
+ assetsSubDirectory: 'static',
+ assetsPublicPath: '/',
+ proxyTable: {},
+
+ // Various Dev Server settings
+ autoOpenBrowser: false,
+ errorOverlay: true,
+ notifyOnErrors: true,
+ poll: false, // https://webpack.js.org/configuration/dev-server/#devserver-watchoptions-
+
+ // Use Eslint Loader?
+ // If true, your code will be linted during bundling and
+ // linting errors and warings will be shown in the console.
+ useEslint: true,
+ // If true, eslint errors and warings will also be shown in the error overlay
+ // in the browser.
+ showEslintErrorsInOverlay: false,
+
+ // CSS Sourcemaps off by default because relative paths are "buggy"
+ // with this option, according to the CSS-Loader README
+ // (https://github.com/webpack/css-loader#sourcemaps)
+ // In our experience, they generally work as expected,
+ // just be aware of this issue when enabling this option.
+ cssSourceMap: false
+ },
  build: {
- env: require('./prod.env'),
+ // Template for index.html
  index: path.resolve(__dirname, '../dist/index.html'),
+
+ // Paths
  assetsRoot: path.resolve(__dirname, '../dist'),
  assetsSubDirectory: 'static',
  assetsPublicPath: '/',
+
  productionSourceMap: true,
  // Gzip off by default as many popular static hosts such as
  // Surge or Netlify already gzip all static assets for you.
  // Before setting to `true`, make sure to:
  // npm install --save-dev compression-webpack-plugin
+
  productionGzip: false,
  productionGzipExtensions: ['js', 'css'],
  // Run the build command with an extra argument to
  // View the bundle analyzer report after build finishes:
  // `npm run build --report`
  // Set to `true` or `false` to always turn it on or off
+
  bundleAnalyzerReport: process.env.npm_config_report
- },
- dev: {
- env: require('./dev.env'),
- port: 8080,
- autoOpenBrowser: true,
- assetsSubDirectory: 'static',
- assetsPublicPath: '/',
- proxyTable: {},
- // CSS Sourcemaps off by default because relative paths are "buggy"
- // with this option, according to the CSS-Loader README
- // (https://github.com/webpack/css-loader#sourcemaps)
- // In our experience, they generally work as expected,
- // just be aware of this issue when enabling this option.
- cssSourceMap: false
  }
 }

template/package.json

@@ -5,8 +5,8 @@
  "author": "{{ author }}",
  "private": true,
  "scripts": {
- "dev": "node build/dev-server.js",
- "start": "node build/dev-server.js",
+ "dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js",
+ "start": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js",
  "build": "node build/build.js"{{#unit}},
  "unit": "cross-env BABEL_ENV=test karma start test/unit/karma.conf.js --single-run"{{/unit}}{{#e2e}},
  "e2e": "node test/e2e/runner.js"{{/e2e}}{{#if_or unit e2e}},
@@ -30,7 +30,6 @@
  "babel-preset-stage-2": "^6.24.1",
  "babel-register": "^6.26.0",
  "chalk": "^2.1.0",
- "connect-history-api-fallback": "^1.4.0",
  "copy-webpack-plugin": "^4.1.1",
  "css-loader": "^0.28.7",
  "cssnano": "^3.10.0",
@@ -52,12 +51,10 @@
  {{/if_eq}}
  {{/lint}}
  "eventsource-polyfill": "^0.9.6",
- "express": "^4.16.2",
  "extract-text-webpack-plugin": "^3.0.0",
  "file-loader": "^1.1.5",
  "friendly-errors-webpack-plugin": "^1.6.1",
  "html-webpack-plugin": "^2.30.1",
- "http-proxy-middleware": "^0.17.4",
  "webpack-bundle-analyzer": "^2.9.0",
  {{#unit}}
  "cross-env": "^5.0.5",
@@ -78,6 +75,7 @@
  "babel-plugin-istanbul": "^4.1.5",
  "phantomjs-prebuilt": "^2.1.15",
  {{/unit}}
+ "node-notifier": "^5.1.2",
  {{#e2e}}
  "chromedriver": "^2.33.1",
  "cross-spawn": "^5.1.0",
@@ -86,7 +84,6 @@
  {{/e2e}}
  "semver": "^5.4.1",
  "shelljs": "^0.7.8",
- "opn": "^5.1.0",
  "optimize-css-assets-webpack-plugin": "^3.2.0",
  "ora": "^1.3.0",
  "rimraf": "^2.6.2",
@@ -95,8 +92,7 @@
  "vue-style-loader": "^3.0.3",
  "vue-template-compiler": "^2.5.2",
  "webpack": "^3.7.1",
- "webpack-dev-middleware": "^1.12.0",
- "webpack-hot-middleware": "^2.19.1",
+ "webpack-dev-server": "^2.9.1",
  "webpack-merge": "^4.1.0",
  "uglify-es": "^3.1.3"
  },