Environments

Environment matrix

Branch strategy

• main — what's in production. Protected.
• Feature branches → PR → preview deploy → code review → merge to main → prod deploy.
• No long-lived develop branch.

Vercel project setup

One Vercel project: agentic-trading-web.

• Production branch: main
• Preview branches: everything else
• Build command: pnpm build --filter=web (Turborepo)
• Output directory: handled by Next.js
• Install command: pnpm install --frozen-lockfile
• Node version: 24 LTS (Vercel default)
• Functions: Fluid Compute (default)
• Region: iad (primary), Hyperliquid API is well-served from there

Vercel cron jobs (defined in vercel.ts)

crons: [
  { path: '/api/ingest/bars',          schedule: '*/5 * * * *' },   // pull recent bars every 5 min
  { path: '/api/ingest/news',          schedule: '*/15 * * * *' },  // news every 15 min
  { path: '/api/ingest/funding',       schedule: '0 * * * *' },     // funding hourly
  { path: '/api/jobs/prune-agent-logs', schedule: '0 4 * * *' },    // daily prune
]

Fly app setup

One Fly app: agentic-live-runner.

• Image built from apps/live-runner/Dockerfile, deployed via CI on merge to main
• Machines created on-demand by the web app's deploy-live flow (see architecture/live-runtime.md)
• Machine size default: shared-1x-512
• Primary region: nrt (Tokyo) for mainnet runners — closer to Hyperliquid's API/WS edges per ADR-0016
• Auto-destroy stopped machines after 5 min idle (sweep job)

Fly secrets to set (app-wide, injected into every machine)

fly secrets set \
  SUPABASE_URL=... \
  SUPABASE_SERVICE_ROLE_KEY=... \
  OPENROUTER_API_KEY=... \
  HYPERLIQUID_LIVE_ENABLED=true \
  -a agentic-live-runner

HYPERLIQUID_LIVE_ENABLED is the L7 kill switch — set to anything other than 'true' to refuse all mainnet broker construction platform-wide (paper deployments unaffected). The web app reads the same flag when accepting createDeployment requests.

Vercel env vars (web app)

Supabase project setup

Two projects:

• agentic-trading-dev — used by local and preview environments. Shared, expectations are that data may be wiped.
• agentic-trading-prod — production only. Users' real Skills and deployments live here.

Marketplace integration with Vercel

Provision via Vercel Marketplace so env vars auto-populate:

1. Vercel dashboard → Storage → Add Marketplace Integration → Supabase
2. Link to production project for the prod Vercel environment
3. Link to dev project for preview + development Vercel environments

Migrations

• All migrations in packages/db/migrations/
• CI applies on merge:
  • Preview branches: apply to agentic-trading-dev
  • main merges: apply to agentic-trading-prod
• Backups: Supabase auto-backups; production also has a nightly logical dump to a separate bucket (Phase 3)

AI Gateway setup

In Vercel dashboard → AI Gateway → API Keys:

• Dev key: monthly budget cap = $50, alert at 80%
• Prod key: monthly budget cap = $500 to start, scale up as needed, alert at 80%

User BYOK keys are stored in the DB and forwarded per request — they don't count against platform budget.

CI/CD (GitHub Actions)

.github/workflows/ci.yml:

• On PR: lint, typecheck, unit tests, package builds
• On PR: apply migrations to agentic-trading-dev if any in packages/db/migrations/
• On PR: Vercel auto-deploys preview (no GH action needed)
• On merge to main:
  • Apply migrations to agentic-trading-prod
  • Vercel auto-deploys prod
  • Build live-runner Docker image, push to Fly registry, deploy via fly deploy

.github/workflows/scheduled.yml:

• Daily: prune Fly machines for stopped deployments
• Weekly: dependency update PR (Renovate / Dependabot)

Local development

See docs/development/setup.md for the full first-time setup. Short version:

pnpm install
cp .env.example .env.local       # fill in dev Supabase + AI Gateway keys
pnpm dev                          # runs web app on :3000

Local development uses the shared dev Supabase project. There is no per-developer database in MVP — keep it simple.

To run a sim locally:

pnpm sim --skill <skill-id> --from 2026-04-01 --to 2026-05-01

To run the live runner locally (paper broker by default; mainnet only when intentionally testing real-money flow — ADR-0015):

DEPLOYMENT_ID=<existing-deployment-uuid> pnpm --filter live-runner dev

Domain / DNS

• Production: app.agentic-trading.example (final domain TBD) → Vercel
• Preview: *.agentic-trading-web.vercel.app (Vercel default)
• Local: localhost:3000

Cost monitoring

Total MVP infra cost target: < $100/mo at single-developer scale.