Skip to content

lightningrodlabs/where

Repository files navigation

where

Tooling for group self-awareness on holochain

Background

Groups, especially remote colaborative groups, often lack contextual information about collaborators that makes working together harder. Co-locating oneself across a number of spaces in the context of a group (or groups) provides an important avenue for improving both sense-making and working together. Where provides a generalized pattern for creating shared maps for groups to see the emergent "whereness" of each other across self-evolved sets of maps.

Initial prototype: screencast

Design

For more details read the design documents.

Dev testing

Setup

  1. Install the required tools
  2. Rust wasm target: npm run install:rust
  3. holochain: cargo install holochain (or use nix-shell)
  4. npm run install:hc
  5. npm run install:zits
  6. npm install
  7. npm run install:submodules
  8. npm run install:hash-zome
  9. npm run build:localize

Web

npm run devtest

Electron

npm run devtest:electron

Network

To bootstrap a network of N agents:

npm run network 3

Replace the "3" for the number of agents you want to bootstrap.

Package

To package the web-happ:

npm run package:webapp

All output files (*.webhapp, *.dna, *.happ, etc.) will be in the artifacts folder.

Project structure

Directory Description
/dna/ DNA source code
/electron/ Electron app directory
    bin/ All the binaries we are dependent on and must ship with the app
    src/ The electron app source code
    web/ Final artifacts for the electron app (includes output from webapp)
/webapp/ The Where webapp source code
    webhapp.workdir/ webhapp work directory
/webapp.ludotheque/ The Ludotheque standalone webapp source code
/webcomponents/ The web components source code
/we-applet/ The applet for We integration

License

License: CAL 1.0

Copyright (C) 2021, Harris-Braun Enterprises, LLC

This program is free software: you can redistribute it and/or modify it under the terms of the license provided in the LICENSE file (CAL-1.0). This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.