🇺🇸English
workflow-init
Initial setup of Vercel Workflow DevKit before workflow is installed. Fetch the official getting-started guide for the user's framework.
Decision Flow
0) Sanity check
Read package.json. If workflow is already a dependency, tell the user to use /workflow instead (it reads versioned docs from node_modules/workflow/docs/). Only continue if workflow is missing.
1) Determine the framework
Non-interactive: If the user named a framework in their prompt, use it directly.
Auto-detect: Inspect package.json deps and config files. Use the first match:
- Next.js -
next dep or next.config.*
- Nuxt -
nuxt dep or nuxt.config.*
- SvelteKit -
@sveltejs/kit dep or svelte.config.*
- Astro -
astro dep or astro.config.*
- NestJS -
@nestjs/core dep or nest-cli.json
- Nitro -
nitro dep or nitro.config.*
- Express -
express dep
- Fastify -
fastify dep
- Hono -
hono dep
- Vite -
vite dep (and not matched above)
If no match or multiple matches, ask the user to pick.
2) Fetch and follow the getting-started guide
Fetch exactly one of these URLs and follow the guide step-by-step:
Each guide covers: install deps, configure framework, create first workflow, create route handler, run + verify.
3) Verify setup
- Start the dev server per the guide.
- Trigger the example endpoint with the provided
curl.
- Confirm logs show the workflow and steps executing.
- Optional:
npx workflow web or npx workflow inspect runs.
4) No framework yet?
If no framework exists, ask what the user wants:
- Web app : Next.js / Nuxt / SvelteKit / Astro
- API server : Express / Fastify / Hono
- Minimal server : Nitro or Vite
Then follow the "Create Your Project" section of the chosen guide.
Concept questions (pre-install)
If the user asks conceptual questions before installing, fetch:
Handoff
When setup is complete, tell the user: Use/workflow for ongoing development - it reads the versioned docs bundled in node_modules/workflow/docs/.
Weekly Installs
246
Repository
vercel/workflow
GitHub Stars
1.8K
First Seen
Feb 20, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
codex239
gemini-cli236
amp236
opencode236
github-copilot234
kimi-cli234
