HTML5 application container for Android and iOS
Shell JavaScript CoffeeScript HTML
Latest commit 76cc69b Nov 5, 2015 @pwnall Bump CrossWalk dependency.
Failed to load latest commit information.
app Bump CrossWalk dependency. Nov 5, 2015
script Updates for Cordova 5. Nov 5, 2015
.gitignore Upgrading to Cordova 5.0.0. Apr 25, 2015
LICENSE.txt Initial version. Oct 13, 2014 Dependency updates. Sep 27, 2015
package.json Updates for Cordova 5. Nov 5, 2015

HTML5 Application Container

This is a Cordova-based container for HTML5 applications, currently targeting Android and iOS.

On Android, the container uses the Crosswalk WebView for modern and consistent Chrome functionality.

Running a HTML5 application (site) in a Cordova container has the following advantages:

  • no permissions, e.g. to play audio files
  • platform abilities, e.g. wake locks


If you have Homebrew, the following command installs Imagemagick correctly.

brew install librsvg
brew install imagemagick --with-librsvg


Check out the repository, set your application name and package name in script/ and app/config.xml.

The script/setup-*.sh files (executed in the Setup step described below) install Cordova plugins that extend the native capabilities of the container. The following commands may reveal new useful plugins.

./node_modules/.bin/plugman search org.apache.cordova
./node_modules/.bin/plugman search org.chromium


Run the commands below to create the application container.


This will create keys for releasing the container application in keys. Back up the directory somewhere safe (Google Drive, Dropbox, S3). When using other computers, delete the keys directory generated by the setup script, and replace it with the saved contents.


The following commands place build products in the bin/ directory.


The app/ directory has HTML / CSS / JS and image files that are copied into the application container. When changing those, only the build step needs to be re-executed.


The following commands have proven useful in debugging the application container.

./node_modules/.bin/ios-sim launch bin/*
./node_modules/.bin/ios-deploy -b bin/*

The iOS application container can be debugged easily by Safari's Remote Inspector.

adb install -r bin/*-debug.apk

The Android application container can be debugged easily by Chrome's Remote Debugger.


This project is Copyright (c) 2014 Victor Costan, and distributed under the MIT License.