subspace/examples/react/README.md

47 lines
1.5 KiB
Markdown
Raw Normal View History

subspace - react example
2019-09-04 19:05:45 +00:00
===
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
2020-03-08 13:29:41 +00:00
In the root folder, install, build and link the packages with `yarn` or `npm`
```
2019-10-21 12:55:20 +00:00
yarn
2020-03-08 13:29:41 +00:00
yarn bootstrap
yarn link --cwd packages/core
yarn link --cwd packages/react
2019-09-04 19:05:45 +00:00
```
2020-03-08 13:29:41 +00:00
Then in the current folder link `@embarklabs/subspace` and `@embarklabs/subspace-react`, and install the packages
2019-09-04 19:05:45 +00:00
```
yarn link "@embarklabs/subspace"
2020-03-08 13:29:41 +00:00
yarn link "@embarklabs/subspace-react"
yarn
2019-09-04 19:05:45 +00:00
```
## Usage
In a terminal execute
```
ganache-cli
```
In a different session, execute
```
yarn run start
2019-09-04 19:05:45 +00:00
```
Browse the DApp in [http://localhost:3000](http://localhost:3000)
2019-10-21 12:55:20 +00:00
*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.