Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lightningrodlabs/where
Tooling for group self-awareness on holochain
https://github.com/lightningrodlabs/where
Last synced: 3 months ago
JSON representation
Tooling for group self-awareness on holochain
- Host: GitHub
- URL: https://github.com/lightningrodlabs/where
- Owner: lightningrodlabs
- License: other
- Created: 2021-08-17T13:36:33.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-30T17:32:49.000Z (3 months ago)
- Last Synced: 2024-10-30T18:33:44.140Z (3 months ago)
- Language: TypeScript
- Homepage:
- Size: 174 MB
- Stars: 25
- Watchers: 6
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-weave - lightningrodlabs/where - awareness on holochain | Dec 5, 2024 | [hdk-4.0-dev.20](https://github.com/lightningrodlabs/where/tree/hdk-4.0-dev.20) | [@ddd-mtl](https://github.com/ddd-mtl), [@zippy](https://github.com/zippy), [@guillemcordoba](https://github.com/guillemcordoba), [@harlantwood](https://github.com/harlantwood), [@bierlingm](https://github.com/bierlingm) | (Happs)
- awesome-weave - lightningrodlabs/where - awareness on holochain | Oct 30, 2024 | [hdk-4.0-dev.20](https://github.com/lightningrodlabs/where/tree/hdk-4.0-dev.20) | [@ddd-mtl](https://github.com/ddd-mtl), [@zippy](https://github.com/zippy), [@guillemcordoba](https://github.com/guillemcordoba), [@harlantwood](https://github.com/harlantwood), [@bierlingm](https://github.com/bierlingm) | (Happs)
README
# 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](spec/where.gif)## Design
For more details read the [design documents](spec/DESIGN.md).
## Dev testing
### Setup
1. Install the required tools
1. Rust wasm target: `npm run install:rust`
1. [`holochain`](https://github.com/holochain/holochain): `cargo install holochain` (or use nix-shell)
4. `npm run install:hc`
3. `npm run install:zits`
4. `npm install`
5. `npm run install:submodules`
5. `npm run install:hash-zome`
5. `npm run build:localize`### Web
`npm run devtest`### Electron
`npm run devtest:electron`## Network
To bootstrap a network of N agents:
``` bash
npm run network 3
```Replace the "3" for the number of agents you want to bootstrap.
## PackageTo package the web-happ:
``` bash
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](https://img.shields.io/badge/License-CAL%201.0-blue.svg)](https://github.com/holochain/cryptographic-autonomy-license)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.