Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including create-aragon-app with all npm packages installed. Try it out:

create-aragon-app lists no main file and has no index.js, so it can't be directly required. If this is a mistake, please let us know. It may however contain internal files that you can require manually:

// require("create-aragon-app/[??]")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

create-aragon-app v2.6.3

Aragon command-line tool to create aragon apps

Create Aragon App

Will set up an Aragon app project so you can start building your app from a functional boilerplate.


create-aragon-app <app-name> [boilerplate]
  • app-name: The name or ENS domain name for your app in an aragonPM Registry (e.g. myapp or myapp.aragonpm.eth). If only the name is provided it will create your app on the default aragonpm.eth registry.

  • boilerplate: the Github repo name or alias for a boilerplate to set up your app. The currently available boilerplates are:

    • react: this boilerplate contains a very basic Counter app and a webapp for interacting with it. It showcases the end-to-end interaction with an Aragon app, from the contracts to the webapp.
    • buidler: (experimental) this boilerplates is similar to react using the buidler task runner with a custom plugin for developing Aragon apps.
    • bare: (deprecated) this boilerplate will just set up your app directory structure but contains no functional code.


npx create-aragon-app myapp
cd myapp
npm start

Once finished, this will open http://localhost:3000/ in your default browser.

Note: npx comes with npm 5.2+ and higher. If you use npm 5.1 or earlier, you can't use npx. Instead, install create-aragon-app globally.


In the root of the repository, run:

npm run pretest

And then in packages/create-aragon-app, run:

npm test

To test only one file, try:

npm test -- <path to test file>

Local environment

Some commands like aragon run depend on a local dev environment (ipfs, ganache).

We set up this up during the pretest hook & tear it down during the posttest hook.


  • Start IPFS
  • Start Ganache
  • Create a test app


  • Stop IPFS
  • Stop Ganache
  • Delete the test app

Tip: Did a test fail and the local environment was cleaned up? Try npm run test:clean.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free