Local Development

Prerequisites

Tool	Version	Install
Node.js	≥ 20	nodejs.org
pnpm	≥ 9	npm i -g pnpm
Rust	stable	rustup.rs
Stellar CLI	latest	cargo install stellar-cli

The Rust toolchain and Stellar CLI are only required if you are working on the Soroban contracts in packages/contracts/. Frontend and API work does not require them.

Setup

git clone https://github.com/drydocs/meridian.git
cd meridian
pnpm install

Running the full stack

pnpm dev

Turborepo starts all dev tasks in parallel:

• Web at http://localhost:3000/app/ (Vite dev server with HMR)
• API at http://localhost:3001 (Fastify with tsx watch)
• Docs at http://localhost:3000/docs/ (VitePress, proxied from port 3002)

The Vite dev server proxies /api/* to http://localhost:3001 and /docs/* to the VitePress dev server at port 3002.

Running services individually

# Web only
pnpm --filter @meridian/web dev

# API only
pnpm --filter @meridian/api dev

Health check

curl http://localhost:3001/health
# {"status":"ok"}

Running tests

pnpm test

To run tests for a single package:

pnpm --filter @meridian/shared test
pnpm --filter @meridian/stellar-sdk-helpers test

Type checking

pnpm typecheck

Linting

pnpm lint

Building packages

If you edit a packages/ library, rebuild it before the apps pick up the changes:

pnpm build

Or build a single package:

pnpm --filter @meridian/shared build

Working with the contracts

packages/contracts/ has four crates: vault (the coordinator), router (reserved for v2), and two yield adapters, blend-adapter and defindex-adapter. Build and test them all together from the contracts package root, or individually:

cd packages/contracts

# Build every crate's WASM (outputs to target/wasm32v1-none/release/)
stellar contract build

# Run every crate's Rust tests
cargo test

# Or a single crate
cargo test --manifest-path blend-adapter/Cargo.toml

stellar contract build targets wasm32v1-none, not wasm32-unknown-unknown — install it with rustup target add wasm32v1-none if you haven't already.

See Testnet Deployment for deploying the contracts to testnet, and Vault Contract for how the vault and adapters fit together.

Freighter wallet

Install the Freighter browser extension and switch it to Testnet mode. Fund your testnet account using Stellar Friendbot.

The local API server is hardcoded to testnet (STELLAR_NETWORKS.testnet). Mainnet configuration is available via environment variables but is not the default for local development.