> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Development Setup

> Run 0 Finance locally for development

<Info>
  This guide is for developers contributing to 0 Finance. If you just want to
  use the CLI, see [Installation](/cli/installation).
</Info>

## Prerequisites

* Node.js v22.11+
* pnpm
* Docker (for local database)

***

## Clone and bootstrap

```bash theme={null}
git clone https://github.com/different-ai/zero-finance.git
cd zero-finance
./scripts/bootstrap.sh
```

The bootstrap script:

1. Installs Node.js and pnpm if missing
2. Runs `pnpm install`
3. Sets up required tooling

***

## Environment setup

Copy the example environment file:

```bash theme={null}
cp packages/web/.env.example packages/web/.env.local
```

Ask the team for the required secrets:

* `DATABASE_URL` — Postgres connection string
* `PRIVY_APP_ID` and `PRIVY_APP_SECRET` — Auth provider
* `BRIDGE_API_KEY` — Payment rails
* Other service credentials

***

## Start the dev server

```bash theme={null}
pnpm dev
```

The web app runs on [http://localhost:3050](http://localhost:3050).

***

## Verify the setup

```bash theme={null}
curl http://localhost:3050/api/health
```

Expected response:

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

***

## Alternative: Lite stack

For a minimal Docker-based setup:

```bash theme={null}
pnpm dev:lite
```

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

***

## Quality checks

```bash theme={null}
# Type checking
pnpm typecheck

# Linting
pnpm lint

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

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

***

## Next steps

<CardGroup cols={2}>
  <Card title="CLI Reference" icon="terminal" href="/cli/reference">
    Test the CLI against your local server.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Understand the HTTP API.
  </Card>
</CardGroup>