curve-frontend

Curve-frontend is a NextJs user-interface application designed to connect to Curve's deployment of smart contracts. This UI application is designed for both the Curve dapp, and utilizes curve-js and curve-llamalend-api to communicate with the blockchain.

Prerequisites

Before you begin, ensure you have met the following requirements:

• nodejs active version
• yarn version 4.x

Installation

To install curve-frontend, follow these steps:

git clone https://github.com/curvefi/curve-frontend.git
cd curve-frontend
yarn

Usage

Start development:

yarn dev

Access the application in a web browser:

• http://localhost:3000

Forked Mainnet

Testing with a forked mainnet is not generally necessary. However, if you want to do that, you can do so by copying .env.sample and updating environment variables:

cp apps/main/.env.sample apps/main/.env.development.local

Connect your wallet to the RPC URL that you used.

Folder Structure

This repository is organized as follows:

• /apps/main: This application manages router swaps, pool-specific functions (deposit, withdraw, swap), and pool creation React application.
• /tests: Cypress tests
• /packages/curve-ui-kit: Shared UI kit created using Material UI, mapped as @ui-kit
• /packages/prices-api: Package for consuming the Prices API, mapped as @curvefi/prices-api. Soon to be to separated its own NPM package.

Development Guide

For detailed information on development practices and usage of new libraries, please refer to our Development Guide.

Testing

For testing the DApp application, follow these steps:

1. Navigate to the tests directory:

cd tests

2. Follow the instructions in the README file located in the tests directory.

Troubleshooting

If you have any questions, please contact the dev channel on the Curve Discord

You may also submit an issue on our GitHub Issue Tracker.

Contributing

To contribute to curve-frontend, follow these steps:

1. Fork this repository.
2. Create a branch: git checkout -b <branch_name>.
3. Make your changes and commit them: git commit -m '<commit_message>'
4. Push to the original branch: git push origin <project_name>/<location>
5. Create the pull request.

Alternatively see the GitHub documentation on creating a pull request.

License

This project is licensed under the MIT license.