webpack-udev-server/README.md

# webpack-udev-server
A universal dev-server for [webpack].

For universal javascript applications, this server adds the ability to hot-reload the rendering code on the server-side in addition to `webpack-dev-server`'s ability to do the same for the client-side.

TODO:
 * [ ] When HMR is not usable, restart the child server,
 * [ ] If the child server crashes, restart it,
 * [ ] Better configuration options,
 * [ ] Implement rest of possible standard HTTP server events,
 * [ ] Testing.

## Usage

Some runtime changes to your code are required for using the universal dev server.

In your `server.js` file the `assets` event is fired whenever the location of and information about the client side assets change. This should be used to adjust the URL in your `<script>` tags.

```javascript
process.on('assets', ([url, stats]) => {
	// Do stuff with asset updates
});

// Listen.
server.listen(process.env['PORT']);
```

Your server webpack configuration file should include a reference to the hot runtime for the dev server and the hot signal runtime.

```javascript
{
	entry: {
		server: [
			'webpack-udev-server/hot/dev-server'
			'webpack/hot/signal',
			'./server.js'
		]
	}
}
```

All that's left is to run the dev server using both the server and client webpack configuration files.

```sh
# Specify the path to the server and client webpack config files.
webpack-udev-server --assets client.js --renderer server.js
```

You can also run the server programmatically.

```javascript
import udev from 'webpack-udev-server';

import assets from 'some-webpack-client-config.js';
import render from 'some-webpack-server-config.js';

const server = udev.createServer({
	assets: assets,
	render: render
});

server.listen(8080, () => {
	console.log('dev server ready: ', this.address().port);
});
```


[webpack]: http://www.google.com