Skip to content
The Web Simulator is a lightweight tool for developing mobile web applications. Extending the Google Chrome developer tools, it enables running and debugging web APIs for a variety of mobile platforms.
Find file
New pull request
Pull request Compare This branch is 4 commits ahead, 844 commits behind 01org:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


A browser based, platform agnostic mobile application development and testing tool.

All source code (excluding third party libraries) are subject to:

Copyright (c) 2011 Research In Motion Limited


All assets in this repository, unless otherwise stated through sub-directory LICENSE or NOTICE files, are subject to the Apache Software License v.2.0.

In particular, the assets under ext/assets/images are excluded from the Apache Software License v.2.0. Please see the NOTICE file for more details.

Build Requirements

  • nodejs, npm

    nodejs: v0.4.12 is preferred. Later versions are not tested.

    npm: If you are located behind a firewall, you might need to set up a proxy for npm. Just edit ~/.npmrc and add your proxy accordingly. registry = proxy =

  • OSX or linux (windows is not currently supported for development)

Getting Started


This script will pull down the needed npm packages and initialize the submodules.

Build Commands


This will build ripple to the pkg/ folder. In that folder there is a web directory and a chromium directory.

To test ripple as an extension in chrome/chromium just load the chromium folder as an unpacked extension.

jake -T

This will describe all the available commands for building and running the tests

Running Inside Other Web Browsers

Ripple is (by-design) browser agnostic, and is able to run inside any web browser (with disabled web security).

To get it running inside Chrome you should start it with these command line flags:


Code Guidelines

  • 4 spaces per editor tab
  • jake lint, no new lint errors introduced
  • all unit tests are green

Reference Material & Community

You can also find associated reference material for the Ripple tool as well as contributor forums at the following locations.

Something went wrong with that request. Please try again.