Skip to content

zamb3zi/loopback-webpack-example

 
 

Repository files navigation

LoopBack + webpack build example

This is a fork of the Getting started with LoopBack tutorial demonstrating how to build a LoopBack application with webpack. Specifically we handle issues relating to loopback-boot and associated dynamic module dependencies.

This follows the general outline of Simon Degraeve's loopback-webpack-plugin which appears to have been abandoned and no longer working. We also draw on ideas from webpack-node-externals.

This could be developed into a webpack plugin at some point, but as an example it's clearer to configure webpack this way.

The key features of the approach are:

  • Rather than call boot() at runtime, we perform a loopback-boot compile at build time and store the resulting boot instructions as a bundled JSON resource.
  • At runtime, we just call the loopback-boot executor to perform the boot. This avoids many problems trying to bundle the compiler and also provides much faster boot times for complex applications.
  • All of the boot-time resources are specified in a ContextReplacementPlugin by providing a single dependency map that resolves all of the resources specified in the boot instructions. This feature of ContextReplacementPlugin is currently undocumented.
  • No need for browserify!
  • We specify which node_modules dependencies will be bundled (internalized) and which will not. loopback-boot/lib/executor must be bundled so webpack can handle resolution of models, boot scripts, etc.
  • Dynamic configuration files (such as config.json and datasources.json) are excluded from the bundle (externalized) so that they can be modified without re-building.
  • gulp is used trivially to perform the build.

Installation

git clone git://github.com/zamb3zi/loopback-webpack-example
cd loopback-webpack-example
npm install
gulp
node build/main.bundle.js

More LoopBack examples