Skip to content
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
config Conditionally connect to augur node via http to satisfy google bot (#… Mar 12, 2019
docs Change references from augur repo to augur-ui repo Sep 3, 2018
scripts includes version from package.json on release build Feb 12, 2019
support Docker weight loss (#2671) Feb 13, 2019
.editorconfig updated editorconfig + linting rule for indent Jan 12, 2017
.eslintignore added genversion to dev deps, intigrated it into build, safer than im… Dec 5, 2018
.npmignore Call updateAssets immediately after register; added watchify script; … Jan 3, 2016
.prettierignore Add prettier Aug 17, 2018
.stylelintrc linting and added local to ignored pseudo classes Jan 25, 2018
Dockerfile Docker weight loss (#2671) Feb 13, 2019
browserslist Add comment to browserlist (#1493) May 6, 2018
docker-compose.yml Match entrypoint override to new entrypoint inside container Jun 22, 2018
jest-puppeteer.config.js Merge tests back (#2550) Dec 12, 2018
jest.config.js Merge tests back (#2550) Dec 12, 2018
postcss.config.js Run prettier and eslint --fix Aug 17, 2018

augur | client

Build Status Coverage Status Language Grade: JavaScript

Augur is a decentralized prediction market platform built on Ethereum. It runs locally in your browser and communicates directly with the ethereum network, without going through intermediate servers.

There are several configurations to run it on testnet:


There is an electron app that contains augur-node and augur UI. This app allows the user to point to testnets and mainnet. Augur App. It is a faster way to interact with mainnet because augur-node is local. Enjoy!

Rinkeby Ethereum Account

In the following configurations we use rinkeby testnet, here is how to get an account:

  • You also can use Metamask to create a rinkeby account (easiest) After you install Metamask web browser plugin, you can change the Network to Rinkeby and choose the create account menu option

  • Download geth and create rinkeby account (download geth)[] (geth account commands)[]

    geth --rinkeby account new

    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/<'UTC--timestamp--account hash'>. This file can be used to extract private key. Instructions are beyond the scope of this readme.



We are hosting the UI for testnets, points to rinkeby ethereum testnet node Simply point your web browser to

Partial Local


We'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.


A Note to Windows 10 Users: Turn on Developer Mode and also enable Windows Subsystem For Linux so that you have access to bash. Run all subsequent commands within the bash command prompt. It's also recommend that you use a Debian based workflow for the installation of packages (makes things much easier).

  • Here are the versions we used for development.
    node: 10.15.0
    npm: 5.6.0
    yarn: 1.7.0
    docker: Docker version 18.06.0-ce

Build From Source

git clone
cd augur-ui


npm i
npm run build


yarn build

This will create a build folder inside of the augur-ui directory with all the files necessary to run the client. Simply copy these files to your web server of choice.


After 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 dockerized augur-ui client


We are using prettier to maintain formatting standards.Please install the relevant editor extension for your editor.

Run everything Locally

These instructions go through running local ethereum node, augur-node and augur UI. This will create a local environment contracts loaded with canned data.

Full instructions are here dev-local-node

Additional resources:

JSON RPC API Documentation Javascript Console



We use for our issue tracker. If you would like to contribute, please join us on Discord ( and provide us with your email address so we can grant you access to our Clubhouse.

Development Tips

#1: Search the project filenames for whatever you are looking for before thinking about it too much.

Since 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.

Want to know where the css for pagination is? Don't bother tracing where/how they're included, just search your files for pag >>>and pagination.less will pop up.

Want to see how the login account gets updated? Search the files for login >>> and update-login-account.js will appear.

#2: Verify endpoints the UI is connected to

To verify the ethereum node and augur-node the UI is connected see the Configuration at: http://localhost:8080/config/env.json



As an open source project, we'd like to thank BrowserStack for providing free access to their environment testing platform!

You can’t perform that action at this time.