PREREQUISITE: set up the holochain development environment.
Enter the nix shell by running this in the root folder of the repository, then install Nodejs dependencies:
nix develop
pnpm installThere is currently no published release for the Holochain Facets module. You will need to download and build it yourself:
git clone [email protected]:Carbon-Farm-Network/holochain-facets.git
cd holochain-facets
CARGO_TARGET_DIR=target cargo build --release --target wasm32-unknown-unknown
You should now have a built DNA bundle at holochain-facets/dnas/hc_facets/workdir/hc_facets.dna. Copy it into the /workdir of this repository.
Note that you can also use this method to build custom versions of other Holochain DNA modules (eg. hREA components). Otherwise all necessary DNA dependencies are downloaded by the workspace postinstall script.
Run all the other instructions in this README from inside this nix-shell, otherwise they won't work.
npm startThis will create a network of 2 nodes connected to each other and their respective UIs. It will also bring up the Holochain Playground for advanced introspection of the conductors.
npm testCreate a custom network of nodes connected to each other and their respective UIs with:
AGENTS=3 npm run networkSubstitute the "3" for the number of nodes that you want to bootstrap in your network. This will also bring up the Holochain Playground for advanced introspection of the conductors.
To package the web happ:
npm run packageYou'll have the acfn.webhapp in workdir. This is what you should distribute so that the Holochain Launcher can install it.
You will also have its subcomponent acfn.happ in the same folder`.
There are times when it becomes useful to link development versions of dependencies into this repo (eg. when developing new features for hREA).
You can use pnpm link PATH/TO/LOCAL/MODULE/DIR to override some module from the registry with a modified local copy. The target directory must reference the packaged version of a module as it would be delivered from an NPM registry, rather than any development artifacts. (For hREA's modules this means referencing the build subdirectory of each of its /modules folders after a successful npm run build:graphql script execution.)
The caveat is that development versions of the app served through Vite will crash when attempting to load such linked modules. Prepend a colon-separated list of any additional module dirs to all commands executed via the ADDITIONAL_MODULE_DIRS environment variable. For example:
ADDITIONAL_MODULE_DIRS=/PATH/TO/MODULE/1:/PATH/TO/MODULE/2 npm run dev
This repository is organised via the utilisation of these tools:
- Nix Flakes: Management of infrastructural dependencies.
- PNPM Workspaces: PNPM's package manager handles monorepos and complex cross-repo development setups gracefully.
- hc: Holochain CLI to easily manage Holochain development instances.
- @holochain/tryorama: test framework; see
/tests. - @holochain-playground/cli: introspection tooling to understand what's going on in the Holochain nodes.
- fix the modals for the clickoutside action, only the facets modal has it working properly
Copyright 2023-2024 Leo Bensman, Raphael Megzari, pospi, Lynn Foster
This file is part of Carbon Farm Network.
Carbon Farm Network is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Carbon Farm Network 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. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with Carbon Farm Network. If not, see https://www.gnu.org/licenses/.