mhuesch / widgets_rs

🛑 ABANDONED 🛑 // pure-Rust Holochain frontends & hApps

Table of Contents

• overview
• 🛑 note about abandonment 🛑
• 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 about abandonment 🛑

this repo is abandoned. Neighbourhoods is moving ahead with a different path, more in line with standard Holochain practice (Rust only in Holochain, Javascript for frontends).

I’m leaving this here for historical interest.

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