Ops · Deployment

Deployment

What's deployed where.

Deployment

Multi-Environment Stack — Vercel, Xano, AlloyDB, Zep

What's deployed where

Component	Where	Deploy method
Next.js sandbox (UI + thin BFF)	Vercel	`vercel --prod`
Anything Engine orchestration	Xano API group (TBD Apr 29)	Xano dashboard / MCP
AlloyDB	GCP (Mark's project)	GCP console
Zep memory	Zep Cloud (managed)	dashboard at app.getzep.com

This Next.js repo is just the front end + a thin BFF. It calls Xano. Xano calls everything else.

Vercel (preview / production)

# One-time
vercel link --project orbiter-sandbox

# Each deploy
vercel --prod        # production
vercel               # preview

Auto-deploy: connect the GitHub repo in the Vercel dashboard to get push-to-main previews.

Required env vars on Vercel

Set these in Project Settings → Environment Variables (mirror .env.example):

Var	Source	Notes
`WORKOS_CLIENT_ID`	copy from `orbiter-frontend/.env`	Same WorkOS app
`WORKOS_API_KEY`	copy from `orbiter-frontend/.env`
`WORKOS_REDIRECT_URI`	`https://<vercel-url>/auth/callback`	Add to WorkOS allowed list
`WORKOS_COOKIE_PASSWORD`	copy from `orbiter-frontend/.env`
`XANO_ANYTHING_ENGINE_BASE`	Xano API group base URL (TBD Apr 29)	Leave unset to keep BFF stub

LLM, Zep, AlloyDB keys do NOT belong here. Those live in Xano's workspace env. The Next.js BFF never touches them.

Local dev

pnpm install
cp .env.example .env.local
# Fill in keys
pnpm dev    # → http://localhost:3001

Port 3001 is intentional — orbiter-frontend uses 3000.

Test the BFF locally

Stub mode (default — XANO_ANYTHING_ENGINE_BASE unset):

curl -N -X POST http://localhost:3001/api/find-investors \
  -H "Content-Type: application/json" \
  -d '{"query":"Find me investors for a Series A medtech round"}'

Expected: two stub SSE events (text then tpl), then connection closes.

Live mode (set XANO_ANYTHING_ENGINE_BASE in .env.local):

curl -N -X POST http://localhost:3001/api/find-investors \
  -H "Content-Type: application/json" \
  -H "x-xano-token: $XANO_TOKEN" \
  -d '{"query":"Find me investors for a Series A medtech round"}'

The BFF forwards the request to ${XANO_ANYTHING_ENGINE_BASE}/anything-engine/dispatch and pipes SSE through.

Test harness UI

http://localhost:3001/find-investors — minimal page that drives the SSE endpoint and prints events. Replace with full Crayon UI once the Xano backend exists.