{"id":3827,"url":"https://github.com/ripple-emulator/ripple","last_synced_at":"2025-08-03T23:33:57.659Z","repository":{"id":57143626,"uuid":"51118198","full_name":"ripple-emulator/ripple","owner":"ripple-emulator","description":"A browser based, platform agnostic mobile application development and testing tool.","archived":false,"fork":false,"pushed_at":"2018-01-09T08:31:35.000Z","size":10269,"stargazers_count":46,"open_issues_count":18,"forks_count":20,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-11-11T18:52:29.436Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ripple-emulator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-02-05T01:23:55.000Z","updated_at":"2024-07-07T05:54:03.000Z","dependencies_parsed_at":"2022-09-05T22:51:55.083Z","dependency_job_id":null,"html_url":"https://github.com/ripple-emulator/ripple","commit_stats":null,"previous_names":[],"tags_count":41,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ripple-emulator%2Fripple","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ripple-emulator%2Fripple/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ripple-emulator%2Fripple/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ripple-emulator%2Fripple/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ripple-emulator","download_url":"https://codeload.github.com/ripple-emulator/ripple/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228576890,"owners_count":17939645,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-01-05T20:16:52.633Z","updated_at":"2024-12-07T07:30:44.685Z","avatar_url":"https://github.com/ripple-emulator.png","language":"JavaScript","funding_links":[],"categories":["Tools"],"sub_categories":[],"readme":"\u003c!--\n#\n# Licensed to the Apache Software Foundation (ASF) under one\n# or more contributor license agreements.  See the NOTICE file\n# distributed with this work for additional information\n# regarding copyright ownership.  The ASF licenses this file\n# to you under the Apache License, Version 2.0 (the\n# \"License\"); you may not use this file except in compliance\n# with the License.  You may obtain a copy of the License at\n#\n# http://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing,\n# software distributed under the License is distributed on an\n# \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n#  KIND, either express or implied.  See the License for the\n# specific language governing permissions and limitations\n# under the License.\n#\n--\u003e\n\n# Ripple Emulator(tm)\n\nA browser based, platform agnostic mobile application development and testing tool.\n\n## Build Requirements\n\n* Common\n  * `nodejs` (`v0.12.0` or higher)\n  * `npm` (`v2.5.1` or higher)\n  * `python` (`v2.7.3` recommended, `v3.x.x` is __not__ supported)\n    * [Windows download](http://www.python.org/download/releases/2.7.3#download)\n\n* OSX / Linux\n    * `make`\n    * A C/C++ compiler toolchain, e.g. GCC\n\n* Windows\n  * Visual Studio 2010\n    * The setup instructions can be found [here](https://github.com/brianmcd/contextify/wiki/Windows-Installation-Guide)\n  * [msysgit](http://msysgit.github.io/)\n    * Ripple uses [Bower](http://bower.io/) for js libraries managing. In order to use Bower on Windows, [msysgit](http://msysgit.github.io/) must be installed in a proper way - see Bower's [README.md](https://github.com/bower/bower#windows-users)\n\n## Getting Started\n\nIf you plan to dive into the source, be sure to check out the [HACKING](https://github.com/ripple-emulator/ripple/blob/master/HACKING.md) file.\n\nTo get started, you need to setup a few things, first- run (in the project root):\n\n    ./configure\n\nThis script will pull down the needed npm packages and initialize the submodules.\n\n## Build Commands\n\n    jake\n\nThis will build ripple to the `pkg/` folder. In that folder there are various targets that can be used.\n\n    jake -T\n\nThis will describe all the available commands for building and running the tests, etc.\n\n## Running Inside Other Web Browsers\n\nRipple is (by-design) browser agnostic, and _should_ be able to run inside any web browser.\n\nIf you want to run it inside other browsers, you will need to use the `pkg/hosted` target, paired with the CLI's `emulate` command.\n\nEx (using the NPM package):\n\n    ripple emulate --path to/my/app\n\n    # or\n\n    ripple emulate --remote http://remote-site.com\n\nThen navigating to (your app's html file):\n\n    http://localhost:PORT/index.html?enableripple=true\n\n## CLI \u0026 NPM Package\n\nThere is a command line interface that can be paired with the client (UI).\n\nIt can be used for various things, such as statically hosting an application, and running a local (cross origin) XHR proxy.\n\nTo install:\n\n    npm install -g ripple-emulator\n\nThis will install a global script called `ripple`. To see usage, run:\n\n    ripple help\n\n## Contributing\n\nIf you like the project, and want to contribute code, please issue a pull request (on [GitHub](https://github.com/ripple-emulator/ripple/pulls)) into the `master` branch.\n\n## Code Guidelines\n\n* 4 spaces per editor tab.\n* `jake lint`, no new lint errors introduced.\n* All unit tests are green.\n\n## Reference Material \u0026amp; Community\n\n* [Project Site](https://github.com/ripple-emulator)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fripple-emulator%2Fripple","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fripple-emulator%2Fripple","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fripple-emulator%2Fripple/lists"}