neighbour-hoods / widgets_rs

Table of Contents

• overview
• 🛑 note 🛑
• initial repo setup
  • init submodules
• Nix setup
• building
• running

overview

this is an experimental repo which uses Rust to build UIs for Holochain, and features a wasm-bindgen FFI binding library to the holochain-client-js library.

🛑 note 🛑

this repo is abandoned, as of 2022-10-26, due to the team’s decision to build initial versions of neighbourhoods applets and sensemaker-lite with Javascript frontends.

initial repo setup

init submodules

git submodule update --init

Nix setup

install a Flakes supporting nix

edit /etc/nix/nix.conf to include the following:

experimental-features = nix-command flakes

optionally (but strongly suggested because it will dramatically speed up first-build times), also add these lines to nix.conf in order to enable the Holochain binary caches. public keys can be checked at the substituter URLs.

substituters = https://cache.nixos.org/ https://cache.holo.host/ https://holochain-ci.cachix.org
trusted-public-keys = cache.nixos.org-1:6NCHdD59X431o0gWypbMrAURkbJ16ZPMQFGspcDShjY= cache.holo.host-1:lNXIXtJgS9Iuw4Cu6X0HINLu9sTfcjEntnrgwMQIMcE= cache.holo.host-2:ZJCkX3AUYZ8soxTLfTb60g+F3MkWD7hkH9y8CgqwhDQ= holochain-ci.cachix.org-1:5IUSkZc0aoRS53rfkvH9Kid40NpyjwCMCzwRTXy+QN8=

building

prequisite: follow 'Nix setup' above.

# enter dev shell (we need impure because Holonix is not pure 😢)
$ nix develop --impure
[<...>]$ npm install
[<...>]$ npm run hc:build
[<...>]$ npm run hc:pack
[<...>]$ npm run hc:mk-sensemaker # this may take a while to run

running

# in dev shell
[<...>]$ npm run hc:run