Development
Requirements
- Node.js 20.9 or newer (developed on Node 24)
- npm 10 or newer
Run the website
npm install
cp website/.env.example website/.env.local
npm run dev
The site runs at http://localhost:3000.
Scripts
| Command | What it does |
|---|---|
npm run dev |
Website in development mode |
npm run build |
Production build of the website |
npm run start |
Serve the production build |
npm run typecheck |
Type-check every workspace |
npm test |
Run the shared package's tests |
npm run bridge:dev |
Run the reference bridge (see below) |
Configuration
| Variable | Required | Purpose |
|---|---|---|
NEXT_PUBLIC_SITE_URL |
Production | Canonical URL for metadata |
NEXT_PUBLIC_ROBINHOOD_RPC_URL |
Recommended | Dedicated Robinhood Chain RPC. Falls back to the public, rate-limited endpoint |
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID |
Optional | Enables mobile wallets via WalletConnect |
NEXT_PUBLIC_ALLOCATION_REGISTRY_ADDRESS |
Optional | Enables saving splits onchain |
LIFI_API_KEY |
Optional | Higher LI.FI rate limits (server only) |
LIFI_INTEGRATOR |
Optional | Integrator string sent with quotes |
Reference bridge
desktop/reference-bridge is a small Node server that implements the desktop bridge protocol with real readings from the operating system (CPU load, memory, disk space, and GPU utilisation where nvidia-smi is available). It runs no workloads and reports no earnings. It exists so the dashboard's connected state can be developed and tested against real data before the desktop app exists.
npm run bridge:dev
It prints a pairing code in the terminal. Open the dashboard, click Connect device, and enter the code.
Contracts
contracts/ is a Foundry project. With Foundry installed:
cd contracts
forge test