/aragon

Aragon client to create and manage decentralized organizations on Ethereum.

Primary LanguageJavaScriptGNU Affero General Public License v3.0AGPL-3.0

Aragon

Build Status All Contributors

πŸŒŽπŸš€ Trusted by over 700 organizations, securing more than $1MM in funds. Try it out.

  • πŸ“š Read the User Guide first, if you have any questions as a user.
  • πŸ’» You may be interested in Aragon Desktop, the most decentralized Aragon experience to date.
  • πŸ— If you'd like to develop an Aragon app, please visit the Aragon Developer Portal.
  • πŸ“ Please report any issues and feedback in the Aragon Chat #feedback channel.
  • πŸ”§ For technical stuff, use this project's issues or join the technical conversation in our #dev channel.
  • πŸ“– To learn more about contributing to the Aragon client itself, please check the contributing guide
  • 🚒 For an overview of what changed with each release, check the releases and changelog.

Quick start

npm start will launch the app, configured to connect to our Rinkeby deployment.

For connecting to other chains / deployments, a few useful npm scripts are provided:

  • Mainnet: npm run start:mainnet will launch the app, configured to connect to our mainnet deployment
  • Local development: npm run start:local will launch the app, configured to connect to our aragen local development environment. It will also use the local IPFS daemon, if it detects one exists. If you're using the aragonCLI, you'll want to run this to connect to its local chain.

Note: Windows users may need to install the windows-build-tools before installing this project's dependencies.

More configuration options are available, depending on your needs.

Deployments

The Aragon client undergoes a number of different deployments, based on build environments, major release timelines, and quality assurance checks.

aragonPM

Regular updates, with incrementing minor or patch versions, are published onto the aragon.aragonpm.eth repo on all supported Ethereum environments.

These should be seen as "official" builds, whose distributions are secured by IPFS. Most users will likely see this version of the app, due to mainnet.aragon.org and rinkeby.aragon.org pointing to these builds.

Nightly / Per-PR builds

Automatic nightly.aragon.org and nightly-rinkeby.aragon.org deployments will occur for each PR and merge to master through now. These are useful for quickly testing a new feature, change, or hotfix.

The official now app for Github is set up to publish nightlies against Rinkeby see default now configuration. Travis is set up to publish nightlies against mainnet (see mainnet now configuration).

Contributing

πŸ‘‹ Get started contributing with a good first issue.

πŸŽ“ You may be interested in the Aragon client architecture guide if you're not familiar with how the project is set up.

Don't be shy to contribute even the smallest tweak. 🐲 There are still some dragons to be aware of, but we'll be here to help you get started!

For other details about contributing to Aragon, more details are available in the contributing guide.

Issues

If you come across an issue with Aragon, do a search in the Issues tab of this repo and the Aragon Apps Issues to make sure it hasn't been reported before. Follow these steps to help us prevent duplicate issues and unnecessary notifications going to the many people watching this repo:

  • If the issue you found has been reported and is still open, and the details match your issue, give a "thumbs up" to the relevant posts in the issue thread to signal that you have the same issue. No further action is required on your part.
  • If the issue you found has been reported and is still open, but the issue is missing some details, you can add a comment to the issue thread describing the additional details.
  • If the issue you found has been reported but has been closed, you can comment on the closed issue thread and ask to have the issue reopened because you are still experiencing the issue. Alternatively, you can open a new issue, reference the closed issue by number or link, and state that you are still experiencing the issue. Provide any additional details in your post so we can better understand the issue and how to fix it.

Contributors

Thanks goes to these wonderful people (emoji key):

Pierre Bertet
Pierre Bertet

πŸ’»
Brett Sun
Brett Sun

πŸ’»
Gorka Ludlow
Gorka Ludlow

πŸ’»
Jorge Izquierdo
Jorge Izquierdo

πŸ’»
Luis IvΓ‘n Cuende
Luis IvΓ‘n Cuende

πŸ’» 🎨 πŸ€”
Oliver
Oliver

πŸ’»
ßingen
ßingen

πŸ’»
Daniel Norman
Daniel Norman

πŸ’»
John Light
John Light

πŸ“– πŸ›
Tatu
Tatu

πŸ“–
Patricia Davila
Patricia Davila

🎨 πŸ““
Jouni Helminen
Jouni Helminen

🎨 πŸ““
Luke Duncan
Luke Duncan

πŸ€”
Daniel Constantin
Daniel Constantin

πŸ’»
RJ Ewing
RJ Ewing

πŸ’»
Paul Henschel
Paul Henschel

πŸ’»
Rodrigo Perez
Rodrigo Perez

πŸ’»
gasolin
gasolin

πŸ’»
Adam Soltys
Adam Soltys

πŸ’»
Arun Kumar
Arun Kumar

πŸ’»
Beer van der Drift
Beer van der Drift

πŸ’»
Daniel Caballero
Daniel Caballero

πŸ’»
Deam
Deam

πŸ’»
Ilia Smirnov
Ilia Smirnov

πŸ“– πŸ”§
julsar
julsar

πŸ“–
Pascal Precht
Pascal Precht

πŸ”§
Rudy Godoy
Rudy Godoy

πŸ“–
Yalda Mousavinia
Yalda Mousavinia

πŸ’»
decodedbrain
decodedbrain

πŸ’»
jvluso
jvluso

πŸ’»
mark g romano
mark g romano

πŸ’»
mul53
mul53

πŸ’»
Jon
Jon

πŸ’»
Abhinav Sagar
Abhinav Sagar

🚧
geleeroyale
geleeroyale

πŸ“–

This project follows the all-contributors specification. Contributions of any kind welcome!