Can I get a simple, up-to-date and working example for hot-reloading?

• Node Version: v11.10.0
• NPM Version: 6.7.0
• koa Version: 2.7.0
• koa-wepback Version: 5.2.1

I think the README.md should have a clear example on how to make a simple app work with hot-reloading. I’ve been trying to make this repo work for a couple days now and I can’t get any changes inside my server’s code to refresh my page.

router.get('/', (ctx, next) => {
    ctx.body = "Doesn't change unless a force a refresh manually";
});

I’ve looked at multiple examples in this GitHub issues and they’re all old and out-dated. Now the middleware uses Async/Await and it’s really unclear where to use it (before or after initialising route). It’s also unclear what should exactly be in my webpack.config for hot-reloading and if I still have the need to do this in my index file.

if (module.hot) {
    {...}
}

This is not a request for support, it’s an actual issue that there’s so little practical documentation on how to make it work correctly, a simple example would go a long way.

[jdrydn]

If async/awaitwere not core to Koa v2, you would have a valid point

Apologies 🙏 That’s not the point I’m making. I adore Koa due to it’s core support for async/await, however this support is in the middleware functions themselves, i.e. once you enter the context scope with app.use(...). (AFAIK) Node itself doesn’t particularly support a random await in the middle of synchronous code - it has to be inside an async function.

Quoting your README directly:

const Koa = require('koa');
const koaWebpack = require('koa-webpack');

const app = new Koa();
const options = { .. };
const middleware = await koaWebpack(options);

app.use(middleware);

Should it not be:

const Koa = require('koa');
const koaWebpack = require('koa-webpack');

async bootstrap() {
  const app = new Koa();
  const options = { .. };
  const middleware = await koaWebpack(options);

  app.use(middleware);
  return app;
}

bootstrap()
  .then(app => app.listen(8080))
  .catch(err => console.error(err));

In order to support this await keyword?

… And to bring this issue full-circle, a working example file included in this repo would have cleared this up!

[corysimmons]

Why do you hate providing examples? It’s the easiest way for someone to learn/use your project.