Forma
A minimal v0-style app builder: describe an app, watch its Next.js preview, then refine it through chat. OpenAI's Agents API public beta runs the coding agent, Vercel Sandbox preserves each project's files, and Neon Postgres stores projects, chat, and background jobs.
The deploy flow includes Neon database setup and prompts for the application credentials. After deployment, complete the OpenAI webhook setup.
Requirements
- Node.js 24, pnpm 10, and the Vercel CLI.
- OpenAI Agents API public beta access, an application key, and a restricted executor key from the same organization, project, and user/service account. Agents SDK or Responses API access alone is insufficient.
- A Vercel project with Sandbox, Queues, and a plan supporting 800-second Functions and five-minute Cron jobs.
- A connected Neon Postgres database.
Get started
pnpm install
vercel link
vercel env pull .env.localFill in the settings from .env.example. Create a dedicated environment key in the Agents → Environments → Keys dashboard, with all other permissions set to None. The application key needs api.agents.read, api.agents.write, and api.responses.write. Use independent random values for APP_PASSWORD, AUTH_SECRET, and CRON_SECRET.
pnpm agent:create
pnpm db:migrate
pnpm devThe agent script saves OPENAI_AGENT_ID locally. Follow the deployment and webhook setup to obtain OPENAI_WEBHOOK_SECRET; generation requires all application settings. Never commit .env.local.
Open localhost:3000 and sign in with APP_PASSWORD. pnpm dev runs both Next.js and the local job worker. Submit a prompt, request a follow-up, then use Save & pause and reopen the saved project.
Checks
pnpm lint
pnpm exec next typegen
pnpm typecheck
pnpm test
pnpm buildLive checks use paid inference and sandbox compute: pnpm test:live exercises the worker directly; APP_URL=https://your-deployment.example pnpm test:deployed exercises the deployed API and Queues. See verification details.
Documentation
- Architecture: infrastructure, data model, workflows, deployment, and recovery.
This is a single-user demo: everyone with the password shares one workspace. Generated preview URLs are accessible to anyone who has the URL. Pausing stops compute; the two retained filesystem snapshots have no automatic expiry and can incur storage charges.