colony-starter-react
A boilerplate to get started with colonyJS using React!
Prerequisites
- Node
>=10.13.0 - Yarn
>=1.12.0 - Docker
>=18.09.0
You may find it helpful to use Node Version Manager (nvm) to manage Node versions.
If you are using Linux, check out Linux Setup to ensure Yarn and Docker are set up accordingly.
Installation
Step 1
Globally install the colony-cli package:
yarn global add @colony/colony-cli
Step 2
Move to your working directory and unpack the colony-starter-react package:
colony build colony-starter-react
Step 3
Move to your new project directory and follow the instructions below:
cd colony-starter-react
Using NPX
Alternatively, you can use npx and unpack the colony-starter-react package without installing the colony-cli package.
npx -p @colony/colony-cli colony build colony-starter-react
Development
Start Network
Open a new terminal window and start Ganache:
yarn start-ganache
Deploy Contracts
Open a new terminal window and deploy the colonyNetwork contracts:
yarn deploy-contracts
Start TrufflePig
Once the contracts have been deployed, start TrufflePig:
yarn start-trufflepig
Seed Network
Open a new terminal window and run the seed network script:
yarn seed-network
Colony Setup
Once the network has been seeded, run the colony setup script:
yarn colony-setup
Start Server
Once your test colony has been set up, start the development server:
yarn start
Open Browser
Open your browser and start building:
Run Tests
Open a new terminal window and run the example tests:
yarn test
Contract Versions
If you do not want to use the default version of the colonyNetwork smart contracts defined by the colony-cli package, you can update the "deploy-contracts" scripts property in your package.json file to use a specific version. This can be a branch name, a commit hash, or a version tag.
"deploy-contracts": "colony service deploy-contracts --specific glider",