meteor-webpack-react

THis is a Meteor project skeleton where the client (in React) and server get built by Webpack. In dev mode, webpack-dev-server is used with react-hot-loader. There are a bunch of run and build scripts to make things more convenient.

There is a port of the Meteor simple-todos tutorial to this stack on the simple-todos branch.

Advantages of packaging with Webpack instead of Meteor

• require/ES6 import let you avoid Meteor global variables/load order issues
• react-hot-loader reloads React components without reloading the entire page when you make changes
• If you require your styles with Webpack, it will also reload them without reloading the entire page when you make changes to them
• Using an npm module in the browser is as simple as npm install and require
  • This puts a large part of the React ecosystem (which revolves around Webpack/npm) at your fingertips
• Other Webpack loaders are great too, for example:
  • you can break up your CSS into one file per React component, and then require them in your JSX files
  • or if you want to use Sass, you can require the Sass files
  • or you can use url-loader to require an image file and get a URL to stick in an <img> tag
• If you use Webpack for your server code too, both the server and the client can require shared code. This way you can avoid creating global variables for Meteor collections or anything else

How it works

The meteor_core directory contains dev and prod folders for development and production mode. The script to run dev mode hides prod (as .prod) and unhides dev, and vice versa for the script to run prod mode.

In prod mode, meteor_core gets the webpack client and server bundles via the soft links meteor_core/prod/client/main.js and meteor_core/server/main.js. Two instances of webpack --watch are running, one to make the client bundle and one to make the server bundle.

In dev mode, both webpack-dev-server and meteor_core run simultaneously on different ports (9090 and 3000, respectively), and a webpack --watch is also running to compile and output the server code. A script in meteor_core/dev/loadClientBundle.html inserts a <script> tag linking to the bundle from webpack-dev-server via port 9090 on the page's host. (It's a bit weird I know, but one can't have a relative URL to a different port, and just putting a script tag to http://localhost:9090/... wouldn't work if you're testing on separate device from your dev box).

If you need to use Meteor packages that depend on the react Meteor package

This is where it gets tricky, but there is an experimental solution in the react-commons branch.

react-hot-loader requires many internal React modules, thus it doesn't work with components created by an instance of React loaded from react-runtime-dev.

But if React is loaded by Webpack, then the the modules required by react-hot-loader will be the same as in that instance of React.

This poses a problem if you want to use any Meteor packages that depend on the react package, as it will load a second copy of React. The solution is to override the react-runtime package with a local fork that exports React from a Webpack Commons Chunk.

Windows note

meteor_core/.prod/client/main.js is a soft link to ../../../webpack/assets/client.bundle.js.
(Similarly for the server bundle.) I don't know if the soft link will work on Windows. If not, you can just copy the bundle in, but make sure to rename it to main.js so that Meteor loads it after everything else.

Running (dev mode)

Make sure to wait for Meteor to say it's listening, for the client webpack-dev-server and server webpack --watch to print out module/bundle info. The site won't work until all are ready.

Debugging/Profiling Server (dev mode)

> npm install -g node-inspector
> npm install
> ./debug

Then visit http://127.0.0.1:8080/debug?port=5858 in your browser.

Running (prod mode)

Make sure to wait for Meteor to say it's listening, and for the client and server webpack --watch processes to print out module/bundle info. The site won't work until all are ready.

Production build

Testing Production build

(i.e. smoke testing it)

> npm install
> ./test-built

Meteor Settings

Put your settings in settings/devel.json & settings/prod.json and they will automatically load when running in development, production and build modes.

Running Meteor Commands

As a convenince you can run ./met in the root directory to run the meteor command. However you can still cd meteor_core and then run meteor from that directory as well.

./met  --version
./met search moment