The colony-starter-basic package is a starter project that demonstrates how to use colonyJS (a JavaScript client for colonyNetwork). This project is set up to start a local test network using Ganache and then deploy the colonyNetwork contracts to the local test network using Truffle. This project also uses TrufflePig to find and read the deployed contracts during local development.

This project includes example scripts also found in the Get Started and Task Lifecycle pages of the colonyJS Docs. In order to help you hit the ground running with your new project, this starter project includes all of the examples from the docs plus some, and it gives you the opportunity to execute and test those examples with a few simple commands.


  • Yarn
  • Docker
  • Node 9.10

You may find it helpful to use Node Version Manager (nvm) to manage node versions.


Globally install the colony-starter package.

yarn global add @colony/colony-starter

Install the colony-starter-basic package.

colony-starter colony-starter-basic

Run Examples

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

Open a new terminal window and start TrufflePig:

yarn start-trufflepig

Run Example Script

Open a new terminal window and run the example script:

yarn start

Run Example Tests

Open a new terminal window and run the example tests:

yarn test