HyperReload is a lightweight tool for rapid development of mobile apps in JavaScript.

Edit your HTML/CSS/JS on your desktop machine, save the edited file, and the changes are automatically reloaded on connected clients. This saves you from rebuild, deploy and restart your mobile application every time a code change is made. The result is a much faster workflow when coding HTML/CSS/JS.

Any number of clients can connect. You can connect from any browser (desktop or mobile), or you can connect from a mobile WebView widget of a native app (this should work on all mobile platforms that supports a Web widget, Android, iOS, Windows Phone, Firefox OS, Tizen, etc).

The easiest way to get started is to download the HyperReload, product package (available for Linux, OS X, and Windows). The download includes documentation and tutorials, and the full source code (which you can modify as needed).

HyperReload uses node-webkit as its runtime (an amazing piece of software).

There is no need to do an actual build, you can clone the source, then run using node-webkit. Just place the node-webkit executable files in the same folder as package.json and launch node-webkit.

There is a script that can build stand-alone redistributable packages:

 hyper/build/buildHyper.rb

In addition, there is a script 'buildPlugin.rb' that you should copy and modify to customise the build (e.g. defining the name of the package to build).

buildPlugin.rb may include localConfig.rb, if it exists. Use it for non-version-controlled settings.

This script requires that a directory named 'node-webkit-bin-0.8.0' exists parallel to the HyperReload source dir. This directory contains the uncompressed node-webkit binaries. Note that depending on the version of node-webkit used, you must update the directory names and executabe names in the build script.

If you want to use a different version of node-webkit, replace "0.8.0" in this example with the number of your chosen version. You must also change the function "nodeWebKitVersion" in buildPlugin.rb, or override it in localConfig.rb.

Folder structure:

HyperReload
node-webkit-bin-0.8.0
    node-webkit-v0.8.0-linux-ia32
        creadits.html
        libffmpegsumo.so
        nw
        nw.pak
        nwsnapshot
    node-webkit-v0.8.0-linux-x64
        ...
    node-webkit-v0.8.0-osx-ia32
        ...
    node-webkit-v0.8.0-win-ia32
        ...

Documentation and downloads for HyperReload are on hyperreload.com.

Developer documentation and design documents are on the [HyperReload GitHub wiki] (https://github.com/divineprog/HyperReload/wiki/_pages).

Use the Github issue tracker to report bugs, ask questions, and make suggestions (there are labels for different issue types you can use).

Download HyperReload, unzip the download file and launch the application.

When you run HyperReload on your desktop machine, it will start a local web server and listen for file updates, notifying connected clients to reload when files are saved.

Connect from a web browser on a mobile device or laptop/desktop machine by entering the URL displayed in the HyperReload window. For example:

http://192.168.0.101:4042

You can also connect from a WebView widget in a mobile app. For example, on Android you use code like this:

WebView mWebView = new WebView(this);
mWebView.getSettings().setJavaScriptEnabled(true);
setWebViewClient(new WebViewClient());
mWebView.loadUrl("http://192.168.0.101:4042");

Make sure the WebView has JavaScript enabled, and that it has a WebViewClient (otherwise, URLs opened from within the WebView will be opened in en external browser, rather than in the WebView itself).

When connected, click the Run button of the project you wish to launch, and the app will be loaded onto the connected device(s).

When editing and saving files in the project, the app will be automatically reloaded on the connected client(s). (Note that directory traversal is limited to three levels, this can be configured in the file settings.js, if you need deeper traversal.)

To create a new project entry, drag the main HTML file of our project into the HyperReload window. (This step assumes you have created a folder with an HTML file that has some basic content.)

For HyperReload to work, you need to have a main HTML file. This is the file you want to be reloaded when a file in the project is updated. (Saving any file in the same directory or subdirectory will reload this file.)

For the reload mechanism to work, the server inserts a script tag in the main HTML file that installs the reloader script. This script will be inserted after the ending title tag, before the ending head tag, after the opening body tag, and before the ending body tag, in that order (first found tag will be used).

For example, for this file, the script tag would be inserted after the ending title tag:

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>Hello World</title><!-- script tag will be inserted here -->
</head>
<body>
    <h1>Hello World</h1>
</body>
</html>

HyperReload is under development, with ongoing changes/updates.

New releases are made continously. Downloads are available at hyperreload.com.

HyperReload is based on several truly wonderful open-source projects, including:

• node-webkit
• Node.js
• CodeMirror
• jQuery
• Apache Cordova

For a full listing of software used by HyperReload, see folder "license".

HyperReload is Copyright (c) 2013 Mikael Kindborg

The source code in the HyperReload repository is licensed under the Apache license. You are welcome to contribute to the project and use the source code with your own projects.

See file LICENSE.md and folder "hyper/license" for full licensing information, including licenses for software used by HyperReload.

The HyperReload software product contains tutorials and other material that are not open source, and the downloadable package (which includes the full source code) is released under a proprietary license. You are free to use HyperReload at work and at home, and modify it for your own needs and share with friends, but you may not sell, publish, or distribute the HyperReload software product.

Commercial licenses for HyperReload and support and development services are available upon request.

Email: [email protected]