jspm-hmr

JSPM (SystemJS) Hot-Module-Reload

Hot-Module-Reload - made for dummies!

Node.js package, written in TypeScript with async/await to fabuously deal with Node.js callback hell.
Designed to hot-reload ReactJS Components during development.
Using SystemJS for Universal (ES6) Module Loading Support.
Provide initialize procedure which create basic project files (index.html, src/app.js, server.js) with complete Hot-Module-Reload setup and HTTP dev server ready to start with simple "npm start" command.

Quick Start for Dummies :)

$ npm install jspm-hmr --save-dev
$ ./node_modules/.bin/jspm-hmr --init
$ npm start

Now make some changes in "src/app.js" file and save to see hot-module-reload in action!
Always try to use ES6 Modules (import/export) for future-proof code: http://exploringjs.com/es6/ch_modules.html

---

Install

$ npm install jspm-hmr [--save-dev]

Tip: You can install it globally using -g flag so you can use it as simple http server in any directory on your machine

Pro-Tip: You can use --init flag to initialize your project with index.html, app.js, server.js files - configured with hot-module-reload for JSPM & SystemJS

---

Usage

$ jspm-hmr [path] [options]

Options:

-h, --help              output usage information
-V, --version           output the version number
-I, --init              initialize files configured with hot-module-reload (index.html, app.js, server.js)
-O, --open              automatically open browser (defaults to false)
-P, --port <number>     port number (defaults to 8888)
-C, --caching [number]  enable caching with max-age= (defaults to -1)

---

Examples:

• Initialize your project with hot-module-reload configuration in cwd

$ jspm-hmr -I

• Start dev server in CWD & open in last active browser window

$ jspm-hmr . -O

• Start dev server in "dist" sub-folder on port 4444 and caching set to 3600 sec

$ jspm-hmr "dist" -P 4444 -C 3600

---

How it works

Watches specified files for changes in chosen path and emits events through web sockets on changes to your client to reload that particular JavaScript modules that has changed. -I or --init flag initialize index.html and server.js in your project with automatic hot-module-reload configuration for easy setup.

Under the hood it uses great systemjs-hot-reloader with chokidar-socket-emitter.

---

Dependencies:

• http-server
• chokidar-socket-emitter
• systemjs-hot-reloader

---

License

Copyright 2016 Piotr Witek [e-mail] (http://piotrwitek.github.io)

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.