Skip to content

A UI for the Ripple payment network built using web technologies

License

Notifications You must be signed in to change notification settings

bigwhitechen/ripple-client

 
 

Repository files navigation

Ripple Trade client

Overview

The Ripple Trade client is an open-source GUI for the Ripple network that facilitates the peer-to-peer exchange of any store of value. It’s the only platform where you can trade between stores of value spanning fiat, cryptocurrencies, commodities, and unusual assets like pre-1965 silver dimes.

Ripple Labs is the core team behind the project. For more information on the Ripple protocol, please visit our wiki.

We would love to have folks contribute! Check out our bounties here.

Ripple Trade is available at www.rippletrade.com, or you can download the desktop version at download.ripple.com.

Questions? Contact us as [email protected].

Getting Started

Install Dependencies

Install Node.js, Grunt, Git and Python 2 if you haven't already.

Install bower by running bower install --allow-root.

Fork and clone the ripple-client repository and run npm install.

Create a new config.js file and copy/paste from config-example.js into the same directory, located under 'src/js'.

Likewise, create a new config.json file by copying config-example.json in the same directory, located under the repo root directory.

Build

Run 'grunt' in your command line to build the client.

Your web client is in the 'build/bundle/web/' directory. Use 'index_debug.html' for development.

If you want to watch for changes and have the client rebuild for index_debug.html, run 'grunt watch' while you make changes.

A web server is needed to serve the built files. Please have a look at our 'Setting Up Local Environment' wiki post for more information.

After the first successful build, create a 'ripple.txt' file inside 'build/bundle/web/'. You can copy the contents for the file from here.

Directory Layout

build/         -->    compiled files
deps/          -->    client dependencies
docs/          -->    documentation
src/           -->    source code
src/js/client  -->    client classes
src/js/entry   -->    entry points for the various client versions
src/js/util    -->    various static, stateless utility functions
tools/         -->    tools used in the build process

Testing

Stay tuned...

APIs and Libraries used by Ripple Trade client

Reporting Bugs

Have a bug or a feature request? Please create a new issue. Before opening any issue, please search for existing issues and read the Issue Guidelines, written by Nicolas Gallagher.

Contributing

Ripple Labs uses Jira to track issues. We highly encourage our community to contribute but please look at our Development Policy and our CONTRIBUTING.md file before submitting a pull request.

We are also using Bountysource allowing our community to request bids from developers to solve open-source issues!

Community

Keep track of development and community news.

More Information

https://ripple.com/wiki/Ripple_Client

License

https://github.com/ripple/ripple-client/blob/develop/LICENSE

About

A UI for the Ripple payment network built using web technologies

Resources

License

Stars

Watchers

Forks

Packages

No packages published