Skip to main content

Prerequisites

System requirements across the monorepo:

  • git
  • bun (latest stable)
  • node (recommended for tool compatibility)
  • cargo + Rust toolchain
  • docker + docker compose
  • Foundry: forge, cast, anvil

Install Foundry if missing:

curl -L https://foundry.paradigm.xyz | bash
foundryup

Clone​

git clone --recursive https://github.com/vibefi/monorepo.git
cd monorepo
bun install

Repo map​

  • contracts/: Solidity governance and registry contracts.
  • cli/: Bun/TypeScript governance and packaging CLI.
  • gov-agent/: Rust governance watcher/reviewer and optional auto-voter.
  • client/: Wry/Rust desktop runtime for approved dapps.
  • e2e/: end-to-end validation flow.
  • dapp-examples/: frontend examples (constrained React/Vite + nested static-html zfi submodule).
  • studio/: governance studio app (see studio/README.md, studio/design.md, studio/plan.md).
  • ipfs-relay/: Rust/Axum upload relay that validates bundles, pins to Kubo, and queues provider replication.
  • lander/: landing page site.
  • docs/: Docusaurus documentation site.
  • packages/shared/: shared TypeScript utilities.