Development Setup

This guide is for developers contributing to 0 Finance. If you just want to use the CLI, see Installation.

Prerequisites

git clone https://github.com/different-ai/zero-finance.git
cd zero-finance
./scripts/bootstrap.sh

The bootstrap script:

Copy the example environment file:

cp packages/web/.env.example packages/web/.env.local

Ask the team for the required secrets:

pnpm dev

The web app runs on http://localhost:3050.

curl http://localhost:3050/api/health

Expected response:

{
  "status": "ok",
  "timestamp": "2026-01-12T00:00:00.000Z",
  "message": "Server is running"
}

For a minimal Docker-based setup:

pnpm dev:lite

This uses docker-compose.lite.yml with local Postgres and mock services.

# Type checking
pnpm typecheck

# Linting
pnpm lint

# Tests
pnpm --filter @zero-finance/web test

# Build
pnpm --filter @zero-finance/web build