subspace/examples/react/README.md

47 lines
1.5 KiB
Markdown

subspace - react example
===
Simple application using a react observable component to receive a stream of emitted events. This app will deploy a test contract to **Ganache**.
## Requirements
- `ganache-cli`
- `yarn` or `npm` installed.
## Install
In the root folder, install, build and link the packages with `yarn` or `npm`
```
yarn
yarn bootstrap
yarn link --cwd packages/core
yarn link --cwd packages/react
```
Then in the current folder link `@embarklabs/subspace` and `@embarklabs/subspace-react`, and install the packages
```
yarn link "@embarklabs/subspace"
yarn link "@embarklabs/subspace-react"
yarn
```
## Usage
In a terminal execute
```
ganache-cli
```
In a different session, execute
```
yarn run start
```
Browse the DApp in [http://localhost:3000](http://localhost:3000)
*Note*: this is a simple example application that does not include error handling for the web3 connection. Be sure `ganache-cli` is running in `localhost:8545` before browsing the dapp.
### node-gyp problems
node-gyp can cause problems, because it requires a C++ compiler.
If you do have problems caused by it, first follow the installation steps for your OS [here](https://github.com/nodejs/node-gyp#installation).
If you still have problems and are on Windows, try the following:
- run `npm config set msvs_version 2015` before `npm install`
- Repair Windows Build tools that the node-gyp doc made you install. If it tells you to remove a conflicting version do it. After the repair succeeded, reboot.