Quick Start

Get the Nester monorepo running locally in under 5 minutes.

Prerequisites

  • Node.js ≥ 20 (22 for dapp frontend)
  • pnpm ≥ 8 (for website)
  • npm ≥ 9 (for dapp frontend/backend)
  • Rust + soroban-cli (for smart contracts)
  • Go ≥ 1.22 (for backend, once migrated)
  • Python ≥ 3.11 (for intelligence service, once migrated)

Clone & Install

bash
git clone https://github.com/Suncrest-Labs/nester.git
cd nester

# Website (pnpm)
pnpm install

# DApp frontend (npm)
cd apps/dapp/frontend && npm install && cd ../../..

# DApp backend (npm — temporary until Go migration)
cd apps/dapp/backend && npm install && cd ../../..

# Intelligence (npm — temporary until Python migration)
cd apps/intelligence && npm install && cd ../..

Run Development Servers

bash
# Website — runs on localhost:3000
pnpm --filter @nester/website dev

# DApp frontend — runs on localhost:3001
cd apps/dapp/frontend && npm run dev

# DApp backend — runs on localhost:8080
cd apps/dapp/backend && npm run dev

# Intelligence — runs on localhost:8081
cd apps/intelligence && npm run dev

Build & Verify

bash
# Must pass before pushing — CI runs these exact commands
pnpm --filter @nester/website build && pnpm --filter @nester/website lint
cd apps/dapp/frontend && npm run build && cd ../../..
cd apps/dapp/backend && npm run build && npm run lint && cd ../../..
cd apps/intelligence && npm run build && npm run lint && cd ../..

Smart Contracts (Soroban)

bash
cd packages/contracts

# Build all contracts
soroban contract build

# Run tests
cargo test

# Deploy to testnet
soroban contract deploy \
  --wasm target/wasm32-unknown-unknown/release/vault.wasm \
  --source <ACCOUNT> \
  --network testnet

Environment Variables

bash
# apps/dapp/backend/.env
DATABASE_URL=postgresql://user:pass@host:5432/nester
STELLAR_RPC_URL=https://soroban-testnet.stellar.org
STELLAR_NETWORK_PASSPHRASE="Test SDF Network ; September 2015"
PAYSTACK_SECRET_KEY=sk_test_xxx

# apps/intelligence/.env
ANTHROPIC_API_KEY=sk-ant-xxx
DATABASE_URL=postgresql://user:pass@host:5432/nester