iterate

Prerequisites

• Depot CLI for fast Docker builds with shared caching:

  brew install depot/tap/depot
  depot login

Quick Start

pnpm install
pnpm docker:up
pnpm os db:migrate
docker buildx create --name iterate --driver docker-container --use
pnpm sandbox build
pnpm os dev

Repository Structure

• apps/os/ - Primary application (React + Cloudflare Workers)
• apps/daemon/ - Local daemon for durable streams and agent orchestration
• apps/iterate-com - iterate.com website
• docs/ - Detailed documentation and patterns

Development Commands

pnpm dev          # Run all apps in parallel
pnpm os dev       # Run apps/os only
pnpm daemon dev   # Run apps/daemon only
pnpm test         # Run all tests
pnpm typecheck    # Type check all packages
pnpm lint         # Lint and fix
pnpm format       # Format code

Cloudflare Tunnels

Expose local dev servers via public URLs (useful for webhooks, OAuth callbacks):

DEV_TUNNEL=1 pnpm dev        # → {app}-dev-{ITERATE_USER}.dev.iterate.com
DEV_TUNNEL=bob pnpm dev      # → bob.dev.iterate.com (custom, no stage/app suffix)
DEV_TUNNEL=0 pnpm dev        # disabled (also: false, or unset)

Sandbox Providers

See sandbox/README.md for provider strategy, image tagging, and CI flow. Fly is the primary deployment provider; Daytona is supported for one-off manual testing only.