documents/dev/vercel.md

Vercel

Deployment URLs โ€” logs & source

Vercel has shortcut suffixes you can append to any deployment URL:

  • /_logs โ€” view deployment logs
  • /_src โ€” view deployment source
https://my-deployment-my-username.vercel.app/_logs
https://my-deployment-my-username.vercel.app/_src

Qwestly examples:


Build: Serverless Function size limit

Error: A Serverless Function has exceeded the unzipped maximum size of 250 MB.

Fix โ€” disable build cache:

VERCEL_FORCE_NO_BUILD_CACHE=1

The Next.js build cache (.next/cache/webpack) can balloon and push the function over the 250 MB unzipped limit.


'use workflow' directive

Vercel Workflows is a fully managed platform for durable functions / AI agents (JS, TS, Python). Mark a function as a workflow by placing 'use workflow' as the first statement:

export async function aiContentWorkflow(topic: string) {
  'use workflow';

  const draft = await generateDraft(topic);
  const summary = await summarizeDraft(draft);
  return { draft, summary };
}
  • The 'use step' directive works similarly inside workflows to mark individual steps.
  • Workflows are resumable (pause minutesโ€“months), durable (survive deploys/crashes), observable (built-in logs/metrics/tracing in the Vercel dashboard).
  • Install: pnpm i workflow / npm i workflow / yarn add workflow
  • Docs: https://vercel.com/docs/workflows

Automation Bypass Secret

Used to bypass Vercel's deployment protection for automated deployments / CI.

VERCEL_AUTOMATION_BYPASS_SECRET=