# koa-webpack-middleware

> webpack dev&hot middleware for koa2

Latest version **1.0.7** (published 2017-08-12) · ISC license · 0 weekly downloads

## Install

```sh
npm install koa-webpack-middleware
pnpm add koa-webpack-middleware
yarn add koa-webpack-middleware
bun add koa-webpack-middleware
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.7 |
| Published | 2017-08-12 |
| First published | 2016-04-03 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 214 |
| Author | leecade |
| Maintainers | leecade |
| Keywords | react, hot, middleware, webpack, koa, koa2, hmr |

## Links

- npm: https://www.npmjs.com/package/koa-webpack-middleware
- Repository: https://github.com/leecade/koa-webpack-middleware
- Homepage: https://github.com/leecade/koa-webpack-middleware#readme
- Issues: https://github.com/leecade/koa-webpack-middleware/issues
- npm.io page: https://npm.io/package/koa-webpack-middleware

## Dependencies (3)

- [regenerator-runtime](https://npm.io/package/regenerator-runtime.md) 0.10.5
- [webpack-dev-middleware](https://npm.io/package/webpack-dev-middleware.md) 1.12.0
- [webpack-hot-middleware](https://npm.io/package/webpack-hot-middleware.md) 2.18.2

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.0.7 (latest) — 2017-08-12
- 1.0.6 — 2017-08-12
- 1.0.5 — 2017-05-20
- 1.0.4 — 2017-05-03
- 1.0.3 — 2016-11-07
- 1.0.1 — 2016-04-04
- 1.0.0 — 2016-04-03
- 0.1.2 — 2016-04-03
- 0.1.1 — 2016-04-03
- 0.1.0 — 2016-04-03

## README

# koa-webpack-middleware

[![npm version](http://img.shields.io/npm/v/koa-webpack-middleware.svg?style=flat-square)](https://npmjs.org/package/koa-webpack-middleware "View this project on npm")
[![Circle CI](https://circleci.com/gh/leecade/koa-webpack-middleware.svg)](https://circleci.com/gh/leecade/koa-webpack-middleware)
[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](http://standardjs.com/)

[webpack-dev-middleware](https://github.com/webpack/webpack-dev-middleware) for [koa2](https://github.com/koajs/koa/tree/v2.x) with [HMR](http://webpack.github.io/docs/hot-module-replacement-with-webpack.html)(hot module replacement) supports.

## Install

```sh
$ npm i koa-webpack-middleware -D
```

## Depends

This middleware designd for koa2 ecosystem, make sure installed the right version:

```sh
npm i koa@next -S
```

## Usage

> See [example/](./example/) for an example of usage.

```js
import webpack from 'webpack'
import { devMiddleware, hotMiddleware } from 'koa-webpack-middleware'
import devConfig from './webpack.config.dev'
const compile = webpack(devConfig)
app.use(devMiddleware(compile, {
    // display no info to console (only warnings and errors)
    noInfo: false,

    // display nothing to the console
    quiet: false,

    // switch into lazy mode
    // that means no watching, but recompilation on every request
    lazy: true,

    // watch options (only lazy: false)
    watchOptions: {
        aggregateTimeout: 300,
        poll: true
    },

    // public path to bind the middleware to
    // use the same as in webpack
    publicPath: "/assets/",

    // custom headers
    headers: { "X-Custom-Header": "yes" },

    // options for formating the statistics
    stats: {
        colors: true
    }
}))
app.use(hotMiddleware(compile, {
  // log: console.log,
  // path: '/__webpack_hmr',
  // heartbeat: 10 * 1000
}))
```

## HMR configure

1. webpack `plugins` configure

    ```js
    plugins: [
        new webpack.optimize.OccurrenceOrderPlugin(),
        new webpack.HotModuleReplacementPlugin(),
        new webpack.NoErrorsPlugin()
    ]
    ```
2. webpack `entry` configure

    ```sh
    $ npm i eventsource-polyfill -D
    ```

    ```js
    entry: {
      'index': [
        // For old browsers
        'eventsource-polyfill',
        'webpack-hot-middleware/client?path=/__webpack_hmr&timeout=20000',
        'index.js']
    },
    ```

3. webpack `loader` configure 
    
    ```sh
    $ npm i babel-preset-es2015 babel-preset-stage-0 -D
    ```

    ```js
    {
      test: /\.js$/,
      loader: 'babel',
      query: {
        'presets': ['es2015', 'stage-0']
        }
      },
      include: './src'
    }
    ```

    > HMR for react project

    ```sh
    $ npm i babel-preset-react babel-preset-react-hmre -D
    ```

    ```js
    {
      test: /\.jsx?$/,
      loader: 'babel',
      query: {
        'presets': ['es2015', 'stage-0', 'react'],
        'env': {
          'development': {
            'presets': ['react-hmre']
          }
        }
      },
      include: './src'
    }
    ```

4. put the code in your entry file to enable HMR

    > React project do not need

    ```js
    if (module.hot) {
      module.hot.accept()
    }
    ```

That's all, you're all set!

---
_Source: https://npm.io/package/koa-webpack-middleware · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._