{"id":14384604,"url":"https://github.com/AugurProject/augur-ui","last_synced_at":"2025-08-23T17:32:55.500Z","repository":{"id":26750381,"uuid":"30208175","full_name":"AugurProject/augur-ui","owner":"AugurProject","description":"Augur UI","archived":false,"fork":false,"pushed_at":"2022-12-07T08:29:19.000Z","size":71187,"stargazers_count":399,"open_issues_count":17,"forks_count":100,"subscribers_count":77,"default_branch":"master","last_synced_at":"2024-12-18T04:00:42.398Z","etag":null,"topics":["bem","css-modules","ethereum","react","redux","ui","webpack","webpack3"],"latest_commit_sha":null,"homepage":"https://dev.augur.net","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AugurProject.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":"2015-02-02T20:56:19.000Z","updated_at":"2024-09-10T15:00:53.000Z","dependencies_parsed_at":"2023-01-14T08:45:18.535Z","dependency_job_id":null,"html_url":"https://github.com/AugurProject/augur-ui","commit_stats":null,"previous_names":[],"tags_count":132,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AugurProject%2Faugur-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AugurProject%2Faugur-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AugurProject%2Faugur-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AugurProject%2Faugur-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AugurProject","download_url":"https://codeload.github.com/AugurProject/augur-ui/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230716579,"owners_count":18269795,"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":["bem","css-modules","ethereum","react","redux","ui","webpack","webpack3"],"created_at":"2024-08-28T18:01:30.512Z","updated_at":"2024-12-21T12:30:45.620Z","avatar_url":"https://github.com/AugurProject.png","language":"JavaScript","readme":"# augur | client\n[![Build Status](https://travis-ci.com/AugurProject/augur-ui.svg?branch=master)](https://travis-ci.com/AugurProject/augur-ui)\n[![Coverage Status](https://coveralls.io/repos/github/AugurProject/augur-ui/badge.svg?branch=master)](https://coveralls.io/github/AugurProject/augur-ui?branch=master)\n[![Language Grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/AugurProject/augur-ui.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/AugurProject/augur-ui/context:javascript)\n\nAugur is a decentralized prediction market platform built on Ethereum.\nIt runs locally in your browser and communicates directly with the ethereum network, without going through intermediate servers.\n\nThere are several configurations to run it on testnet:\n\n* Easiest: **visit [dev.augur.net](http://dev.augur.net)**\n* Partial Local: [run ethereum client locally](#partial-local-)\n* Full Local: [run everything locally](#run-everything-locally-)\n* Development Environment Setups: [various configurations](https://github.com/AugurProject/augur-ui/blob/master/docs/dev-local-node.md)\n\nProduction:\n\nThere is an electron app that contains augur-node and augur UI. This app allows the user to point to testnets and mainnet. [Augur App](https://github.com/AugurProject/augur-app). It is a faster way to interact with mainnet because augur-node is local. Enjoy!\n***\n\n## Rinkeby Ethereum Account\n\nIn the following configurations we use rinkeby testnet, here is how to get an account:\n\n* You also can use Metamask to create a rinkeby account (easiest)\n  After you install Metamask web browser plugin, you can change the Network to Rinkeby and choose the `create account` menu option\n\n* Download geth and create rinkeby account\n  (download geth)[https://www.ethereum.org/cli]\n  (geth account commands)[https://github.com/ethereum/go-ethereum/wiki/Managing-your-accounts]\n  ```\n  geth --rinkeby account new\n  ```\n  After putting in your passphrase you will get your address. You can get your secret/private key and import into metamask and connect to augur UI. Location of keystore file depends on os. ie. ~/Library/Ethereum/rinkeby/keystore/\u003c'UTC--timestamp--account hash'\u003e. This file can be used to extract private key. Instructions are beyond the scope of this readme.\n\n***\n\n## Easiest:\n\n### Overview\n\nWe are hosting the UI for testnets, dev.augur.net points to rinkeby ethereum testnet node\nSimply point your web browser to  [dev.augur.net](http://dev.augur.net)\n\n***\n\n## Partial Local \u003ca name=\"eth_local\"\u003e\u003c/a\u003e\n\n### Overview\nWe'll run the UI locally and use the rinkeby augur-node. We will build and host the UI locally and use the same env.json configuration as the 'Easiest' section.\n\n### Requirements\n* [Git](https://git-scm.com/)\n* [Node](https://nodejs.org/)\n* [Docker](https://www.docker.com/)\n\n*A Note to Windows 10 Users:*\nTurn on `Developer Mode` and also enable `Windows Subsystem For Linux` so that you have access to bash.\nRun all subsequent commands within the bash command prompt.\nIt's also recommend that you use a Debian based workflow for the installation of packages (makes things much easier).\n\n* Here are the versions we used for development.\n```\n    node: 10.15.0\n    npm: 5.6.0\n    yarn: 1.7.0\n    docker: Docker version 18.06.0-ce\n```\n## Build From Source\n\n```\ngit clone https://github.com/AugurProject/augur-ui.git\ncd augur-ui\n```\n\n### npm\n```\nnpm i\nnpm run build\n```\n\n### [yarn](https://yarnpkg.com/)\n```\nyarn\nyarn build\n```\n\nThis will create a `build` folder inside of the `augur-ui` directory with all the files necessary to run the client.\nSimply copy these files to your web server of choice.\n\n\n### [Docker](https://www.docker.com/)\nAfter git cloning UI source let docker build UI and create a docker image. Then run the docker container (from just built image) that will host augur UI locally and usings rinkeby augur-node and rinkeby ethereum node\n[dockerized augur-ui client](./docs/deploy-production.md)\n\n### [Prettier](https://prettier.io/)\nWe are using prettier to maintain formatting standards.Please [install](https://prettier.io/docs/en/editors.html) the relevant editor extension for your editor.\n\n***\n\n## Run everything Locally \u003ca name=\"totally_local\"\u003e\u003c/a\u003e\nThese instructions go through running local ethereum node, augur-node and augur UI. This will create a local environment contracts loaded with canned data.\n\nFull instructions are here [dev-local-node](https://github.com/AugurProject/augur-ui/blob/master/docs/dev-local-node.md)\n\n\n\n# Additional resources:\n[JSON RPC API Documentation](https://github.com/ethereum/wiki/wiki/JSON-RPC)\n[Javascript Console](https://github.com/ethereum/go-ethereum/wiki/JavaScript-Console#web3)\n\n\n## Documentation\n\n[http://docs.augur.net](http://docs.augur.net)\n\n\n## Contributing\n\nWe use Clubhouse.io for our issue tracker. If you would like to contribute, please join us on Discord (https://discordapp.com/invite/JwEtX9P) and provide us with your email address so we can grant you access to our Clubhouse.\n\n\n## Development Tips\n\n### #1: Search the project filenames for whatever you are looking for before thinking about it too much.\n\nSince our code is structured in many small files that are named the same as the state/functionality they represent, rather than try to follow and reverse engineer code paths, just blindly search all filenames for whatever it is you are looking for. More often than not, you will find what you need.\n\nWant to know where the css for pagination is? Don't bother tracing where/how they're included, just search your files for `pag` \u003e\u003e\u003eand `pagination.less` will pop up.\n\nWant to see how the login account gets updated? Search the files for `login` \u003e\u003e\u003e and `update-login-account.js` will appear.\n\n\n## #2: Verify endpoints the UI is connected to\n\nTo verify the ethereum node and augur-node the UI is connected see the Configuration at:  `http://localhost:8080/config/env.json`\n\n\n\n\n## Sponsorships\n\n[![BrowserStack](/src/assets/images/browser-stack.png?raw=true \"BrowserStack\")](https://www.browserstack.com/)\n\nAs an open source project, we'd like to thank [BrowserStack](https://www.browserstack.com/) for providing free access to their environment testing platform!\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAugurProject%2Faugur-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAugurProject%2Faugur-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAugurProject%2Faugur-ui/lists"}