/testing-dapp

Primary LanguageTypeScript

@elrondnetwork/dapp-template

The Elrond dApp Template, built using React.js and Typescript. It's a basic implementation of @elrondnetwork/dapp-core, providing the basics for Elrond authentication and TX signing.

See Dapp template for live demo.

Requirements

  • Node.js version 12.16.2+
  • Npm version 6.14.4+

Getting Started

The dapp is a client side only project and is built using the Create React App scripts.

Instalation and running

Step 1. Install modules

From a terminal, navigate to the project folder and run:

npm install

Step 2. Update environment

Go to App.tsx and edit the environment variable according to the environment you want the app to run on. Valid values are testnet, devnet or mainnet

If you need to edit the network configuration, you can pass in a customNetworkConfig object. More info about this can be found in dapp-core documentation

Step 3. Running in development mode

In the project folder run:

npm run start

This will start the React app in development mode, using the configs found in the config.tsx file. Open http://localhost:3000 to view it in the browser.

The page will reload if you make edits.
You will also see any lint errors in the console.

Step 4. Build for testing and production use

A build of the app is necessary to deploy for testing purposes or for production use. To build the project run:

npm run build

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

One can contribute by creating pull requests, or by opening issues for discovered bugs or desired features.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Developers

The Elrond Team.