artbrock / clutter

Holochain App: Completely distributed Twitter alternative

Clutter

Project Management w/ Acorn

We use Sprillow's Holochain app Acorn v1.0.2-alpha (download) for project management. If you wish to join us there, please download the app, install it, click "Join a project" and paste in this secret: blunt budding gatherer spilt simply.

Environment Setup

1. Install the holochain dev environment (only nix-shell is required): https://developer.holochain.org/docs/install/
2. Enable Holochain cachix with:

nix-env -iA cachix -f https://cachix.org/api/v1/install
cachix use holochain-ci

3. Clone this repo and cd inside of it.
4. Enter the nix shell by running this in the root folder of the repository:

nix-shell
npm install

This will install all the needed dependencies in your local environment, including holochain, hc and npm.

5. Install git submodule dependency (ui-common-library)

git submodule init
git submodule update --remote --recursive

Building the DNA

• Build the DNA (assumes you are still in the nix shell for correct rust/cargo versions from step above):

npm run build:happ

Running the DNA tests

npm run test

UI

To test out the UI:

npm start

To run another agent, open another terminal, and execute again:

npm start

Each new agent that you create this way will get assigned its own port and get connected to the other agents.

Package

To package the web happ:

npm run package

You'll have the clutter.webhapp in workdir. This is what you should distribute so that the Holochain Launcher can install it.

You will also have its subcomponent clutter.happ in the same folder`.

Documentation

We are using this tooling:

• NPM Workspaces: npm v7's built-in monorepo capabilities.
• hc: Holochain CLI to easily manage Holochain development instances.
• @holochain/tryorama: test framework.
• @holochain/conductor-api: client library to connect to Holochain from the UI.