About

A customizable interface to add widgets for your organization's details and insights

The About app allows users to create an organization dashboard with widgets that can be customized to include your organization's details or contain insights from other apps.

New widget

To add a new widget to the dashboard, click on "New widget" button which is displayed when there is no data, or in the "Actions" menu once the application has data.

When configuring a new widget, you can choose whether to place it in the Primary column (wider column on the left) or in the Secondary column (narrower column on the right). The currently supported widgets are a custom markdown component and a "Latest votes" widget that displays the most recent votes from the Voting app.

In the example below, there are three widgets: a markdown widget in both the Primary and Secondary columns, in addition to a "Latest votes" widget in the Secondary column.

We're progressively rolling out new widgets for the About app. If you have a request, please create a new issue in our GitHub repository.

Edit layout

Widgets can be repositioned in the dashboard's editing mode. To enter this mode, click on "Actions" and select "Edit layout". Repositioning widgets is as simple as drag and drop! Once you're done repositioning, just click on "Submit".

A temporary empty state is created when moving all the widgets from Secondary to the Primary column such as in the example below. This is intentionally placed to preserve the ability to reposition widgets back to the secondary column if desired while in edit mode.

➡️ Review the About App demo

Installation instructions

The following instructions are to install the About app using the aragonCLI to an existing DAO, which is the only way to install it. If you're unfamiliar with the aragonCLI, it is important to learn how to use it. If you don’t have an organization, create a new one at app.aragon.org or follow the custom deployment guide.

Note: The Ethereum hashes used in the examples below should be replaced with the addresses from your organization, you can't just copy and paste everything! If you need help, hop into our Keybase chatroom and we can walk you through the installation process.

The About app is available on Mainnet and Rinkeby and stored at about.hatch.aragonpm.eth. The commands below are assuming an installation for a Mainnet DAO. If you want to install the app to a Rinkeby DAO, include the this command at the end: --environment aragon:rinkeby

1. Set a variable in bash to for your organization's name (from <dao-name>.aragonid.eth) or Ethereum address, with one of the the following commands:

   $dao=<dao-name> or

   $dao=0x9a92dDDf3e69B981bD9D9Ac725E217039556C5a3

2. After you install the aragonCLI, run the following command to install the About app:

   dao install $dao about.hatch.aragonpm.eth

3. Depending upon how your organization is configured, you may need to visit your DAO and approve a vote to install the app, unless you have master controls to add apps.

4. After the app is installed, you won't see the About app in your organization until you initialize a permission (this is how all Aragon apps work). The About app has a single permission, UPDATE_CONTENT which controls access for updating the data and layout configurations of the app.

   You should lookup the proxy address of the About and Voting apps as we will need them to set up the permission. You can use this command to look up the proxy addresses:

   dao apps $dao --all

   Note: The About app will be considered a "permissionless" app

5. Set environment variables for the proxy addresses of the About app and Voting app:

   $about=0x909dbebd0869b4f903b2e17007adaaa61935bf13

   $voting=0xc63bb3ac780b8e9dc97a95235d1ff02c0213b7e6

6. Lastly, we can set up this permission so an approving vote is required to make updates to the About app's content, and an approving vote is required to change this permission:

   dao acl create $dao $about UPDATE_CONTENT $voting $voting

   Note: Feel free to replace your personal address in place of $voting if you prefer "master" privileges over the About app