Skip to content

Latest commit

 

History

History
107 lines (66 loc) · 3.64 KB

README.md

File metadata and controls

107 lines (66 loc) · 3.64 KB

Colony Starter

Get a head start on your next project! Colony Starter (formerly known as "Hackathon Starter") includes a variety of boilerplates and example projects that will help you get started with Colony.

Get Started

Prerequisites

  • Node >=10.12.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.

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 package:

colony build colony-starter

Step 3

Move to your new project directory and check out the colony-starter readme for further instructions:

cd colony-starter

Using NPX

Alternatively, you can use npx and unpack the colony-starter package without installing the colony-cli package:

npx -p @colony/colony-cli colony build colony-starter

Packages

Colony CLI

The colony-cli package is a command line tool for building colonyStarter packages and running services such as Ganache, Truffle, and Trufflepig to assist with local development alongside the colonyNetwork smart contracts.

Starter Packages

Check out some of the other starter packages by repeating steps 2 and 3 and substituting colony-starter with the package of your choice. If you have ideas for new packages or improvements, feel free to open an issue or pull request.

colony-starter

colony-starter-react

  • A boilerplate using colonyJS with React.

colony-starter-angular

  • A boilerplate using colonyJS with Angular.

Example Packages

We also have a couple example packages that you can unpack using the same build command. If you are uncertain how to do something, it might be helpful to use one of these packages as a reference.

colony-example

  • A built out version of the colony-starter package with more examples.

colony-example-react

colony-example-angular

Contribute

Are you interested in contributing? Check out the following documents for more information: