About

Apache Ripple™ is a web based mobile environment simulator designed to enable rapid development of mobile web applications for various web application frameworks, such as Apache Cordova™ and BlackBerry® WebWorks™. It can be paired with current web based mobile development workflows to decrease time spent developing and testing on real devices and/or simulators.

It is free software, licensed under the Apache License, Version 2.0.

Download

It is recommended that Ripple be installed from npm by following the steps below. You can also find release archives with corresponding OpenPGP keys, MD5 and SHA files on the Apache Ripple distribution page. Please see README.md for instructions on how to build Ripple.

Installing Ripple from npm

Ripple is distributed as a pre-built npm package that does not need to be compiled. To install, follow these steps:

  1. Download and install the latest version of Node.js (v0.12.0 or later required). If correctly installed, you should be able to invoke node and npm from your command line.
  2. Install the ripple module using npm:

    npm install -g ripple-emulator

    Note that on OS X and Linux, you may need to use sudo, as follows:

    sudo npm install -g ripple-emulator

Following installation, you should be able to run ripple on the command line, with no arguments, to display help text.

News

30 Aug 2015

Ripple 0.9.32 has now been released! For details of this release, see CHANGELOG.md.

Some highlights of this release:

To udpate your installed version of Ripple, enter the following in your command line:

npm install -g ripple-emulator

27 May 2015

We are pleased to announce the first official release of Apache Ripple, version 0.9.30!

For details of this release, see CHANGELOG.md.

Documentation

Until a Wiki is created (see Infra issue here) and content is added, documentation can be found in the project's 'doc' folder.

Also, see README.md and HACKING.md.

Contribute

Any involvement in the project is always welcome, and encouraged.

Want to report a bug?

We currently use Jira to manage issues.

Looking for the source?

Ripple uses Git. It can be browsed via the web here , and can be cloned via:

There is also a mirror of it on Apache's GitHub account.

To get started, checkout the project's README.md (for general use) and HACKING.md (for really getting into things). If this is not sufficient, you can always ask the mailing list (and/or help update those files).

Also, while the source code is hosted in GIT, there is a SVN repository which has this website in it. You can view and checkout the SVN repository at:

Looking for more information?

Check out the project's incubation status page.

Mailing List

There are two types of mailing lists with this project.

Dev Mailing List

The dev mailing list is a vital part of this project's community. If you have a contribution to propose, something to change/remove, or any sort of general discussion, this is where it happens. Anyone interested in contributing to the project is encouraged to sign up to the mailing list, and join in on any relevant discussions. If you want to read more about mailing lists, see here.

To subscribe to all messages, send an email to:

To create a new message thread, send an email to:

To subscribe to a digest of all messages, send an email to:

To unsubscribe, send an email to:

Need more help? Send an email to:

Archives can be browsed here.

Commits Mailing List

The commits mailing list is for keeping track of commit logs for the project.

To subscribe to all messages, send an email to:

To create a new message thread, send an email to:

To subscribe to a digest of all messages, send an email to:

To unsubscribe, send an email to:

Need more help? Send an email to:

Archives can be browsed here.

Disclaimer

Apache Ripple™ is an effort undergoing incubation at the Apache Software Foundation (ASF), sponsored by Apache Cordova™. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.