unionlabs / union
Get started
Taken from the repository's own files on 23 Oct 2026. RepoPilot has not run these commands.
Prerequisites
pnpm@10.25.0from package.json
Commands
No scripts found at the top level of the repository. Check package.json .
Install and use
README.mdInstall [Nix] to reproducibly build any component, and to enter a dev shell with all dependencies:
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
(Note that some components can only be built on Linux. If you are using macOS, we recommend using [OrbStack] to easily set up a [NixOS] VM within two minutes. Most Union developers use macOS with [OrbStack], and there is no need to install Nix inside of the [NixOS] VM.)
You can now reproducibly build any of Union's components from source:
nix build .#uniond -L
nix build .#voyager -L
nix build .#app -L
# to see all packages, run:
nix flake show
The result of whatever you build will be in result/
You can now also enter our dev shell, which has all of the dependencies (cargo, rustc, node, go, etc.) you need to work on any component:
(Don't worry, this will not affect your system outside of this repo)
nix develop
Run the following to format the entire repo and check your spelling before each PR:
nix run .#pre-commit -L
Check the #developers channel on Union's discord if you need any help with this.