2018-10-30 05:18:03 +01:00
|
|
|
# Uniswap Frontend
|
2019-04-15 12:07:16 -04:00
|
|
|
|
|
|
|
[![Netlify Status](https://api.netlify.com/api/v1/badges/fa110555-b3c7-4eeb-b840-88a835009c62/deploy-status)](https://app.netlify.com/sites/uniswap/deploys)
|
2020-05-26 09:54:33 -04:00
|
|
|
[![Tests](https://github.com/Uniswap/uniswap-frontend/workflows/Tests/badge.svg)](https://github.com/Uniswap/uniswap-frontend/actions?query=workflow%3ATests)
|
2019-04-15 14:05:54 -04:00
|
|
|
[![Styled With Prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://prettier.io/)
|
2020-05-26 09:54:33 -04:00
|
|
|
[![Release](https://github.com/Uniswap/uniswap-frontend/workflows/Release/badge.svg)](https://github.com/Uniswap/uniswap-frontend/actions?query=workflow%3ARelease)
|
2019-04-15 12:07:16 -04:00
|
|
|
|
2020-05-08 13:51:47 -04:00
|
|
|
An open source interface for Uniswap -- a protocol for decentralized exchange of Ethereum tokens.
|
2018-01-18 14:15:59 -05:00
|
|
|
|
2020-05-07 14:36:26 -04:00
|
|
|
- Website: [uniswap.org](https://uniswap.org/)
|
|
|
|
- Docs: [uniswap.org/docs/](https://uniswap.org/docs/)
|
|
|
|
- Twitter: [@UniswapProtocol](https://twitter.com/UniswapProtocol)
|
|
|
|
- Reddit: [/r/Uniswap](https://www.reddit.com/r/Uniswap/)
|
|
|
|
- Email: [contact@uniswap.org](mailto:contact@uniswap.org)
|
2019-12-12 11:57:43 -05:00
|
|
|
- Discord: [Uniswap](https://discord.gg/Y7TF6QA)
|
2019-04-15 14:05:54 -04:00
|
|
|
- Whitepaper: [Link](https://hackmd.io/C-DvwDSfSxuh-Gd4WKE_ig)
|
2019-12-12 11:57:43 -05:00
|
|
|
|
2020-05-21 15:54:28 -04:00
|
|
|
## Accessing the frontend
|
2020-05-13 16:36:45 -04:00
|
|
|
|
2020-05-21 15:54:28 -04:00
|
|
|
The front end is deployed to IPFS as well as to [uniswap.exchange](https://uniswap.exchange).
|
|
|
|
|
|
|
|
To access the front end via IPFS, use a link from the
|
|
|
|
[latest release](https://github.com/Uniswap/uniswap-frontend/releases/latest).
|
|
|
|
|
|
|
|
## Development
|
2018-11-02 09:30:09 +01:00
|
|
|
|
2019-04-25 12:12:47 -04:00
|
|
|
### Install Dependencies
|
2018-11-02 09:30:09 +01:00
|
|
|
|
|
|
|
```bash
|
|
|
|
yarn
|
|
|
|
```
|
|
|
|
|
2020-05-13 16:36:45 -04:00
|
|
|
### Configure Environment (optional)
|
2019-04-15 14:05:54 -04:00
|
|
|
|
2020-05-08 12:05:52 -04:00
|
|
|
Copy `.env` to `.env.local` and change the appropriate variables.
|
2018-11-02 09:30:09 +01:00
|
|
|
|
2019-04-25 12:12:47 -04:00
|
|
|
### Run
|
2019-04-15 14:05:54 -04:00
|
|
|
|
2018-11-02 09:30:09 +01:00
|
|
|
```bash
|
2019-04-25 12:12:47 -04:00
|
|
|
yarn start
|
2018-11-02 09:30:09 +01:00
|
|
|
```
|
|
|
|
|
2020-05-13 16:36:45 -04:00
|
|
|
To have the frontend default to a different network, make a copy of `.env` named `.env.local`,
|
|
|
|
change `REACT_APP_NETWORK_ID` to `"{yourNetworkId}"`, and change `REACT_APP_NETWORK_URL` to e.g.
|
|
|
|
`"https://{yourNetwork}.infura.io/v3/{yourKey}"`.
|
|
|
|
|
|
|
|
Note that the front end only works properly on testnets where both
|
|
|
|
[Uniswap V2](https://uniswap.org/docs/v2/smart-contracts/factory/) and
|
|
|
|
[eth-scan](https://github.com/MyCryptoHQ/eth-scan) are deployed.
|
2020-05-21 15:54:28 -04:00
|
|
|
The frontend will not work on other networks.
|
2019-04-25 12:12:47 -04:00
|
|
|
|
2019-04-15 14:05:54 -04:00
|
|
|
## Contributions
|
|
|
|
|
2020-05-08 12:05:52 -04:00
|
|
|
**Please open all pull requests against the `v2` branch.**
|
|
|
|
CI checks will run against all PRs.
|