Skip to content
A barebones chat hApp for learning and testing
JavaScript Rust CSS Nix HTML
Branch: develop
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
dna-src updates for holochain v0.0.46-alpha1 Mar 27, 2020
ui-src update npm deps Mar 27, 2020
.gitignore Update to 0.0.30 Sep 16, 2019
LICENSE updates for holochain v0.0.45-alpha1 Mar 14, 2020
config.nix updates for holochain v0.0.46-alpha1 Mar 27, 2020
default.nix Renamed and set up Groups Sep 19, 2019
package-lock.json Renamed and set up Groups Sep 19, 2019
package.json updates for holochain v0.0.46-alpha1 Mar 27, 2020

Holochain Basic Chat

A simple chat app designed to get new users up, running and developing on Holochain

Alt text

Get started using nix-shell

Nix shell is a way to set up a dev environment that is easy to replicate on different machines. See for more info.

  • Install nix tooling on mac/linux
  curl | sh
  • Start a new nix-shell. This uses the local default.nix file to set up the correct versions of the holochain binaries and build tools.
  • You should end up with a [nix-shell: prompt in your shell.

Building from Source

Holochain DNA

There are some helpers scripts in the root package.json for building, running and testing the holochain code.

npm run hc:build

or use the CLI directly

mkdir -p dna
cd dna-src
hc package -o ../dna/basic-chat.dna.json

Be careful! If you are trying to network with other agents it is best to distribute a single compiled dna file. Any differences in compiler configuration may lead to the DNA hash being different and the nodes will not be able to communicate.


cd ui-src
npm install
npm start

Using with Holoscape

If you want to use Holoscape (and you definitely should!) you can build a Holoscape ready package by running

npm run hc:make-holoscape

You can then use the holoscape-bundle in the project root to install. Note: You most likely will need to change the DNA hash in the holoscape-bundle.toml file

Built With

A huge acknowledgement to Pusher for providing an open source React chat UI (



This project is licensed under the GPL-3 License - see the file for details

You can’t perform that action at this time.